CLI commands
عامل راهاندازی OpenClaw
openclaw setup
OpenClaw همراه با یک عامل سیستمی داخلی عرضه میشود — که با نام «OpenClaw» سخن میگوید — و برای راهاندازی محلی، تعمیر و پیکربندی است (که قبلاً Crestodian نام داشت). این عامل تنها پس از آن شروع میشود که مدل پیشفرض مؤثر یک نوبت واقعی را تکمیل کند. در نصبهای تازه ابتدا استنتاج برقرار میشود؛ پیکربندی نادرست در مسیر کلاسیک doctor باقی میماند.
چه زمانی شروع میشود
اجرای openclaw بدون زیرفرمان، بر اساس وضعیت پیکربندی مسیردهی میشود:
- پیکربندی وجود ندارد، یا وجود دارد اما هیچ تنظیم تألیفشدهای ندارد (خالی است یا فقط کلیدهای
$schema/metaرا دارد): فرایند هدایتشده آغاز به کار را با راستیآزمایی زنده هوش مصنوعی شروع میکند. - پیکربندی وجود دارد اما اعتبارسنجی نمیشود: آغاز به کار کلاسیک را شروع میکند که مشکلات را گزارش میدهد و شما را به
openclaw doctorهدایت میکند. - پیکربندی وجود دارد و معتبر است: TUI عادی عامل را باز میکند. یک Gateway پیکربندیشده و دردسترس که عامل پیشفرض آن مدل دارد، مستقیماً به همان رابط کاربری میرود
و فرایند آغاز به کار یا OpenClaw را اجرا نمیکند. برای دسترسی بعدی به OpenClaw، درون TUI از
/openclawاستفاده کنید یاopenclaw setupرا مستقیماً اجرا کنید.
اجرای openclaw setup ابتدا مدل پیشفرض پیکربندیشده را بهصورت زنده آزمایش میکند. یک نوبت موفق OpenClaw را شروع میکند. شکست تعاملی، راهاندازی هدایتشده استنتاج را باز میکند و پس از موفقیت یک گزینه، کنترل را به OpenClaw میسپارد. درخواستهای تکمرحلهای، JSON و دیگر درخواستهای غیرتعاملی، در صورت دردسترسنبودن استنتاج با دستورالعمل اجرای openclaw onboard شکست میخورند. openclaw --help و openclaw --version مسیرهای سریع عادی خود را حفظ میکنند.
اجرای برهنه و غیرتعاملی openclaw (بدون TTY) بهجای چاپ راهنمای ریشه، با پیامی کوتاه خارج میشود: در نصب تازه یا نامعتبر به آغاز به کار غیرتعاملی و در صورت معتبر بودن پیکربندی به openclaw agent --local ... اشاره میکند.
openclaw onboard --modern همچنان یک نام مستعار سازگاری برای OpenClaw است، اما از همان دروازه استنتاج استفاده میکند: استنتاج سالم گفتوگو را باز میکند، شکستهای تعاملی راهاندازی هدایتشده استنتاج را آغاز میکنند و شکستهای غیرتعاملی با راهنمای آغاز به کار خارج میشوند. openclaw onboard --classic جادوگر کامل گامبهگام را باز میکند.
آنچه OpenClaw نشان میدهد
OpenClaw تعاملی همان پوسته TUI مربوط به openclaw tui را با یک بکاند گفتوگوی OpenClaw باز میکند. خوشامدگویی آغازین موارد زیر را پوشش میدهد:
- اعتبار پیکربندی و عامل پیشفرض
- مدل راستیآزماییشدهای که OpenClaw استفاده میکند
- دردسترسبودن Gateway بر اساس نخستین کاوش هنگام راهاندازی
- اقدام اشکالزدایی پیشنهادی بعدی
برای صرفاً شروعشدن، اسرار را تخلیه نمیکند یا فرمانهای CLI مربوط به Plugin را بارگذاری نمیکند.
برای فهرست تفصیلی از status استفاده کنید: مسیر پیکربندی، مسیرهای مستندات/منبع، کاوشهای CLI محلی، وجود کلید/توکن، عاملها، مدل و جزئیات Gateway.
OpenClaw از همان کشف مرجع عاملهای عادی استفاده میکند: در یک checkout گیت، به docs/ محلی و درخت منبع اشاره میکند؛ در نصب npm از مستندات همراه استفاده میکند و به https://github.com/openclaw/openclaw پیوند میدهد، همراه با راهنمای بررسی منبع در صورتی که مستندات کافی نباشند.
مثالها
openclawopenclaw setupopenclaw setup --jsonopenclaw setup --message "مدلها"openclaw setup --message "اعتبارسنجی پیکربندی"openclaw setup --message "راهاندازی فضای کاری ~/Projects/work" --yesopenclaw setup --message "تنظیم مدل پیشفرض openai/gpt-5.6" --yesopenclaw onboard --modernدرون TUI مربوط به OpenClaw:
وضعیتسلامتdoctorاعتبارسنجی پیکربندیراهاندازیراهاندازی فضای کاری ~/Projects/workconfig set gateway.port 19001config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKENوضعیت gatewayراهاندازی مجدد gatewayعاملهاایجاد عامل work با فضای کاری ~/Projects/workمدلهاپیکربندی ارائهدهنده مدلتنظیم مدل پیشفرض openai/gpt-5.6کانالهااطلاعات کانال slackاتصال slackباز کردن جادوگر کانال برای slackفهرست pluginهاجستوجوی pluginهای slackplugin install clawhub:openclaw-codex-app-serverگفتوگو با عامل workگفتوگو با عامل مربوط به ~/Projects/workممیزیخروجعملیات و تأیید
OpenClaw بهجای ویرایش موردی پیکربندی از عملیات نوعدار استفاده میکند.
عملیات فقطخواندنی بلافاصله اجرا میشوند: نمایش نمای کلی، فهرستکردن عاملها، فهرستکردن Pluginهای نصبشده، جستوجوی Pluginهای ClawHub، نمایش وضعیت مدل/بکاند، اجرای بررسیهای وضعیت/سلامت، بررسی دردسترسبودن Gateway، اجرای doctor بدون اصلاحات تعاملی، اعتبارسنجی پیکربندی و نمایش مسیر گزارش ممیزی.
شروع راهاندازی هدایتشده کانال (connect telegram) نیز بلافاصله اجرا میشود. جادوگر آن پاسخهای صریح را جمعآوری میکند و مسئول نوشتن تغییرات حاصل است.
عملیات ماندگار به تأیید مکالمهای نیاز دارند (یا برای یک فرمان مستقیم به --yes): نوشتن پیکربندی، config set، config set-ref، بوتاسترپ راهاندازی/آغاز به کار، تغییر مدل پیشفرض، شروع/توقف/راهاندازی مجدد Gateway، ایجاد عاملها و نصب Pluginها.
تعمیرات doctor درون OpenClaw دردسترس نیستند، زیرا ممکن است ارائهدهنده، احراز هویت یا مسیر استنتاج عامل پیشفرضی را که نشست بر آن متکی است بازنویسی کنند. از OpenClaw خارج شوید و openclaw doctor --fix را در یک پایانه اجرا کنید. doctor فقطخواندنی همچنان درون OpenClaw دردسترس است.
عاملهای جدید مسیر استنتاج پیشفرضِ راستیآزماییشده بهصورت زنده را به ارث میبرند. شناسههای عامل openclaw و crestodian برای عامل سیستمی رزرو شدهاند و نمیتوان آنها را بهعنوان عامل عادی ایجاد کرد. شناسه بازنشسته همچنان مسدود میماند تا یک پیکربندی قدیمی نتواند آن را تصاحب کند.
config set و config set-ref نمیتوانند وضعیت مسیر استنتاج را تغییر دهند،
از جمله اعتبارنامههای ارائهدهنده استنتاج، auth.* سطح بالا، کاتالوگهای مدل،
بکاندهای CLI، مسیرهای مدل پیشفرض/هر عامل، پارامترها/ابزارهای عامل یا
tools.* ریشه. نوشتن خام زیر env.*، secrets.*، plugins.* و $include
نیز رد میشود، زیرا میتواند تفکیک اعتبارنامه یا فعالسازی
ارائهدهنده را جایگزین کند. احراز هویت Gateway و کانال همچنان سطوح عادی پیکربندی هستند. از گردشکارهای نوعدار Plugin/کانال و
set default model <provider/model> برای مسیری که از قبل
پیکربندی شده است استفاده کنید؛ پیش از ذخیره، مسیر را بهصورت زنده آزمایش میکند. برای پیکربندی یا
تعمیر دسترسی ارائهدهنده/احراز هویت، از OpenClaw خارج شوید و openclaw onboard را اجرا کنید.
حذف نصب Plugin درون OpenClaw رد میشود، زیرا حذف یک Plugin
ارائهدهنده ممکن است مسیر استنتاجی را که نشست بر آن متکی است غیرفعال کند. از OpenClaw
خارج شوید و openclaw plugins uninstall <id> را از یک پایانه اجرا کنید.
تأیید با واژگان خودتان انجام میشود: پاسخهای بدون ابهام («بله»، «حتماً»، «انجام بده»، «الان نه») از یک فهرست بسته و قطعی تفسیر میشوند. وقتی مسیر پیکربندیشده از فراخوان تکمیل جداگانه پشتیبانی کند، پاسخهای دیگر را میتوان تنها بر اساس پیام شما و پیشنهاد معلق طبقهبندی کرد — هرگز توسط خود مدل مکالمه، که نمیتواند خودش را تأیید کند. پاسخهای طبقهبندینشده یا مبهم، پیشنهاد را معلق نگه میدارند و مکالمه دوباره میپرسد.
نوشتنهای اعمالشده در ~/.openclaw/audit/system-agent.jsonl ثبت میشوند. کشف ممیزی نمیشود؛ فقط عملیات و نوشتنهای اعمالشده ممیزی میشوند.
راهاندازی کانال میتواند بهصورت یک مکالمه میزبانیشده اجرا شود تا به یک راز برسد. TUI
محلی OpenClaw پاسخهای حساس جادوگر را نمیپذیرد، زیرا ورودی گفتوگوی
پایانه قابل مشاهده است. فوراً open channel wizard را ارائه میدهد و
کانال انتخابشده را به جادوگر پایانهای پوشیده منتقل میکند؛ همچنین میتوانید
بعداً openclaw channels add --channel <channel> را اجرا کنید.
جابهجایی به راهاندازی پوشیده کانال
گفتوگوی محلی میتواند کنترل را به جادوگر پوشیده کانال واگذار کند:
باز کردن جادوگر کانال برای slackاطلاعات کانال slackopen channel wizard for <channel> پس از بستهشدن TUI
گفتوگو، راهاندازی پوشیده کانال را باز میکند. ابتدا از channel info <channel> برای برچسب کانال، وضعیت
راهاندازی، خلاصه پیشنیازها و پیوند مستندات استفاده کنید.
OpenClaw هرگز دسترسی ارائهدهنده/احراز هویت را از درون نشست خودش تغییر نمیدهد:
نشست از قبل به آن مسیر استنتاج وابسته است. برای راهاندازی یا تعمیر ارائهدهنده مدل،
configure model provider بدون شروع
جادوگر یا نوشتن پیکربندی، راهنمای خروج/آغاز به کار را بازمیگرداند. از OpenClaw خارج شوید و openclaw onboard را اجرا کنید؛ آغاز به کار، اعتبارنامهها را مرحلهبندی میکند و تنها مسیری را ذخیره میکند که
یک نوبت واقعی زنده را تکمیل کند. پس از موفقیت آغاز به کار، OpenClaw را دوباره شروع کنید.
بوتاسترپ راهاندازی
setup پس از آنکه آغاز به کار هدایتشده استنتاج را برقرار کرد، فضای کاری و وضعیت باقیمانده Gateway را پیکربندی میکند. فقط از طریق عملیات نوعدار پیکربندی مینویسد و ابتدا تأیید میگیرد.
راهاندازیراهاندازی فضای کاری ~/Projects/worksetup مدل مؤثر راستیآزماییشده را حفظ میکند. استنتاج را پیکربندی یا
جایگزین نمیکند.
اگر استنتاج وجود ندارد یا بررسی زنده آن شکست میخورد، OpenClaw را ترک کنید و openclaw onboard را اجرا کنید. آغاز به کار هدایتشده مدلهای پیکربندیشده، کلیدهای API و CLIهای محلی احراز هویتشده را شناسایی میکند، از هر گزینه یک پاسخ واقعی میخواهد و فقط یک مسیر موفق را ماندگار میکند. OpenClaw بلافاصله پس از آن مرز شروع میشود و سپس میتواند فضای کاری، Gateway، کانالها، عاملها، Pluginها و دیگر قابلیتهای اختیاری را پیکربندی کند.
برنامه macOS وقتی به یک Gateway پیکربندیشده میرسد
که عامل پیشفرض آن از قبل مدل پیکربندیشدهای دارد، این نردبان را کاملاً رد میکند و رابط کاربری عادی
عامل را باز میکند.
برای یک Gateway تازه یا ناقص، برنامه نردبان استنتاج را از طریق
متدهای Gateway یعنی openclaw.setup.detect و openclaw.setup.activate هدایت میکند:
detect همه بکاندهای گزینهای را که پیدا میکند فهرست میکند، activate یک
گزینه را بهصورت زنده آزمایش میکند (یک تکمیل واقعی «با OK پاسخ بده») و فقط پس از موفقیت آزمایش،
مدل، اعتبارنامه و وضعیت ارائهدهنده/زماناجرای لازم برای آن مسیر را ماندگار میکند. پیشفرضهای فضای کاری و Gateway برای OpenClaw باقی میمانند. یک گزینه ناموفق
هرگز پیکربندی را تغییر نمیدهد؛ برنامه بهصورت خودکار نردبان را بهسمت پایین طی میکند و در نهایت
یک مرحله دستی کلید/توکن را پیشنهاد میدهد که از Pluginهای فعال
ارائهدهنده استنتاج متنی Gateway پر شده است. ارائهدهنده انتخابشده مالک مدل آغازین
و پیکربندی خود است و اعتبارنامه نیز پیش از ذخیرهشدن به همان روش راستیآزمایی میشود.
نظارت Codex و دیگر قابلیتهای اختیاری Plugin بیرون از این تراکنش فعالسازی استنتاج باقی میمانند. آنها را فقط پس از کارکردن استنتاج و شروعشدن OpenClaw پیکربندی کنید؛ سیاست فعلی Plugin و انصرافهای صریح از نظارت هنگام راهاندازی استنتاج دستنخورده باقی میمانند.
مکالمه هوش مصنوعی
مکالمه آزاد OpenClaw تعاملی از همان حلقه عاملهای عادی OpenClaw عبور میکند و به یک ابزار مرجع حلقه صفر OpenClaw، یعنی openclaw، محدود است که عملیات نوعدار را دربر میگیرد. کنشهای خواندن آزادانه اجرا میشوند، جهشها برای همان عملیات دقیق به تأیید مکالمهای شما نیاز دارند (بخش عملیات و تأیید را ببینید) و هر نوشتن اعمالشده ممیزی و دوباره اعتبارسنجی میشود. نشست عامل ماندگار است، بنابراین OpenClaw حافظه واقعی چندنوبتی دارد. اگر مسیر استنتاج راستیآزماییشده بعداً از کار افتاد، به openclaw onboard بازگردید و پیش از ادامه آن را تعمیر کنید.
میزبان درخواستهای زبان طبیعی را به عملیات تجزیه نمیکند. پیامهای آزاد
— از جمله متنی که شبیه فرمان است و پرسشهایی مانند «چرا
gateway من متوقف شد؟» — به هوش مصنوعی میروند که میتواند از طریق ابزار
openclaw درخواست را به یک عملیات نوعدار نگاشت کند.
وقتی یک جهش معلق است، فقط عبارتهای بدون ابهام تأیید یا رد از یک
فهرست بسته بدون استنتاج تفسیر میشوند. رضایت مبهم به یک
فراخوان تکمیل پیکربندیشده جداگانه میرود و در غیر این صورت بهصورت بسته شکست میخورد. فیلدهای
ساختیافته جادوگر و پیمایش دقیق میزبان، کنترلهای رابط کاربریاند، نه تجزیه
عملیات از زبان طبیعی. یک استثنای بهداشت اسرار اهمیت ویژهای دارد: یک
config set دقیق روی مسیری حساس (توکنها، کلیدها، گذرواژهها) هرگز به
مدل نمیرسد. میزبان یک پیشنهاد ویرایششده ایجاد میکند و مقدار در
تاریخچه قابلمشاهده برای هوش مصنوعی پوشانده میشود. برای اسرار، config set-ref <path> env <ENV_VAR> را ترجیح دهید.
حالت نجات کانال پیام هرگز از برنامهریز کمکگرفته از مدل استفاده نمیکند. نجات از راه دور قطعی باقی میماند تا یک مسیر عادی عامل که خراب یا به خطر افتاده است نتواند بهعنوان ویرایشگر پیکربندی استفاده شود.
مدل اعتماد مهار CLI
زمانهای اجرای تعبیهشده و هارنس app-server مربوط به Codex محدودیت حلقه صفر را
مستقیماً اعمال میکنند: اجرا یک فهرست مجاز ابزار OpenClaw دارد که فقط شامل
ابزار openclaw است. برای Codex، OpenClaw همچنین محیطها، اجرای بومی،
چندعاملی، هدف، app/plugin، skill/MCP، جستوجوی وب و سطحهای
request_user_input را برای آن اجرا غیرفعال میکند. Codex همچنان ابزار بومی غیرفعال
update_plan خود را تزریق میکند؛ این ابزار میتواند چکلیست موقت مدل را بهروزرسانی کند، اما نمیتواند فایلها
یا پیکربندی OpenClaw را بنویسد. هارنسهای CLI فهرست مجاز OpenClaw را مصرف نمیکنند،
بنابراین OpenClaw فقط بکاندهایی را میپذیرد که قرارداد انتخاب ابزار خودشان بتواند
همان محدودیت را اثبات کند:
- بکاندهای قابلانتخاب، از جمله Claude Code، با انتخاب خالی ابزار بومی
و یک ابزار MCP، یعنی
openclaw، راهاندازی میشوند. پیکربندی MCP تولیدشده Claude با--strict-mcp-configاعمال میشود، بنابراین هیچ سرور MCP دیگری بارگذاری نمیشود. - بکاندهایی که اعلام میکنند هیچ ابزار بومی ندارند، همان سرور اختصاصی MCP مربوط به OpenClaw را دریافت میکنند.
- بکاندهایی با ابزارهای بومی همیشهفعال یا ناشناخته، پیش از استنتاج بهصورت بسته شکست میخورند؛ آنها نمیتوانند میزبان یک نشست OpenClaw باشند.
فقط نشستهای OpenClaw سرور MCP مربوط به openclaw را دریافت میکنند؛ اجراهای عادی عامل هرگز این ابزار را نمیبینند. بنابراین بکاندهای CLI قابلانتخاب/بدون ابزار بومی و مدلهای مبتنی بر کلید API حلقه تکابزاری تحتاللفظی را اعمال میکنند. مدلهای app-server مربوط به Codex یک ابزار اقتدار OpenClaw بههمراه ابزار بومی غیرفعال برنامهریزی را اعمال میکنند. در هر سه حالت، نوشتنهای راهاندازی همچنان به قرارداد تأیید ممیزیشده OpenClaw محدود میمانند.
Gemini CLI همچنان برای عاملهای عادی در دسترس است، اما نمیتواند کاوش بدون ابزار موردنیاز دروازه استنتاج را اعمال کند، بنابراین نمیتواند میزبان OpenClaw باشد.
جابهجایی به یک عامل
برای خروج از OpenClaw و باز کردن TUI عادی، از یک انتخابگر زبان طبیعی استفاده کنید:
با عامل صحبت کنبا عامل work صحبت کنبه عامل اصلی جابهجا شوopenclaw tui، openclaw chat و openclaw terminal مستقیماً TUI عادی عامل را باز میکنند؛ آنها OpenClaw را شروع نمیکنند. پس از جابهجایی به TUI عادی، /openclaw به OpenClaw بازمیگردد و میتواند در صورت نیاز یک درخواست پیگیری نیز داشته باشد:
/openclaw/openclaw راهاندازی مجدد gatewayحالت نجات پیام
حالت نجات پیام، نقطه ورود کانال پیام برای OpenClaw است: وقتی عامل عادی شما از کار افتاده اما یک کانال مورداعتماد (برای مثال WhatsApp) همچنان فرمانها را دریافت میکند، از آن استفاده کنید.
این یک کنترلکننده قطعی فرمان اضطراری است، نه عامل مکالمهای OpenClaw. این حالت یک راهاندازی تازه را بوتاسترپ نمیکند و دروازه استنتاج را برای گفتوگوی OpenClaw تسهیل نمیکند.
فرمان پشتیبانیشده: /openclaw <request>. نجات فقط دستور زبان دقیق فرمان تایپشده را میپذیرد — زبان طبیعی با یک راهنمایی رد میشود، هرگز بهصورت حدسی به یک عملیات تبدیل نمیشود و هیچگاه از مدل استفاده نمیشود.
شما، در یک پیام مستقیم مالک مورداعتماد: /openclaw statusOpenClaw: حالت نجات OpenClaw. Gateway قابل دسترسی است: خیر. پیکربندی معتبر است: خیر.شما: /openclaw restart gatewayOpenClaw: برنامه: راهاندازی مجدد Gateway. برای اعمال، با /openclaw yes پاسخ دهید.شما: /openclaw yesOpenClaw: اعمال شد. ورودی ممیزی نوشته شد.ایجاد عامل را نیز میتوان بهصورت محلی یا از طریق نجات در صف قرار داد:
create agent work workspace ~/Projects/work model openai/gpt-5.6-sol/openclaw create agent work workspace ~/Projects/workایجاد عامل فقط میتواند مدل پیشفرض فعلیِ تأییدشده بهصورت زنده را نام ببرد. برای بهارثبردن آن مسیر، مدل را حذف کنید.
نجات راه دور یک سطح مدیریتی است و باید مانند تعمیر پیکربندی راه دور با آن رفتار شود، نه گفتوگوی عادی.
قرارداد امنیتی برای نجات راه دور:
- وقتی سندباکسسازی برای عامل/نشست فعال باشد، غیرفعال است؛ OpenClaw نجات راه دور را رد میکند و به تعمیر محلی CLI ارجاع میدهد.
- حالت مؤثر پیشفرض
autoاست: نجات راه دور را فقط در عملیات YOLO مورداعتماد مجاز کنید، جایی که زمان اجرا از قبل اختیار محلی بدون سندباکس دارد (tools.exec.securityبهfullوtools.exec.askبهoffحل میشود، با حالت سندباکسoff). - به هویت صریح مالک نیاز دارد؛ قوانین فرستنده با نویسه عام، خطمشی گروه باز، Webhookهای احراز هویتنشده یا کانالهای ناشناس مجاز نیستند.
- بهطور پیشفرض فقط پیامهای مستقیم مالک؛ نجات در گروه/کانال به فعالسازی صریح نیاز دارد.
- جستوجو و فهرست Plugin فقط خواندنی هستند. نصب Plugin همیشه فقط محلی است (در نجات مسدود است، حتی وقتی در حالت عادی فعال باشد)، زیرا کد اجرایی را دانلود میکند. حذف نصب Plugin هم در OpenClaw محلی و هم در نجات رد میشود؛
openclaw plugins uninstall <id>را از یک ترمینال اجرا کنید. - نجات راه دور نمیتواند TUI محلی را باز کند یا به یک نشست تعاملی عامل جابهجا شود؛ برای تحویل کار به عامل از
openclawمحلی استفاده کنید. - نوشتنهای ماندگار حتی در حالت نجات همچنان به تأیید نیاز دارند.
- تأییدهای در انتظار یکبارمصرف هستند. هر فرمان نجات جدیدتر برای همان حساب، کانال و فرستنده، برنامه قدیمیتر را لغو میکند؛ اجرای ناموفق نیز تأیید را مصرف میکند، بنابراین برای تلاش دوباره فرمان را مجدداً ارسال کنید.
- هر عملیات نجات اعمالشده ممیزی میشود. نجات کانال پیام، فراداده کانال، حساب، فرستنده و نشانی مبدأ را ثبت میکند؛ عملیات تغییردهنده پیکربندی همچنین هشهای پیکربندی پیش و پس از تغییر را ثبت میکنند.
- اسرار هرگز بازتاب داده نمیشوند. بازرسی SecretRef دسترسپذیری را گزارش میکند، نه مقادیر را.
- اگر Gateway فعال باشد، نجات عملیات نوعدار Gateway را ترجیح میدهد؛ اگر از کار افتاده باشد، نجات فقط از حداقل سطح تعمیر محلی استفاده میکند که به حلقه عادی عامل وابسته نیست.
شکل پیکربندی:
{ "systemAgent": { "rescue": { "enabled": "auto", "ownerDmOnly": true, "pendingTtlMinutes": 15, }, },}enabled:"auto"(پیشفرض) نجات را فقط زمانی مجاز میکند که زمان اجرای مؤثر YOLO باشد و سندباکسسازی خاموش باشد؛falseهرگز نجات از طریق کانال پیام را مجاز نمیکند؛trueوقتی بررسیهای مالک/کانال با موفقیت عبور کنند، نجات را صریحاً مجاز میکند (همچنان مشمول رد شدن بهدلیل سندباکسسازی است).ownerDmOnly: نجات را به پیامهای مستقیم مالک محدود میکند. پیشفرضtrueاست.pendingTtlMinutes: مدتزمانی که یک نوشتن نجات در انتظار، پیش از انقضا برای تأیید/openclaw yesباز میماند. پیشفرض15است.
openclaw doctor --fix بلوک پیکربندی قدیمی crestodian را به
systemAgent مهاجرت میدهد. زمان اجرا فقط بلوک canonical را میخواند.
نجات راه دور در مسیر Docker پوشش داده شده است:
pnpm test:docker:system-agent-rescueیک آزمون دود اختیاریِ سطح فرمان کانال زنده، /openclaw status را بههمراه یک رفتوبرگشت تأیید ماندگار از طریق کنترلکننده نجات بررسی میکند:
pnpm test:live:system-agent-rescue-channelراهاندازی یکباره بستهبندیشده با دروازه استنتاج توسط مورد زیر پوشش داده میشود:
pnpm test:docker:system-agent-first-runآن مسیر CLI بستهبندیشده با یک دایرکتوری حالت خالی آغاز میشود و اثبات میکند که OpenClaw بدون استنتاج بهصورت بسته شکست میخورد. سپس Claude جعلی را از طریق ماژول فعالسازی بستهبندیشده آزمایش و فعال میکند. تنها پس از آن است که یک درخواست مبهم به برنامهریز میرسد و به راهاندازی نوعدار حل میشود و در ادامه، فرمانهای یکبارهای اجرا میشوند که یک عامل اضافی ایجاد میکنند، Discord را از طریق فعالسازی Plugin بههمراه SecretRef توکن پیکربندی میکنند، پیکربندی را اعتبارسنجی میکنند و گزارش ممیزی را بررسی میکنند. این مسیر، شواهد پشتیبان دروازه/عملیات است؛ راهاندازی تعاملی یا مکالمه عامل/ابزار/تأیید OpenClaw را اجرا نمیکند. سناریوی QA Lab زیر به همان مسیر Docker هدایت میشود:
pnpm openclaw qa suite --scenario system-agent-ring-zero-setup