الانتقال إلى المحتوى الرئيسي

​
Debugging

تغطي هذه الصفحة أدوات مساعدة لتصحيح الأخطاء الخاصة بالمخرجات المتدفقة، خصوصًا عندما يمزج موفّر ما الاستدلال مع النص العادي.

​
تجاوز تصحيح أخطاء وقت التشغيل

استخدم /debug في الدردشة لتعيين تجاوزات تهيئة وقت التشغيل فقط (في الذاكرة، وليس على القرص). يكون /debug معطّلًا افتراضيًا؛ فعِّله باستخدام commands.debug: true. يُعدّ هذا مفيدًا عندما تحتاج إلى تبديل إعدادات نادرة دون تحرير openclaw.json. أمثلة: 
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset
يقوم /debug reset بمسح جميع التجاوزات والعودة إلى التهيئة الموجودة على القرص.

​
وضع مراقبة Gateway

للتكرار السريع، شغِّل Gateway تحت مراقبة الملفات: 
pnpm gateway:watch --force
هذه الخرائط إلى: 
tsx watch src/entry.ts gateway --force
أضِف أي أعلام CLI خاصة بـ Gateway بعد gateway:watch وسيتم تمريرها عند كل إعادة تشغيل.

​
ملف تعريف التطوير + Gateway التطوير (—dev)

استخدم ملف تعريف التطوير لعزل الحالة وتشغيل إعداد آمن ومؤقت لتصحيح الأخطاء. هناك علَمان من --dev:
  • --dev عام (ملف تعريف): يعزل الحالة تحت ~/.openclaw-dev ويضبط منفذ Gateway الافتراضي على 19001 (وتتحول المنافذ المشتقة معه).
  • gateway --dev: يطلب من Gateway إنشاء تهيئة افتراضية + مساحة عمل تلقائيًا عند غيابهما (وتخطي BOOTSTRAP.md).
التدفق الموصى به (ملف تعريف التطوير + إقلاع التطوير): 
pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui
إذا لم يكن لديك تثبيت عام بعد، شغِّل CLI عبر pnpm openclaw .... ما الذي يفعله ذلك:
  1. عزل ملف التعريف (--dev عام)
    • OPENCLAW_PROFILE=dev
    • OPENCLAW_STATE_DIR=~/.openclaw-dev
    • OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json
    • OPENCLAW_GATEWAY_PORT=19001 (يتحوّل المتصفح/اللوحة وفقًا لذلك)
  2. إقلاع التطوير (gateway --dev)
    • يكتب تهيئة دنيا عند غيابها (gateway.mode=local، ربط loopback).
    • يعيّن agent.workspace إلى مساحة عمل التطوير.
    • يعيّن agent.skipBootstrap=true (بدون BOOTSTRAP.md).
    • يزرع ملفات مساحة العمل عند غيابها: AGENTS.md، SOUL.md، TOOLS.md، IDENTITY.md، USER.md، HEARTBEAT.md.
    • الهوية الافتراضية: C3‑PO (روبوت بروتوكولات).
    • يتخطّى موفّري القنوات في وضع التطوير (OPENCLAW_SKIP_CHANNELS=1).
تدفق إعادة الضبط (بداية جديدة): 
pnpm gateway:dev:reset
ملاحظة: إن --dev علم عام لملف التعريف وتلتهمه بعض المشغِّلات. إذا احتجت إلى كتابته صراحةً، استخدم صيغة متغير البيئة: 
OPENCLAW_PROFILE=dev openclaw gateway --dev --reset
يقوم --reset بمسح التهيئة وبيانات الاعتماد والجلسات ومساحة عمل التطوير (باستخدام trash، وليس rm)، ثم يعيد إنشاء إعداد التطوير الافتراضي. نصيحة: إذا كان Gateway غير مخصص للتطوير يعمل بالفعل (launchd/systemd)، فأوقفه أولًا: 
openclaw gateway stop

​
تسجيل التدفق الخام (OpenClaw)

يمكن لـ OpenClaw تسجيل تدفّق المساعد الخام قبل أي ترشيح/تنسيق. هذه أفضل طريقة لمعرفة ما إذا كان الاستدلال يصل كدلتا نصية عادية (أم ككتل تفكير منفصلة). فعِّله عبر CLI: 
pnpm gateway:watch --force --raw-stream
تجاوز المسار اختياريًا: 
pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl
معادل إنف فار: 
OPENCLAW_RAW_STREAM=1
OPENCLAW_RAW_STREAM_PATH=~/.openclaw/logs/raw-stream.jsonl
الملف الافتراضي: ~/.openclaw/logs/raw-stream.jsonl

​
تسجيل المقاطع الخام (pi-mono)

لالتقاط مقاطع متوافقة مع OpenAI خام قبل تحليلها إلى كتل، يوفّر pi-mono مسجّلًا منفصلًا: 
PI_RAW_STREAM=1
مسار اختياري: 
PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl
الملف الافتراضي: ~/.pi-mono/logs/raw-openai-completions.jsonl
ملاحظة: لا يتم إصدار هذا إلا من العمليات التي تستخدم موفّر openai-completions الخاص بـ pi-mono.

​
ملاحظات السلامة

  • قد تتضمن سجلات التدفق الخام المطالبات الكاملة، ومخرجات الأدوات، وبيانات المستخدم.
  • احتفظ بالسجلات محليًا واحذفها بعد تصحيح الأخطاء.
  • إذا شاركت السجلات، فاحرص على تنقيتها من الأسرار ومعلومات التعريف الشخصية (PII) أولًا.