مهار Codex

افزونه رسمی codex نوبت‌های عامل OpenAI را به‌صورت تعبیه‌شده از طریق app-server مربوط به Codex اجرا می‌کند، نه از طریق سازوکار داخلی OpenClaw. Codex مالک نشست سطح‌پایین عامل است: ازسرگیری بومی رشته، ادامه بومی ابزار، Compaction بومی و اجرای app-server. OpenClaw همچنان مالک کانال‌های گفت‌وگو، فایل‌های نشست، انتخاب مدل، ابزارهای پویای OpenClaw، تأییدها، تحویل رسانه و نسخه قابل‌مشاهده رونوشت است.

از ارجاع‌های استاندارد مدل OpenAI مانند openai/gpt-5.6-sol استفاده کنید. ارجاع‌های قدیمی Codex GPT را پیکربندی نکنید؛ ترتیب احراز هویت عامل OpenAI را زیر auth.order.openai قرار دهید. شناسه‌های قدیمی پروفایل احراز هویت Codex و ورودی‌های قدیمی ترتیب احراز هویت Codex با openclaw doctor --fix اصلاح می‌شوند.

وقتی سیاست زمان اجرای ارائه‌دهنده/مدل تنظیم نشده یا auto است، پیشوند openai/* به‌تنهایی هرگز این سازوکار را انتخاب نمی‌کند. OpenAI فقط برای یک مسیر دقیق و رسمی HTTPS مربوط به Platform Responses یا ChatGPT Responses، بدون بازنویسی درخواست توسط کاربر، می‌تواند Codex را به‌طور ضمنی انتخاب کند. به زمان اجرای ضمنی عامل OpenAI مراجعه کنید. اگر پیش از مشخص‌شدن مسیریابی Platform در برابر ChatGPT، مالکیت احراز هویت با Codex باشد، OpenClaw همچنان از همه مسیرهای نامزد می‌خواهد سازگاری با Codex را اعلام کنند. مالکیت بومی احراز هویت به‌تنهایی هرگز این بررسی مسیر را دور نمی‌زند.

وقتی هیچ سندباکس OpenClaw فعالی وجود ندارد، OpenClaw رشته‌های app-server مربوط به Codex را با حالت کد بومی Codex فعال آغاز می‌کند (حالت فقط-کد به‌طور پیش‌فرض غیرفعال می‌ماند)، بنابراین قابلیت‌های بومی فضای کاری/کد در کنار ابزارهای پویای OpenClaw که از طریق پل app-server یعنی item/tool/call مسیریابی می‌شوند، در دسترس می‌مانند. سندباکس فعال OpenClaw یا سیاست محدودکننده ابزار، حالت کد بومی را کاملاً غیرفعال می‌کند، مگر اینکه مسیر آزمایشی exec-server سندباکس را فعال کنید.

با tools.exec.host: "auto" پیش‌فرض و بدون سندباکس فعال OpenClaw، Codex ابزارهای node_exec و node_process را نیز برای فرمان‌ها روی Nodeهای جفت‌شده دریافت می‌کند. پوسته بومی روی میزبان و فضای کاری app-server مربوط به Codex باقی می‌ماند (برای استقرار پیش‌فرض stdio، محلیِ Gateway است)؛ node_exec یک Node را با نام یا شناسه انتخاب می‌کند و سیاست تأیید Node در OpenClaw را برقرار نگه می‌دارد. اگر فهرست مجاز محدود زمان اجرا، حالت کد بومی را غیرفعال کند و نوبت را بدون محیط اجرا باقی بگذارد، OpenClaw در عوض ابزارهای exec و process را پس از پالایش طبق سیاست، برای اجرای مستقیم و بدون سندباکس در دسترس نگه می‌دارد.

این قابلیت بومی Codex از حالت کد OpenClaw جدا است؛ حالتی که یک زمان اجرای اختیاری QuickJS-WASI برای اجراهای عمومی OpenClaw با شکل ورودی متفاوت exec است. برای آشنایی با تفکیک گسترده‌تر مدل/ارائه‌دهنده/زمان اجرا، از زمان‌های اجرای عامل شروع کنید: openai/gpt-5.6-sol ارجاع مدل، codex زمان اجرا و Telegram، Discord، Slack یا کانالی دیگر سطح ارتباطی است.

الزامات

• افزونه رسمی @openclaw/codex نصب شده باشد. اگر پیکربندی شما از فهرست مجاز استفاده می‌کند، codex را در plugins.allow قرار دهید.
• یک app-server پایدار Codex از 0.143.0 تا 0.145.0. افزونه به‌طور پیش‌فرض یک فایل اجرایی سازگار را مدیریت می‌کند، بنابراین فرمان codex در PATH بر راه‌اندازی عادی تأثیر نمی‌گذارد.
• احراز هویت Codex از طریق openclaw models auth login --provider openai، حساب app-server که از قبل در خانه Codex عامل موجود است، یا یک پروفایل صریح احراز هویت کلید API مربوط به Codex.

برای تقدم احراز هویت، جداسازی محیط، فرمان‌های سفارشی app-server، کشف مدل و فهرست کامل فیلدهای پیکربندی، به مرجع سازوکار Codex مراجعه کنید.

شروع سریع

افزونه رسمی را نصب کنید، سپس با OAuth مربوط به Codex وارد شوید:

openclaw plugins install @openclaw/codexopenclaw models auth login --provider openai

افزونه codex را فعال کنید و یک مدل عامل OpenAI را انتخاب کنید:

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-sol",    },  },}

اگر پیکربندی شما از plugins.allow استفاده می‌کند، codex را نیز به آن اضافه کنید:

{  plugins: {    allow: ["codex"],    entries: {      codex: {        enabled: true,      },    },  },}

پس از تغییر پیکربندی افزونه، Gateway را دوباره راه‌اندازی کنید. اگر یک گفت‌وگو از قبل نشست دارد، ابتدا /new یا /reset را اجرا کنید تا نوبت بعدی سازوکار را از پیکربندی فعلی تعیین کند.

اشتراک‌گذاری رشته‌ها با Codex Desktop و CLI

مقدار پیش‌فرض appServer.homeScope: "agent" هر عامل OpenClaw را از وضعیت بومی Codex اپراتور جدا می‌کند. برای اینکه مالک بتواند همان رشته‌های بومی نمایش‌داده‌شده در Codex Desktop و Codex CLI را بررسی و مدیریت کند، استفاده از خانه Codex کاربر را فعال کنید:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            homeScope: "user",          },        },      },    },  },}

حالت خانه کاربر از یک فرایند محلی مدیریت‌شده stdio یا انتقال مشترک سوکت Unix پشتیبانی می‌کند. در صورت تنظیم، از $CODEX_HOME و در غیر این صورت از ~/.codex استفاده می‌کند؛ از جمله احراز هویت بومی Codex، پیکربندی، افزونه‌ها و مخزن رشته‌های آن خانه. OpenClaw یک پروفایل احراز هویت OpenClaw را به این app-server تزریق نمی‌کند.

نوبت‌های مالک به ابزار codex_threads دسترسی پیدا می‌کنند: فهرست‌کردن، جست‌وجو، خواندن، منشعب‌کردن، تغییر نام، بایگانی و بازیابی رشته‌های بومی. برای ادامه یک رشته در OpenClaw، از آن انشعاب بگیرید؛ انشعاب به نشست فعلی OpenClaw متصل می‌شود و برای سایر کلاینت‌های بومی Codex قابل‌مشاهده می‌ماند. بایگانی نیازمند تأیید صریح بسته‌بودن رشته در جاهای دیگر است. وقتی نظارت نیز فعال باشد، فیلدها و تغییرات رونوشت به فعال‌سازی متناظر supervision.allowRawTranscripts یا supervision.allowWriteControls نیاز دارند.

یک رشته را به‌طور هم‌زمان از طریق App Serverهای مستقل و مدیریت‌شده stdio از سر نگیرید یا در آن ننویسید. Codex نویسندگان زنده را درون یک App Server هماهنگ می‌کند، نه میان فرایندهای جداگانه. انشعاب‌گیری مسیر امن هم‌زیستی برای نشست‌های عادی stdio در خانه کاربر است.

appServer.homeScope: "user" به‌تنهایی کاتالوگ ناوگان را کنترل نمی‌کند. کشف نشست بومی تا زمانی که افزونه فعال است، فعال می‌ماند؛ برای حذف آن از نوار کناری OpenClaw بدون غیرفعال‌کردن Codex، sessionCatalog.enabled: false را تنظیم کنید. کاتالوگ از اتصال نظارتی جداگانه‌ای استفاده می‌کند؛ بدون تنظیمات صریح اتصال appServer، این اتصال به‌طور پیش‌فرض از stdio مدیریت‌شده خانه کاربر استفاده می‌کند، درحالی‌که سازوکار عادی در محدوده عامل باقی می‌ماند. تنظیمات صریح appServer در هر دو مسیر رعایت می‌شوند. هنگامی که سازوکار عادی نیز باید وضعیت بومی را به اشتراک بگذارد، homeScope: "user" را مانند نمونه بالا به‌صراحت تنظیم کنید.

نظارت بر نشست‌های Codex

همان افزونه codex می‌تواند نشست‌های بایگانی‌نشده Codex را از رایانه Gateway و Nodeهای جفت‌شده‌ای که این قابلیت را فعال کرده‌اند، فهرست کند. یک نشست ذخیره‌شده یا بیکار محلیِ Gateway می‌تواند گفت‌وگویی مقید به مدل ایجاد کند که تاریخچه محدود و ماندگار پیام‌های کاربر و دستیار را بازتاب می‌دهد. اتصال خصوصی آن برای تصویر لحظه‌ای بومی، شاخه استاندارد و نوبت‌های بعدی از اتصال نظارتی استفاده می‌کند، درحالی‌که نشست‌های عادی Codex در محدوده عامل باقی می‌مانند. نخستین شروع استاندارد دقیقاً از مدل و ارائه‌دهنده‌ای استفاده می‌کند که Codex برای انشعاب تصویر لحظه‌ای برمی‌گرداند. در ازسرگیری‌های بعدی، انتخاب به پیکربندی بومی Codex واگذار می‌شود؛ مدل بیرونی OpenClaw و زنجیره جایگزین هرگز آن را عوض نمی‌کنند. ردیف‌های ذخیره‌شده و بیکار را می‌توان پس از تأیید صریح نبود اجراکننده دیگر بایگانی کرد. منابع فعال نمی‌توانند شاخه ایجاد کنند یا بایگانی شوند؛ گفت‌وگوی تحت نظارت موجود همچنان قابل بازکردن است. نشست‌های Node جفت‌شده فقط شامل فراداده باقی می‌مانند.

برای راه‌اندازی، قواعد انشعاب، محدودیت‌های Node جفت‌شده، نمایش فراداده و عیب‌یابی به نظارت بر نشست‌های Codex مراجعه کنید.

پیکربندی

برای ترتیب ابتدا-اشتراک/پشتیبان-کلید-API، auth.order.openai را ترجیح دهید. شناسه‌های موجود پروفایل احراز هویت قدیمی Codex و ترتیب احراز هویت قدیمی Codex، وضعیت قدیمی ویژه doctor هستند؛ ارجاع‌های قدیمی جدید Codex GPT ایجاد نکنید.

{  auth: {    order: {      openai: ["openai:user@example.com", "openai:api-key-backup"],    },  },}

برای یک مسیر مؤثر سازگار با Codex، هر دو پروفایل بالا برای همان اجرای Codex نامزد باقی می‌مانند. ترتیب پروفایل، اعتبارنامه‌ها را انتخاب می‌کند، نه زمان اجرا را. تغییر ترتیب احراز هویت، یک مسیر سفارشی، Completions، HTTP یا بازنویسی‌شده در درخواست را با Codex سازگار نمی‌کند.

Compaction

روی عامل‌های متکی به Codex، compaction.model یا compaction.provider را تنظیم نکنید. Codex از طریق وضعیت بومی رشته app-server خود Compaction را انجام می‌دهد؛ بنابراین OpenClaw آن بازنویسی‌های محلی خلاصه‌ساز را هنگام اجرا نادیده می‌گیرد و openclaw doctor --fix هنگامی که عامل از Codex استفاده می‌کند، آن‌ها را حذف می‌کند.

Lossless همچنان به‌عنوان موتور زمینه برای مونتاژ، ورود داده و نگه‌داری پیرامون نوبت‌های Codex پشتیبانی می‌شود و از طریق plugins.slots.contextEngine: "lossless-claw" و plugins.entries.lossless-claw.config.summaryModel پیکربندی می‌شود، نه از طریق agents.defaults.compaction.provider. هنگامی که Codex زمان اجرای فعال است، openclaw doctor --fix شکل قدیمی compaction.provider: "lossless-claw" را به جایگاه موتور زمینه Lossless منتقل می‌کند، اما مالکیت Compaction بومی همچنان با Codex است. سازوکار بومی app-server از موتورهای زمینه‌ای که به مونتاژ پیش از اعلان نیاز دارند پشتیبانی می‌کند؛ بک‌اندهای عمومی CLI، از جمله codex-cli، این قابلیت میزبان را فراهم نمی‌کنند.

برای عامل‌های متکی به Codex، /compact فرایند Compaction بومی app-server مربوط به Codex را روی رشته متصل آغاز می‌کند و منتظر نتیجه نهایی آن می‌ماند. بودجه مشترک agents.defaults.compaction.timeoutSeconds اعمال می‌شود؛ در صورت پایان مهلت، OpenClaw از Codex می‌خواهد نوبت بومی را قطع کند و مانع مختص رشته را تا تأیید خاتمه حفظ می‌کند. این فرایند هرگز به موتور زمینه یا خلاصه‌ساز عمومی OpenAI بازنمی‌گردد. اگر اتصال رشته بومی Codex مفقود یا منقضی باشد، فرمان به‌صورت امن متوقف می‌شود، به‌جای اینکه بی‌سروصدا بک‌اند Compaction را تغییر دهد.

زمینه طولانی API مستقیم

اشتراک Codex و ترافیک مستقیم OpenAI API قراردادهای جداگانه‌ای هستند. کاتالوگ زنده ChatGPT/Codex معمولاً پنجره مدل 272000 توکنی را ارائه می‌کند، درحالی‌که OpenAI برای Platform API پنجره‌ای 1050000 توکنی و برای GPT-5.5 و GPT-5.6 حداکثر خروجی 128000 را مستند کرده است. رزرو کل ظرفیت خروجی، بودجه ورودی محاسبه‌شده 922000 توکنی باقی می‌گذارد. درخواست‌هایی با بیش از 272000 توکن ورودی، مشمول قیمت‌گذاری بالاتر OpenAI برای زمینه طولانی می‌شوند.

کار را با یک کاتالوگ کامل مدل‌های Codex آغاز کنید که با نسخه نصب‌شده Codex سازگار باشد. برای هر ورودی مستقیم GPT-5.5 یا GPT-5.6 که باید از زمینه طولانی استفاده کند، بقیه توصیف‌گر را حفظ کنید و این مقادیر را تنظیم کنید:

{  "context_window": 922000,  "max_context_window": 922000,  "auto_compact_token_limit": 700000}

Codex ذخیره معمول 95٪ پنجره مؤثر خود را روی مقدار کاتالوگ 922000 اعمال می‌کند، بنابراین حدود 875900 توکن قابل‌استفاده گزارش می‌دهد. Compaction در 700000 پیش از آن محافظ مؤثر، 175900 توکن و پیش از ظرفیت ورودی امن ارائه‌دهنده، 222000 توکن باقی می‌گذارد. این حاشیه بزرگ‌تر عمدی است: Codex پیش از افزودن پیام بعدی کاربر و به‌روزرسانی‌های زمینه، زمینه ازپیش‌ثبت‌شده را بررسی می‌کند؛ بنابراین آستانه باید علاوه بر ابزارها، دستورالعمل‌ها، سریال‌سازی و خود نوبت Compaction، یک نوبت ورودی بزرگ را نیز پوشش دهد.

برای استفاده مستقل از Codex CLI یا Desktop، یک ارائه‌دهنده سفارشی با احراز هویت فرمانی می‌تواند کلید API را از جاکلیدی سیستم یا مدیر اسرار بخواند، درحالی‌که ورود عادی ChatGPT برای اتصال‌دهنده‌ها همچنان در دسترس می‌ماند:

model = "gpt-5.6-terra"model_provider = "openai_api_direct"model_context_window = 922000model_auto_compact_token_limit = 700000model_auto_compact_token_limit_scope = "total"model_catalog_json = "/absolute/path/to/models-api-1m.json" [model_providers.openai_api_direct]name = "OpenAI API direct"base_url = "https://api.openai.com/v1"wire_api = "responses"requires_openai_auth = false [model_providers.openai_api_direct.auth]command = "/absolute/path/to/read-openai-inference-key"timeout_ms = 5000refresh_interval_ms = 300000

راهکار کمکی احراز هویت باید فقط کلید را در stdout چاپ کند. آن را در TOML قرار ندهید.

برای مهار app-server مربوط به OpenClaw Codex، خانه پیش‌فرض Codex در محدوده عامل را حفظ کنید و اجازه دهید OpenClaw یک نمایه کلید API با شناسه openai تزریق کند. کاتالوگ و محدودیت‌های زمینه را به‌صورت آرگومان‌های بومی Codex app-server ارسال کنید:

{  auth: {    order: {      openai: ["openai:api-key"],    },  },  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            args: [              "app-server",              "--listen",              "stdio://",              "-c",              'model_catalog_json="/absolute/path/to/models-api-1m.json"',              "-c",              "model_context_window=922000",              "-c",              "model_auto_compact_token_limit=700000",              "-c",              "model_auto_compact_token_limit_scope=total",            ],          },        },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-terra",      models: {        "openai/gpt-5.6-terra": { agentRuntime: { id: "codex" } },      },    },  },}

در صورت نیاز، openai:api-key را با شناسه واقعی نمایه کلید API جایگزین کنید. app-server در محدوده عامل فقط همان کلید آماده‌شده را دریافت می‌کند؛ ورود بومی ChatGPT اپراتور با شناسه ~/.codex، Pluginها، اتصال‌دهنده‌ها و مخزن رشته‌ها بدون تغییر باقی می‌مانند. 0.144.6 مربوط به Codex app-server در نوبت‌های app-server توکن حاملِ ارائه‌دهنده سفارشی با احراز هویت فرمانی را پیوست نمی‌کند؛ بنابراین برای این مسیر، به‌جای homeScope: "user" از مسیر کلید API تزریق‌شده بالا استفاده کنید.

پس از تغییر کاتالوگ یا آرگومان‌های app-server، Gateway را راه‌اندازی مجدد کنید و یک گفت‌وگوی تازه آغاز کنید. رشته‌های بومی موجود، تنظیمات ثبت‌شده ارائه‌دهنده و مدل خود را حفظ می‌کنند. زمان اجرا را با /status و /codex status بررسی کنید، سپس پیش از آغاز یک نشست طولانی، یک نوبت مستقیم و بی‌خطر API ارسال کنید.

ادامه این صفحه شکل استقرار، مسیریابی fail-closed، سیاست تأیید نگهبان، Pluginهای بومی Codex و Computer Use را پوشش می‌دهد. برای فهرست کامل گزینه‌ها، مقادیر پیش‌فرض، enumها، کشف، جداسازی محیط، مهلت‌های زمانی و فیلدهای انتقال app-server، به مرجع مهار Codex مراجعه کنید.

بررسی زمان اجرای Codex

در گفت‌وگویی که انتظار دارید از Codex استفاده شود، از /status استفاده کنید. نوبت عامل OpenAI با پشتوانه Codex این مورد را نشان می‌دهد:

زمان اجرا: OpenAI Codex

سپس وضعیت Codex app-server را بررسی کنید:

/codex status/codex models/codex binding

/codex binding رشته بومی پیوست‌شده و تنظیمات فعلی مدل را گزارش می‌کند. /codex status اتصال app-server، حساب، محدودیت‌های نرخ، سرورهای MCP و Skills را گزارش می‌کند. /codex models کاتالوگ زنده Codex app-server را برای مهار و حساب فهرست می‌کند. اگر /status غیرمنتظره است، به عیب‌یابی مراجعه کنید.

مسیریابی و انتخاب مدل

ارجاع‌های ارائه‌دهنده و سیاست زمان اجرا را از هم جدا نگه دارید:

• برای انتخاب استاندارد مدل OpenAI از openai/gpt-* استفاده کنید. پیشوند به‌تنهایی هرگز Codex را انتخاب نمی‌کند.
• وقتی زمان اجرا تنظیم نشده یا auto است، فقط یک مسیر دقیق و رسمی HTTPS برای Platform Responses یا ChatGPT Responses، بدون بازنویسی تألیفی درخواست، می‌تواند Codex را به‌طور ضمنی انتخاب کند.
• از ارجاع‌های قدیمی Codex GPT در پیکربندی استفاده نکنید؛ برای ترمیم ارجاع‌های قدیمی و پین‌های کهنه مسیر نشست، openclaw doctor --fix را اجرا کنید.
• agentRuntime.id: "codex"، Codex را برای یک مسیر سازگار به الزامی fail-closed تبدیل می‌کند. این گزینه یک مسیر مؤثر ناسازگار را سازگار نمی‌کند.
• agentRuntime.id: "openclaw"، در صورت عمدی‌بودن، یک ارائه‌دهنده یا مدل را وارد زمان اجرای تعبیه‌شده OpenClaw می‌کند.
• /codex ... مکالمه‌های بومی Codex app-server را از داخل گفت‌وگو کنترل می‌کند.
• ACP/acpx یک مسیر مهار خارجی جداگانه است. فقط زمانی از آن استفاده کنید که کاربر ACP/acpx یا یک سازگارکننده مهار خارجی درخواست کرده باشد.

agents.defaults.imageModel از همان تفکیک پیشوند پیروی می‌کند. برای مسیر عادی OpenAI از openai/gpt-* و فقط زمانی از codex/gpt-* استفاده کنید که درک تصویر باید از طریق یک نوبت محدود Codex app-server انجام شود. Doctor ارجاع‌های قدیمی Codex GPT را به openai/gpt-* بازنویسی می‌کند.

الگوهای استقرار

استقرار پایه Codex

از پیکربندی شروع سریع برای مدلی از OpenAI استفاده کنید که مسیر مؤثر و رسمی HTTPS آن واجد شرایط انتخاب ضمنی Codex باشد:

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-sol",    },  },}

استقرار چندارائه‌دهنده‌ای

Claude را به‌عنوان عامل پیش‌فرض نگه دارید و یک عامل نام‌گذاری‌شده Codex اضافه کنید:

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "anthropic/claude-opus-4-6",    },    list: [      {        id: "main",        default: true,        model: "anthropic/claude-opus-4-6",      },      {        id: "codex",        name: "Codex",        model: "openai/gpt-5.6-sol",      },    ],  },}

عامل main از مسیر عادی ارائه‌دهنده خود استفاده می‌کند. عامل codex وقتی مسیر مؤثر OpenAI آن سازگار باقی بماند، از Codex app-server استفاده می‌کند؛ اگر این رفتار باید یک الزام fail-closed باشد، agentRuntime.id: "codex" صریح در سطح مدل را اضافه کنید.

استقرار fail-closed برای Codex

وقتی Plugin همراه در دسترس باشد، یک مسیر دقیق و رسمی HTTPS واجد شرایط OpenAI می‌تواند به Codex تفکیک شود. برای یک قاعده صریح fail-closed، سیاست زمان اجرای صریح را اضافه کنید:

{  models: {    providers: {      openai: {        agentRuntime: {          id: "codex",        },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-sol",    },  },  plugins: {    entries: {      codex: {        enabled: true,      },    },  },}

وقتی Codex اجباری باشد، اگر مسیر مؤثر سازگار با Codex اعلام نشده باشد، Plugin غیرفعال باشد، app-server بیش‌ازحد قدیمی باشد یا app-server نتواند راه‌اندازی شود، OpenClaw در همان مراحل اولیه با خطا متوقف می‌شود.

خط‌مشی app-server

Plugin به‌طور پیش‌فرض، فایل اجرایی مدیریت‌شده Codex متعلق به OpenClaw را به‌صورت محلی و با انتقال stdio راه‌اندازی می‌کند. appServer.command را فقط زمانی تنظیم کنید که عمداً می‌خواهید فایل اجرایی دیگری را اجرا کنید. Codex انتقال WebSocket را آزمایشی و پشتیبانی‌نشده طبقه‌بندی می‌کند؛ فقط برای آزمون‌های غیرعملیاتی در برابر app-serverای که از قبل در جای دیگری در حال اجراست از آن استفاده کنید:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            transport: "websocket",            url: "ws://gateway-host:39175",            authToken: "${CODEX_APP_SERVER_TOKEN}",          },        },      },    },  },}

نشست‌های محلی stdio app-server به‌طور پیش‌فرض از وضعیت اپراتور محلی مورداعتماد استفاده می‌کنند: approvalPolicy: "never"، approvalsReviewer: "user" و sandbox: "danger-full-access". اگر الزامات محلی Codex آن وضعیت ضمنی YOLO را مجاز ندانند، OpenClaw به‌جای آن مجوزهای نگهبان مجاز را انتخاب می‌کند. وقتی برای نشست یک محیط ایزوله OpenClaw فعال باشد، OpenClaw به‌جای تکیه بر محیط ایزوله سمت میزبان Codex، Code Mode بومی Codex، سرورهای MCP کاربر و اجرای Plugin متکی به اپ را برای آن نوبت غیرفعال می‌کند. در عوض، وقتی ابزارهای عادی exec/process در دسترس باشند، دسترسی پوسته از طریق ابزارهای پویای متکی به محیط ایزوله OpenClaw مانند sandbox_exec و sandbox_process انجام می‌شود.

پیش از گریز از محیط ایزوله یا اعطای مجوزهای اضافی، برای بازبینی خودکار بومی Codex از حالت exec نرمال‌شده OpenClaw استفاده کنید:

{  tools: {    exec: {      mode: "auto",    },  },  plugins: {    entries: {      codex: {        enabled: true,      },    },  },}

برای نشست‌های Codex app-server، ‏tools.exec.mode: "auto" به تأییدهای بازبینی‌شده توسط نگهبان Codex نگاشت می‌شود: معمولاً approvalPolicy: "on-request"، ‏approvalsReviewer: "auto_review" و sandbox: "workspace-write"، به‌شرط آنکه الزامات محلی این مقادیر را مجاز بدانند. در tools.exec.mode: "auto"، ‏OpenClaw بازنویسی‌های ناامن قدیمی Codex یعنی approvalPolicy: "never" یا sandbox: "danger-full-access" را حفظ نمی‌کند؛ برای وضعیت عمدی Codex بدون تأیید از tools.exec.mode: "full" استفاده کنید. پیش‌تنظیم قدیمی plugins.entries.codex.config.appServer.mode: "guardian" همچنان کار می‌کند، اما tools.exec.mode: "auto" سطح نرمال‌شده OpenClaw است.

برای مقایسه در سطح حالت با تأییدهای exec میزبان و مجوزهای ACPX، به حالت‌های مجوز مراجعه کنید. برای همه فیلدهای app-server، ترتیب احراز هویت، جداسازی محیط و رفتار مهلت زمانی، به مرجع مهار Codex مراجعه کنید.

فرمان‌ها و عیب‌یابی

Plugin ‏codex، ‏/codex را در هر کانالی که از فرمان‌های متنی OpenClaw پشتیبانی کند، به‌عنوان فرمان اسلش ثبت می‌کند.

اجرای بومی و کنترل به یک مالک یا کلاینت Gateway دارای operator.admin نیاز دارد: اتصال یا ازسرگیری رشته‌ها، ارسال یا توقف نوبت‌ها، تغییر مدل، حالت سریع یا وضعیت مجوز، فشرده‌سازی یا بازبینی و قطع یک اتصال. سایر فرستندگان مجاز، فرمان‌های فقط‌خواندنی وضعیت، راهنما، حساب، مدل، رشته، هدف بومی، سرور MCP، مهارت و بررسی اتصال را حفظ می‌کنند.

شکل‌های رایج:

• /codex status اتصال app-server، مدل‌ها، حساب، محدودیت‌های نرخ، سرورهای MCP و مهارت‌ها را بررسی می‌کند.
• /codex models مدل‌های فعال Codex app-server را فهرست می‌کند.
• /codex threads [filter] رشته‌های اخیر Codex app-server را فهرست می‌کند.
• /codex goal هدف بومی Codex رشته متصل‌شده را می‌خواند یا به‌روزرسانی می‌کند. ادامه خودکار هدف Codex غیرفعال باقی می‌ماند؛ OpenClaw هنوز مالک نوبت‌های پیگیری خودکار نیست.
• /codex resume <thread-id> نشست فعلی OpenClaw را به یک رشته موجود Codex متصل می‌کند.
• /codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>] گفت‌وگوی فعلی را متصل می‌کند.
• /codex detach (یا /codex unbind) اتصال فعلی را قطع می‌کند.
• /codex binding اتصال فعلی را توصیف می‌کند.
• /codex stop نوبت فعال را متوقف می‌کند؛ /codex steer <text> آن را هدایت می‌کند.
• /codex model <model>، ‏/codex fast [on|off|status] و /codex permissions [default|yolo|status] وضعیت هر مکالمه را تغییر می‌دهند.
• /codex compact از Codex app-server می‌خواهد رشته متصل‌شده را فشرده کند.
• /codex review بازبینی بومی Codex را برای رشته متصل‌شده آغاز می‌کند.
• /codex diagnostics [note] پیش از ارسال بازخورد Codex برای رشته متصل‌شده تأیید می‌گیرد.
• /codex account وضعیت حساب و محدودیت نرخ را نمایش می‌دهد.
• /codex mcp وضعیت سرورهای MCP متعلق به Codex app-server را فهرست می‌کند.
• /codex skills مهارت‌های Codex app-server را فهرست می‌کند.
• /codex plugins list، ‏/codex plugins enable <name> و /codex plugins disable <name>، ‏Pluginهای بومی پیکربندی‌شده Codex را مدیریت می‌کنند.
• /codex computer-use [status|install] قابلیت Computer Use متعلق به Codex را مدیریت می‌کند.
• /codex help درخت کامل فرمان‌ها را فهرست می‌کند.

برای بیشتر گزارش‌های پشتیبانی، کار را با /diagnostics [note] در همان مکالمه‌ای آغاز کنید که اشکال در آن رخ داده است. این فرمان یک گزارش عیب‌یابی Gateway ایجاد می‌کند و برای نشست‌های مهار Codex، جهت ارسال بسته مرتبط بازخورد Codex تأیید می‌گیرد. برای مدل حریم خصوصی و رفتار گفت‌وگوی گروهی به برون‌بری عیب‌یابی مراجعه کنید. فقط زمانی از /codex diagnostics [note] استفاده کنید که مشخصاً می‌خواهید بازخورد Codex مربوط به رشته متصل‌شده فعلی، بدون بسته کامل عیب‌یابی Gateway بارگذاری شود.

بررسی محلی رشته‌های Codex

سریع‌ترین راه برای بررسی اجرای ناموفق Codex اغلب این است که رشته بومی Codex را مستقیماً باز کنید:

codex resume <thread-id>

شناسه رشته را از پاسخ تکمیل‌شده /diagnostics، ‏/codex binding یا /codex threads [filter] دریافت کنید.

برای سازوکار بارگذاری و مرزهای عیب‌یابی در سطح زمان اجرا، به زمان اجرای مهار Codex مراجعه کنید.

ترتیب احراز هویت

در خانه پیش‌فرض هر عامل، احراز هویت با این ترتیب انتخاب می‌شود:

1. پروفایل‌های مرتب‌شده احراز هویت OpenAI برای عامل، ترجیحاً زیر auth.order.openai. برای مهاجرت شناسه‌های قدیمی پروفایل احراز هویت Codex و ترتیب قدیمی احراز هویت Codex، ‏openclaw doctor --fix را اجرا کنید.
2. حساب موجود app-server در خانه Codex آن عامل.
3. فقط برای راه‌اندازی‌های محلی stdio app-server، ابتدا CODEX_API_KEY و سپس OPENAI_API_KEY، زمانی که هیچ حساب app-server موجود نیست و احراز هویت OpenAI همچنان لازم است.

وقتی OpenClaw یک پروفایل احراز هویت Codex از نوع اشتراک ChatGPT تشخیص می‌دهد، CODEX_API_KEY و OPENAI_API_KEY را از فرایند فرزند Codex که راه‌اندازی شده است حذف می‌کند. این کار کلیدهای API در سطح Gateway را برای تعبیه‌ها یا مدل‌های مستقیم OpenAI در دسترس نگه می‌دارد، بدون آنکه نوبت‌های بومی Codex app-server به‌اشتباه از طریق API صورتحساب شوند. پروفایل‌های صریح کلید API ‏Codex و بازگشت به کلید محیطی stdio محلی، به‌جای محیط به‌ارث‌رسیده فرایند فرزند از ورود app-server استفاده می‌کنند. اتصال‌های WebSocket به app-server کلید API محیطی جایگزین Gateway را دریافت نمی‌کنند؛ از یک پروفایل احراز هویت صریح یا حساب خود app-server راه‌دور استفاده کنید.

اگر یک پروفایل اشتراکی به محدودیت استفاده Codex برسد، OpenClaw در صورت گزارش زمان بازنشانی توسط Codex آن را ثبت می‌کند و برای همان اجرای Codex، پروفایل احراز هویت مرتب‌شده بعدی را امتحان می‌کند. پس از گذشت زمان بازنشانی، پروفایل اشتراکی بدون تغییر مدل منتخب openai/gpt-* یا زمان اجرای Codex دوباره واجد شرایط می‌شود.

وقتی Pluginهای بومی Codex پیکربندی شده باشند، OpenClaw پیش از ارائه اپ‌های متعلق به Plugin به رشته Codex، آن Pluginها را از طریق app-server متصل نصب یا تازه‌سازی می‌کند. app/list همچنان منبع حقیقت برای شناسه‌های اپ، دسترس‌پذیری و فراداده است، اما تصمیم فعال‌سازی در هر رشته بر عهده OpenClaw است: اگر خط‌مشی یک اپ دسترس‌پذیر فهرست‌شده را مجاز بداند، OpenClaw حتی زمانی که app/list در حال حاضر آن اپ را غیرفعال گزارش می‌کند، thread/start.config.apps[appId].enabled = true را ارسال می‌کند. این مسیر برای شناسه‌های ناشناخته نصب اپ ابداع نمی‌کند؛ OpenClaw فقط Pluginهای بازارگاه را با plugin/install فعال و سپس موجودی را تازه‌سازی می‌کند.

جداسازی محیط

برای راه‌اندازی‌های محلی stdio app-server، ‏OpenClaw مقدار CODEX_HOME را روی یک پوشه مختص هر عامل تنظیم می‌کند تا پیکربندی Codex، فایل‌های احراز هویت/حساب، حافظه نهان/داده Plugin و وضعیت بومی رشته‌ها به‌طور پیش‌فرض ~/.codex شخصی اپراتور را نخوانند یا در آن ننویسند. OpenClaw مقدار عادی فرایند HOME را حفظ می‌کند؛ زیرفرایندهای اجرای Codex همچنان می‌توانند پیکربندی و توکن‌های خانه کاربر را پیدا کنند و Codex ممکن است ورودی‌های مشترک $HOME/.agents/skills و $HOME/.agents/plugins/marketplace.json را کشف کند. با appServer.homeScope: "user"، ‏OpenClaw به‌جای آن از خانه بومی Codex کاربر و حساب موجود آن استفاده می‌کند، بدون اینکه پروفایل احراز هویت OpenClaw را تزریق کند.

اگر استقرار به جداسازی محیطی بیشتری نیاز دارد، آن متغیرها را به appServer.clearEnv اضافه کنید:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],          },        },      },    },  },}

appServer.clearEnv فقط بر فرایند فرزند Codex app-server که راه‌اندازی می‌شود اثر می‌گذارد. OpenClaw هنگام نرمال‌سازی راه‌اندازی محلی، CODEX_HOME و HOME را از این فهرست حذف می‌کند: CODEX_HOME همچنان به محدوده عامل یا کاربر منتخب اشاره می‌کند و HOME به‌صورت ارثی باقی می‌ماند تا زیرفرایندها بتوانند از وضعیت عادی خانه کاربر استفاده کنند.

ابزارهای پویا و جست‌وجوی وب

بارگذاری ابزارهای پویای Codex به‌طور پیش‌فرض روی searchable است. OpenClaw معمولاً ابزارهای پویایی را که عملیات فضای کاری بومی Codex را تکرار می‌کنند، ارائه نمی‌دهد: read، ‏write، ‏edit، ‏apply_patch، ‏exec، ‏process، ‏update_plan، get_goal، ‏create_goal، ‏update_goal، ‏tool_call، ‏tool_describe، tool_search و tool_search_code. عملیات هدف در Codex بومی باقی می‌ماند، بنابراین OpenClaw یک مخزن هدف دوم را در نوبت‌های Codex نگاشت نمی‌کند. بیشتر ابزارهای باقی‌مانده یکپارچه‌سازی OpenClaw، مانند پیام‌رسانی، رسانه، Cron، مرورگر، Nodeها، Gateway و heartbeat_respond، از طریق جست‌وجوی ابزار Codex در فضای نام openclaw در دسترس‌اند و زمینه اولیه مدل را کوچک‌تر نگه می‌دارند. بازگشت محدود نوبت به پوسته، برای exec و process هنگامی که یک فهرست مجاز محدود، Code Mode بومی را غیرفعال می‌کند، استثناست؛ فهرست‌های مجاز زمان اجرا و codexDynamicToolsExclude همچنان اعمال می‌شوند.

ابزارهایی که با catalogMode: "direct-only" علامت‌گذاری شده‌اند، از جمله ابزار computer متعلق به OpenClaw، به‌جای آن از فضای نام openclaw_direct استفاده می‌کنند. Codex آن فضای نام را به‌عنوان DirectModelOnly در نظر می‌گیرد، بنابراین این ابزارها در رشته‌های عادی و مختص Code Mode مستقیماً برای مدل قابل‌مشاهده باقی می‌مانند و از فراخوانی‌های تو‌در‌توی Code Mode ‏tools.* عبور نمی‌کنند.

وقتی جست‌وجو فعال باشد و هیچ ارائه‌دهنده مدیریت‌شده‌ای انتخاب نشده باشد، جست‌وجوی وب به‌طور پیش‌فرض از ابزار میزبانی‌شده web_search متعلق به Codex استفاده می‌کند. جست‌وجوی میزبانی‌شده بومی و ابزار پویای مدیریت‌شده web_search متعلق به OpenClaw مانعةالجمع‌اند تا جست‌وجوی مدیریت‌شده نتواند محدودیت‌های دامنه بومی را دور بزند. وقتی جست‌وجوی میزبانی‌شده در دسترس نباشد، صریحاً غیرفعال شده باشد یا یک ارائه‌دهنده مدیریت‌شده منتخب جایگزین آن شود، OpenClaw از ابزار مدیریت‌شده استفاده می‌کند. OpenClaw افزونه مستقل web.run متعلق به Codex را غیرفعال نگه می‌دارد، زیرا ترافیک عملیاتی app-server فضای نام تعریف‌شده توسط کاربرِ web را رد می‌کند. tools.web.search.enabled: false هر دو مسیر را غیرفعال می‌کند؛ اجراهای فقط LLM با ابزارهای غیرفعال نیز همین کار را می‌کنند. Codex مقدار "cached" را یک ترجیح در نظر می‌گیرد و آن را برای نوبت‌های بدون محدودیت app-server به دسترسی خارجی زنده تبدیل می‌کند. وقتی allowedDomains بومی تنظیم شده باشد، بازگشت خودکار مدیریت‌شده به‌صورت بسته شکست می‌خورد تا فهرست مجاز دور زده نشود. تغییرات پایدار خط‌مشی مؤثر جست‌وجو، رشته Codex متصل را پیش از نوبت بعدی تعویض می‌کنند؛ محدودیت‌های گذرای هر نوبت از یک رشته محدود موقت استفاده می‌کنند و اتصال موجود را برای ازسرگیری بعدی حفظ می‌کنند.

sessions_yield، sessions_spawn و پاسخ‌های منبعی که فقط از ابزار پیام استفاده می‌کنند، مستقیم باقی می‌مانند، زیرا قراردادهای کنترل نوبت یا واگذاری هستند. راهنما همچنان spawn_agent بومی Codex را به‌عنوان سطح اصلی زیرعامل Codex ترجیح می‌دهد، درحالی‌که واگذاری صریح OpenClaw یا ACP همچنان مستقیماً از طریق sessions_spawn قابل فراخوانی است. در حالت کد Codex، نتایج ابزارهای پویای عمومی OpenClaw به‌جای اشیای JavaScript، متن JSON هستند؛ بنابراین نتایجی را که ظاهری شبیه JSON دارند، پیش از خواندن فیلدها تجزیه کنید. Codex همچنین فراخوانی‌های پویای تودرتو را به‌صورت ترتیبی اجرا می‌کند؛ به‌جای انتظار برای اینکه Promise.all آن‌ها را هم‌زمان راه‌اندازی کند، چندین فراخوانی sessions_spawn را در یک حلقه محدود ارسال کنید. فرزندانی که قبلاً پذیرفته شده‌اند، همچنان می‌توانند هنگام ارسال فراخوانی‌های بعدی هم‌پوشانی داشته باشند. برای مشاهده یک الگوی کامل، به Swarm مراجعه کنید. دستورالعمل‌های همکاری Heartbeat به Codex می‌گویند وقتی ابزار از قبل بارگذاری نشده است، پیش از پایان نوبت Heartbeat، heartbeat_respond را جست‌وجو کند.

codexDynamicToolsLoading: "direct" را فقط هنگام اتصال به یک app-server سفارشی Codex که نمی‌تواند ابزارهای پویای معوق را جست‌وجو کند، یا هنگام اشکال‌زدایی محموله کامل ابزار تنظیم کنید.

فیلدهای پیکربندی

فیلدهای سطح‌بالای پشتیبانی‌شده Plugin مربوط به Codex:

فیلدهای پشتیبانی‌شده appServer:

appServer.networkProxy صریح است، زیرا قرارداد sandbox در Codex را تغییر می‌دهد. وقتی فعال باشد، OpenClaw همچنین features.network_proxy.enabled و default_permissions را در پیکربندی رشته Codex تنظیم می‌کند تا پروفایل مجوز تولیدشده بتواند شبکه مدیریت‌شده Codex را راه‌اندازی کند. به‌طور پیش‌فرض، OpenClaw یک نام پروفایل openclaw-network-<fingerprint> مقاوم در برابر تداخل را از بدنه پروفایل تولید می‌کند؛ فقط زمانی از profileName استفاده کنید که یک نام محلی پایدار لازم باشد.

{  plugins: {    entries: {      codex: {        config: {          appServer: {            sandbox: "workspace-write",            networkProxy: {              enabled: true,              domains: {                "api.openai.com": "allow",                "blocked.example.com": "deny",              },              unixSockets: {                "/tmp/proxy.sock": "allow",                "/tmp/blocked.sock": "none",              },              allowUpstreamProxy: true,              proxyUrl: "http://127.0.0.1:3128",            },          },        },      },    },  },}

اگر زمان اجرای عادی app-server برابر با danger-full-access باشد، فعال‌کردن networkProxy برای پروفایل مجوز تولیدشده از دسترسی سیستم‌فایل به سبک workspace استفاده می‌کند: اعمال شبکه مدیریت‌شده Codex نوعی شبکه sandbox‌شده است، بنابراین یک پروفایل با دسترسی کامل از ترافیک خروجی محافظت نمی‌کند. ورودی‌های دامنه از allow یا deny استفاده می‌کنند؛ ورودی‌های سوکت Unix از مقادیر allow یا none در Codex استفاده می‌کنند.

مهلت‌های زمانی فراخوانی پویای ابزار

فراخوانی‌های پویای ابزار متعلق به OpenClaw مستقل از appServer.requestTimeoutMs محدود می‌شوند: درخواست‌های item/tool/call در Codex به‌طور پیش‌فرض از یک ناظر 90 ثانیه‌ای OpenClaw استفاده می‌کنند. آرگومان مثبت timeoutMs برای هر فراخوانی، بودجه همان ابزار را افزایش یا کاهش می‌دهد و حداکثر آن 600000 ms است. ابزار image_generate وقتی فراخوانی ابزار مهلت زمانی خودش را ارائه نکند، از agents.defaults.mediaModels.image.timeoutMs استفاده می‌کند؛ در غیر این صورت، از مقدار پیش‌فرض 120 ثانیه‌ای تولید تصویر استفاده می‌شود. ابزار image برای درک رسانه از timeoutSeconds ورودی tools.media.models[] انتخاب‌شده و دارای قابلیت تصویر، یا مقدار پیش‌فرض رسانه‌ای 60 ثانیه‌ای آن استفاده می‌کند؛ برای درک تصویر، این مهلت زمانی بر خود درخواست اعمال می‌شود و به‌دلیل کارهای آماده‌سازی قبلی کاهش نمی‌یابد. هنگام پایان مهلت، OpenClaw در صورت پشتیبانی سیگنال ابزار را لغو می‌کند و یک پاسخ ناموفق ابزار پویا به Codex برمی‌گرداند تا نوبت بتواند ادامه پیدا کند و نشست در processing باقی نماند. این ناظر، بودجه بیرونی item/tool/call پویا است؛ مهلت‌های زمانی درخواست مختص ارائه‌دهنده درون آن فراخوانی اجرا می‌شوند و معنای مهلت زمانی خود را حفظ می‌کنند.

پس از اینکه Codex یک نوبت را می‌پذیرد، و پس از اینکه OpenClaw به یک درخواست app-server محدود به نوبت پاسخ می‌دهد، مهارکننده انتظار دارد Codex در نوبت جاری پیشرفت کند و در نهایت نوبت بومی را با turn/completed پایان دهد. اگر app-server به‌مدت appServer.turnCompletionIdleTimeoutMs ساکت بماند، OpenClaw تا حد امکان نوبت Codex را قطع می‌کند، یک پایان مهلت تشخیصی ثبت می‌کند و مسیر نشست OpenClaw را آزاد می‌کند تا پیام‌های گفت‌وگوی بعدی پشت یک نوبت بومی منقضی‌شده در صف نمانند. بیشتر اعلان‌های غیرنهایی برای همان نوبت، این ناظر کوتاه را غیرفعال می‌کنند، زیرا Codex ثابت کرده است که نوبت همچنان فعال است.

واگذاری‌های ابزار از بودجه بیکاری طولانی‌تری پس از ابزار استفاده می‌کنند: پس از اینکه OpenClaw یک پاسخ item/tool/call برمی‌گرداند، پس از تکمیل موارد ابزار بومی مانند commandExecution، پس از تکمیل‌های خام custom_tool_call_output، و پس از پیشرفت خام دستیار بعد از ابزار، تکمیل‌های استدلال خام، یا پیشرفت استدلال. این محافظ در صورت پیکربندی از appServer.postToolRawAssistantCompletionIdleTimeoutMs استفاده می‌کند و در غیر این صورت مقدار پیش‌فرض آن پنج دقیقه است؛ همین بودجه همچنین ناظر پیشرفت را برای پنجره ترکیب خاموش، پیش از انتشار رویداد بعدی نوبت جاری توسط Codex، تمدید می‌کند. اعلان‌های سراسری app-server، مانند به‌روزرسانی‌های محدودیت نرخ، پیشرفت بیکاری نوبت را بازنشانی نمی‌کنند. تکمیل‌های استدلال، تکمیل‌های agentMessage توضیحی، و پیشرفت خام استدلال یا دستیار پیش از ابزار ممکن است با یک پاسخ نهایی خودکار دنبال شوند، بنابراین به‌جای آزادکردن فوری مسیر نشست، از محافظ پاسخ پس از پیشرفت استفاده می‌کنند.

فقط موارد agentMessage تکمیل‌شده نهایی/غیرتوضیحی و تکمیل‌های خام دستیار پیش از ابزار، آزادسازی خروجی دستیار را فعال می‌کنند: اگر Codex سپس بدون turn/completed ساکت شود، OpenClaw تا حد امکان نوبت بومی را قطع و مسیر نشست را آزاد می‌کند. اگر ناظر نوبت دیگری در رقابت این آزادسازی پیروز شود، OpenClaw همچنان مورد نهایی تکمیل‌شده دستیار را زمانی می‌پذیرد که دیگر هیچ درخواست بومی، مورد، یا تکمیل ابزار پویایی فعال نباشد و آزادسازی خروجی دستیار همچنان متعلق به آخرین مورد تکمیل‌شده باشد، بدون تکمیل موردی پس از آن. این کار می‌تواند پاسخ نهایی را پس از کار تکمیل‌شده ابزار، بدون اجرای مجدد نوبت، حفظ کند. دلتاهای جزئی دستیار، پاسخ‌های قدیمی پیشین، و تکمیل‌های خالی بعدی واجد شرایط نیستند.

خرابی‌های قابل‌اجرای مجدد و ایمن app-server مبتنی بر stdio، از جمله پایان مهلت بیکاری تکمیل نوبت بدون شواهد دستیار، ابزار، مورد فعال، یا اثر جانبی، یک‌بار در تلاش تازه app-server دوباره امتحان می‌شوند. پایان مهلت‌های ناامن همچنان کلاینت گیرکرده app-server را کنار می‌گذارند و مسیر نشست OpenClaw را آزاد می‌کنند؛ آن‌ها همچنین به‌جای اجرای مجدد خودکار، اتصال قدیمی رشته بومی را پاک می‌کنند. پایان مهلت‌های ناظر تکمیل، متن مهلت زمانی مختص Codex را نمایش می‌دهند: موارد ایمن برای اجرای مجدد می‌گویند پاسخ ممکن است ناقص باشد، درحالی‌که موارد ناامن به کاربر می‌گویند پیش از تلاش مجدد، وضعیت فعلی را بررسی کند. عیب‌یابی‌های عمومی مهلت زمانی شامل فیلدهای ساختاری مانند آخرین متد اعلان app-server، شناسه/نوع/نقش مورد پاسخ خام دستیار، تعداد درخواست‌ها/موارد فعال، و وضعیت ناظر فعال‌شده هستند؛ وقتی آخرین اعلان یک مورد پاسخ خام دستیار باشد، همچنین شامل پیش‌نمایش محدودی از متن دستیار می‌شوند. آن‌ها شامل محتوای خام پرامپت یا ابزار نیستند.

بازنویسی‌های محیطی برای آزمایش محلی

• OPENCLAW_CODEX_APP_SERVER_BIN هنگامی که appServer.command تنظیم نشده باشد، باینری مدیریت‌شده را دور می‌زند.
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1 حذف شده است. به‌جای آن از plugins.entries.codex.config.appServer.mode: "guardian"، یا برای آزمایش محلی یک‌باره از OPENCLAW_CODEX_APP_SERVER_MODE=guardian استفاده کنید. برای استقرارهای تکرارپذیر، پیکربندی ترجیح داده می‌شود، زیرا رفتار Plugin را در همان فایل بازبینی‌شده‌ای نگه می‌دارد که سایر تنظیمات مهارکننده Codex در آن قرار دارند.

Pluginهای بومی Codex

پشتیبانی از Plugin بومی Codex از قابلیت‌های app و Plugin خود app-server در Codex، در همان رشته Codex مربوط به نوبت مهارکننده OpenClaw استفاده می‌کند. OpenClaw Pluginهای Codex را به ابزارهای پویای مصنوعی codex_plugin_* در OpenClaw تبدیل نمی‌کند.

codexPlugins فقط بر نشست‌هایی اثر می‌گذارد که مهارکننده بومی Codex را انتخاب می‌کنند. این گزینه بر اجرای مهارکننده داخلی، اجرای عادی ارائه‌دهنده OpenAI، اتصال‌های مکالمه ACP، یا سایر مهارکننده‌ها اثری ندارد.

پیکربندی حداقلی منتقل‌شده:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            allow_destructive_actions: true,            plugins: {              "google-calendar": {                enabled: true,                marketplaceName: "openai-curated",                pluginName: "google-calendar",              },            },          },        },      },    },  },}

پیکربندی app رشته زمانی محاسبه می‌شود که OpenClaw یک نشست مهارکننده Codex ایجاد می‌کند یا اتصال قدیمی رشته Codex را جایگزین می‌کند؛ این پیکربندی در هر نوبت دوباره محاسبه نمی‌شود. پس از تغییر codexPlugins، از /new یا /reset استفاده کنید، یا Gateway را راه‌اندازی مجدد کنید تا نشست‌های آینده مهارکننده Codex با مجموعه app به‌روزشده آغاز شوند.

برای شرایط لازم انتقال، موجودی app، سیاست اقدام مخرب، درخواست‌های تکمیلی و عیب‌یابی Plugin بومی، به Pluginهای بومی Codex مراجعه کنید.

دسترسی app و Plugin در سمت OpenAI توسط حساب واردشده Codex و برای workspaceهای Business و Enterprise/Edu، توسط کنترل‌های app در workspace کنترل می‌شود. برای مرور کلی حساب و کنترل workspace در OpenAI، به استفاده از Codex با طرح ChatGPT خود مراجعه کنید.

استفاده از رایانه

استفاده از رایانه راهنمای راه‌اندازی خاص خود را دارد: استفاده Codex از رایانه.

نسخه کوتاه: OpenClaw برنامه کنترل دسکتاپ را همراه خود ارائه نمی‌کند و خودش اقدامات دسکتاپ را اجرا نمی‌کند. app-server در Codex را آماده می‌کند، بررسی می‌کند که سرور MCP با نام computer-use در دسترس باشد، و سپس اجازه می‌دهد Codex در طول نوبت‌های حالت Codex مالک فراخوانی‌های ابزار بومی MCP باشد.

مرزهای زمان اجرا

مهارکننده Codex فقط اجراکننده سطح پایین عامل تعبیه‌شده را تغییر می‌دهد.

• ابزارهای پویای OpenClaw پشتیبانی می‌شوند. Codex از OpenClaw می‌خواهد آن ابزارها را اجرا کند، بنابراین OpenClaw در مسیر اجرا باقی می‌ماند.
• ابزارهای shell، patch، MCP و app بومی Codex متعلق به Codex هستند. OpenClaw می‌تواند از طریق رله پشتیبانی‌شده، رویدادهای بومی منتخب را مشاهده یا مسدود کند، اما آرگومان‌های ابزار بومی را بازنویسی نمی‌کند.
• Codex مالک Compaction بومی است. OpenClaw یک نسخه آینه‌ای از رونوشت را برای تاریخچه کانال، جست‌وجو، /new، /reset، و تغییر مدل یا مهارکننده در آینده نگه می‌دارد، اما Compaction در Codex را با خلاصه‌ساز OpenClaw یا موتور زمینه جایگزین نمی‌کند.
• تولید رسانه، درک رسانه، TTS، تأییدها و خروجی ابزار پیام‌رسانی همچنان از تنظیمات ارائه‌دهنده/مدل متناظر OpenClaw عبور می‌کنند.
• tool_result_persist بر نتایج ابزار رونوشت متعلق به OpenClaw اعمال می‌شود، نه رکوردهای نتیجه ابزار بومی Codex.

برای لایه‌های hook، سطوح V1 پشتیبانی‌شده، مدیریت مجوز بومی، هدایت صف، سازوکارهای بارگذاری بازخورد Codex و جزئیات Compaction، به زمان اجرای مهارکننده Codex مراجعه کنید.

عیب‌یابی

Codex به‌عنوان یک ارائه‌دهنده عادی /model ظاهر نمی‌شود: این رفتار برای پیکربندی‌های جدید مورد انتظار است. یک مدل openai/gpt-* را انتخاب کنید، plugins.entries.codex.enabled را فعال کنید و بررسی کنید آیا plugins.allow شامل codex نمی‌شود.

OpenClaw به‌جای Codex از مهارکننده داخلی استفاده می‌کند: تأیید کنید که مسیر مؤثر دقیقاً یک مسیر رسمی HTTPS از نوع Platform Responses یا ChatGPT Responses است، هیچ بازنویسی درخواست تعریف‌شده‌ای ندارد، و Plugin مربوط به Codex نصب و فعال است. پیشوند openai/gpt-* به‌تنهایی کافی نیست. برای اثبات دقیق هنگام آزمایش، agentRuntime.id: "codex" ارائه‌دهنده یا مدل را تنظیم کنید؛ Codex اجباری وقتی مسیر یا مهارکننده ناسازگار باشد، به‌جای بازگشت به مسیر جایگزین شکست می‌خورد.

زمان اجرای OpenAI Codex به مسیر کلید API بازمی‌گردد: یک گزیده ویرایش‌شده از Gateway جمع‌آوری کنید که مدل، زمان اجرا، ارائه‌دهنده انتخاب‌شده و خرابی را نشان دهد. از همکاران تحت‌تأثیر بخواهید این فرمان فقط‌خواندنی را روی میزبان OpenClaw خود اجرا کنند:

(  pattern='openai/gpt-5\.[45]|openai[-]codex|agentRuntime(\.id)?|harnessRuntime|Runtime: OpenAI Codex|legacy OpenAI Codex prefix|resolveSelectedOpenAIRuntimeProvider|candidateProvider[": ]+openai|status[": ]+401|Incorrect API key|No API key|api-key path|API-key path|OAuth'   if ls /tmp/openclaw/openclaw-*.log >/dev/null 2>&1; then    grep -E -i -n "$pattern" /tmp/openclaw/openclaw-*.log 2>/dev/null || true  else    journalctl --user -u openclaw-gateway --since today --no-pager 2>/dev/null \      | grep -E -i "$pattern" || true  fi) | sed -E \    -e 's/(Authorization: Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \    -e 's/(Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \    -e 's/(api[_ -]?key[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \    -e 's/(OPENAI_API_KEY[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \    -e 's/sk-[A-Za-z0-9_-]{12,}/sk-[REDACTED]/g' \    -e 's/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/[EMAIL-REDACTED]/g' \  | tail -200

گزیده‌های مفید معمولاً شامل openai/gpt-5.6-sol یا openai/gpt-5.6-luna، Runtime: OpenAI Codex، agentRuntime.id یا harnessRuntime، candidateProvider: "openai"، و یک نتیجه 401، Incorrect API key، یا No API key هستند. اجرای اصلاح‌شده باید به‌جای یک خرابی ساده کلید API در OpenAI، مسیر OAuth در OpenAI را نشان دهد.

پیکربندی ارجاع‌های قدیمی مدل Codex همچنان باقی است: openclaw doctor --fix را اجرا کنید. Doctor ارجاع‌های قدیمی مدل را به openai/* بازنویسی می‌کند، پین‌های منسوخ زمان اجرای نشست و کل عامل را حذف می‌کند و بازنویسی‌های موجود نمایه احراز هویت را حفظ می‌کند.

app-server رد می‌شود: از یک Codex app-server پایدار از 0.143.0 از طریق 0.145.0 همراه‌شده استفاده کنید. نسخه‌های پیش‌انتشار، نسخه‌های دارای پسوند ساخت و انتشارهای جدیدترِ اعتبارسنجی‌نشده رد می‌شوند، زیرا OpenClaw شِماهای تولیدشده را در برابر نسخه app-server همراه‌شده اعتبارسنجی می‌کند.

/codex status نمی‌تواند متصل شود: بررسی کنید Plugin codex فعال باشد، هنگام پیکربندی فهرست مجاز، plugins.allow آن را شامل شود و هرگونه appServer.command، url، authToken سفارشی یا هدرها معتبر باشند.

Codex app-server از حافظه بیش‌ازحد استفاده می‌کند: ابتدا دو فرایند را از هم تفکیک کنید. OpenClaw، Codex app-server محلی را به‌عنوان یک فرایند فرزند Rust جداگانه اجرا می‌کند. NODE_OPTIONS=--max-old-space-size=... فقط هیپ V8 در Node.js مربوط به Gateway را تغییر می‌دهد؛ Codex را محدود یا بزرگ‌تر نمی‌کند. نصب‌های مدیریت‌شده Gateway از قبل یک هیپ تطبیقی V8 انتخاب می‌کنند و افزایش آن می‌تواند حافظه میزبان کمتری برای Codex باقی بگذارد. برای فشار Gateway از عیب‌یابی حافظه Gateway استفاده کنید و حافظه میزبان یا کانتینر را برای فرایند فرزند Codex بررسی کنید.

Codex همراه‌شده هیچ محدودیت هیپ یا RSS و هیچ تأخیر قابل‌پیکربندی برای تخلیه هنگام بیکاری ندارد. پس از لغو اشتراک آخرین کلاینت، یک رشته غیرفعال می‌تواند تا 30 دقیقه بارگذاری‌شده باقی بماند. در میزبان‌های دارای منابع محدود، پیش از افزایش هیپ Gateway، گسترش هم‌زمان زیرعامل‌های بومی Codex را کاهش دهید:

{  plugins: {    entries: {      codex: {        config: {          appServer: {            args: ["-c", "agents.max_threads=3", "app-server", "--listen", "stdio://"],          },        },      },    },  },}

این تنظیم، رشته‌های فرزند بومی را برای بک‌اند چندعاملی پیش‌فرض Codex همراه‌شده محدود می‌کند. اگر چندعاملی v2 در Codex را صریحاً فعال کرده‌اید، به‌جای آن از features.multi_agent_v2.max_concurrent_threads_per_session=3 استفاده کنید؛ محدودیت v2 شامل رشته ریشه است و نمی‌توان آن را با agents.max_threads ترکیب کرد. برای فراهم‌کردن فضای بیشتر برای Codex، تخصیص حافظه میزبان، کانتینر یا cgroup را افزایش دهید. یک محدودیت سخت سیستم‌عامل ممکن است Codex را خاتمه دهد، نه اینکه بر آن فشار برگشتی اعمال کند.

کشف مدل کند است: مقدار plugins.entries.codex.config.discovery.timeoutMs را کاهش دهید یا کشف را غیرفعال کنید. به مرجع هارنس Codex مراجعه کنید.

انتقال WebSocket بلافاصله شکست می‌خورد: appServer.url، authToken و هدرها را بررسی کنید و مطمئن شوید app-server راه‌دور از همان نسخه پروتکل Codex app-server استفاده می‌کند. انتقال WebSocket در Codex همچنان آزمایشی و پشتیبانی‌نشده است؛ stdio مدیریت‌شده یا سوکت کنترل محلی Unix را ترجیح دهید.

ابزارهای بومی پوسته یا وصله با Native hook relay unavailable مسدود شده‌اند: رشته Codex همچنان می‌کوشد از شناسه رله قلاب بومی‌ای استفاده کند که دیگر در OpenClaw ثبت نشده است. این مشکل انتقال قلاب بومی Codex است، نه خرابی بک‌اند ACP، ارائه‌دهنده، GitHub یا فرمان پوسته. با /new یا /reset یک نشست تازه در گفت‌وگوی تحت‌تأثیر آغاز کنید، سپس یک فرمان بی‌ضرر را دوباره امتحان کنید. اگر یک بار کار کرد اما فراخوانی بعدی ابزار بومی دوباره شکست خورد، /new را فقط یک راه‌حل موقت در نظر بگیرید: پس از راه‌اندازی مجدد Codex app-server یا OpenClaw Gateway، پرامپت را در یک نشست تازه کپی کنید تا رشته‌های قدیمی حذف شوند و ثبت‌های قلاب بومی دوباره ایجاد شوند.

فراخوانی ابزارهای Codex فرایندهای قلاب کوتاه‌عمر بیش‌ازحدی ایجاد می‌کنند: مقدار plugins.entries.codex.config.appServer.loopDetectionPreToolUseRelay: false را تنظیم و Gateway را راه‌اندازی مجدد کنید. این کار فقط زیرفرایند PreToolUse در Codex را که برای تشخیص حلقه OpenClaw و نشانگر بدون‌سیاست آن استفاده می‌شود، غیرفعال می‌کند. رله‌های الزامی before_tool_call و سیاست ابزار مورداعتماد همچنان فعال می‌مانند.

یک مدل غیر Codex از هارنس داخلی استفاده می‌کند: این رفتار مورد انتظار است، مگر اینکه سیاست زمان اجرای ارائه‌دهنده یا مدل آن را به هارنس دیگری هدایت کند. ارجاع‌های ساده ارائه‌دهنده غیر OpenAI در حالت auto در مسیر عادی ارائه‌دهنده خود باقی می‌مانند.

Computer Use نصب شده است اما ابزارها اجرا نمی‌شوند: در یک نشست تازه، /codex computer-use status را بررسی کنید. اگر ابزاری Native hook relay unavailable را گزارش کرد، از روش بازیابی رله قلاب بومی در بالا استفاده کنید. به Computer Use در Codex مراجعه کنید.

مرتبط

• مرجع هارنس Codex
• زمان اجرای هارنس Codex
• نظارت Codex
• Pluginهای بومی Codex
• Computer Use در Codex
• زمان‌های اجرای عامل
• ارائه‌دهندگان مدل
• ارائه‌دهنده OpenAI
• راهنمای OpenAI Codex
• Pluginهای هارنس عامل
• قلاب‌های Plugin
• برون‌بری اطلاعات عیب‌یابی
• وضعیت
• آزمایش