ڈیبگنگ¶
یہ صفحہ اسٹریمنگ آؤٹ پٹ کے لیے ڈیبگنگ معاونات کا احاطہ کرتا ہے، خاص طور پر اس صورت میں جب کوئی فراہم کنندہ عام متن میں استدلال کو ملا دے۔
رن ٹائم ڈیبگ اووررائیڈز¶
چیٹ میں runtime-only کنفیگ اووررائیڈز (میموری، ڈسک نہیں) سیٹ کرنے کے لیے /debug استعمال کریں۔
/debug is disabled by default; enable with commands.debug: true.
This is handy when you need to toggle obscure settings without editing openclaw.json.
مثالیں:
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset
/debug reset تمام اووررائیڈز صاف کر دیتا ہے اور آن-ڈسک کنفیگ پر واپس آ جاتا ہے۔
Gateway واچ موڈ¶
تیز تکرار کے لیے، گیٹ وے کو فائل واچر کے تحت چلائیں:
pnpm gateway:watch --force
یہ اس کے مساوی ہے:
tsx watch src/entry.ts gateway --force
gateway:watch کے بعد کوئی بھی gateway CLI فلیگز شامل کریں، اور وہ ہر ری اسٹارٹ پر پاس تھرو ہو جائیں گے۔
ڈیو پروفائل + ڈیو گیٹ وے (--dev)¶
اسٹیٹ کو الگ رکھنے اور ایک محفوظ، عارضی سیٹ اپ شروع کرنے کے لیے dev پروفائل استعمال کریں۔
debugging. There are two --dev flags:
- عالمی
--dev(پروفائل): اسٹیٹ کو~/.openclaw-devکے تحت الگ کرتا ہے اور گیٹ وے پورٹ کو بطورِ طے شدہ19001پر سیٹ کرتا ہے (اس کے ساتھ اخذ شدہ پورٹس بھی تبدیل ہوتی ہیں)۔ gateway --dev: Gateway کو ہدایت دیتا ہے کہ کمی کی صورت میں ڈیفالٹ کنفیگ + ورک اسپیس خودکار طور پر بنائے (اور BOOTSTRAP.md کو اسکیپ کرے)۔
سفارش کردہ فلو (ڈیو پروفائل + ڈیو بوٹسٹرَیپ):
pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui
اگر ابھی تک آپ کے پاس گلوبل انسٹال موجود نہیں ہے تو CLI کو pnpm openclaw ... کے ذریعے چلائیں۔
یہ کیا کرتا ہے:
-
پروفائل آئسولیشن (عالمی
--dev) -OPENCLAW_PROFILE=dev-OPENCLAW_STATE_DIR=~/.openclaw-dev-OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json-OPENCLAW_GATEWAY_PORT=19001(براؤزر/کینوس اسی کے مطابق شفٹ ہوتے ہیں) -
ڈیو بوٹسٹرَیپ (
gateway --dev) - اگر موجود نہ ہو تو ایک کم سے کم کنفیگ لکھتا ہے (gateway.mode=local، bind loopback)۔ -agent.workspaceکو ڈیو ورک اسپیس پر سیٹ کرتا ہے۔ -agent.skipBootstrap=trueسیٹ کرتا ہے (BOOTSRTAP.md نہیں)۔ - اگر موجود نہ ہوں تو ورک اسپیس فائلز سیڈ کرتا ہے:AGENTS.md,SOUL.md,TOOLS.md,IDENTITY.md,USER.md,HEARTBEAT.md۔ - ڈیفالٹ شناخت: C3‑PO (پروٹوکول ڈرائیڈ)۔ - ڈیو موڈ میں چینل فراہم کنندگان کو اسکیپ کرتا ہے (OPENCLAW_SKIP_CHANNELS=1)۔
ری سیٹ فلو (نئی شروعات):
pnpm gateway:dev:reset
نوٹ: --dev ایک global پروفائل فلیگ ہے اور کچھ رنرز اسے نظر انداز کر دیتے ہیں۔
If you need to spell it out, use the env var form:
OPENCLAW_PROFILE=dev openclaw gateway --dev --reset
--reset کنفیگ، اسناد، سیشنز، اور ڈیو ورک اسپیس کو صاف کر دیتا ہے (استعمال کرتے ہوئے
trash، نہ کہ rm)، پھر ڈیفالٹ ڈیو سیٹ اپ دوبارہ بناتا ہے۔
مشورہ: اگر کوئی نان‑ڈیو گیٹ وے پہلے سے چل رہا ہو (launchd/systemd)، تو پہلے اسے بند کریں:
openclaw gateway stop
خام اسٹریم لاگنگ (OpenClaw)¶
OpenClaw کسی بھی فلٹرنگ/فارمیٹنگ سے پہلے raw assistant stream کو لاگ کر سکتا ہے۔ This is the best way to see whether reasoning is arriving as plain text deltas (or as separate thinking blocks).
CLI کے ذریعے فعال کریں:
pnpm gateway:watch --force --raw-stream
اختیاری پاتھ اووررائیڈ:
pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl
مساوی env vars:
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
نوٹ: یہ صرف ان پروسیسز کے ذریعے خارج ہوتا ہے جو pi-mono کے
openai-completionsفراہم کنندہ کو استعمال کرتے ہیں۔
سکیورٹی نوٹس¶
- خام اسٹریم لاگز میں مکمل پرامپٹس، ٹول آؤٹ پٹ، اور صارف ڈیٹا شامل ہو سکتا ہے۔
- لاگز کو مقامی رکھیں اور ڈیبگنگ کے بعد حذف کر دیں۔
- اگر آپ لاگز شیئر کریں تو پہلے راز اور PII صاف کریں۔