Agent coordination

وكلاء ACP

جلسات Agent Client Protocol (ACP) تتيح لـ OpenClaw تشغيل حِزَم ترميز خارجية (مثل Claude Code وCursor وCopilot وDroid وOpenClaw ACP وOpenCode وGemini CLI وغيرها من حِزَم ACPX المدعومة) عبر Plugin خلفية ACP.

يُتتبّع كل إنشاء لجلسة ACP بوصفه مهمة خلفية.

أي صفحة أريد؟

تريد أن…	استخدم هذا	ملاحظات
ربط Codex أو التحكم به في المحادثة الحالية	`/codex bind`, `/codex threads`	مسار خادم التطبيق الأصلي لـ Codex عندما يكون Plugin `codex` مفعّلاً؛ يتضمن ردود الدردشة المرتبطة، وتمرير الصور، والنموذج/السريع/الأذونات، والإيقاف، وعناصر التحكم في التوجيه. ACP بديل صريح
تشغيل Claude Code أو Gemini CLI أو Codex ACP صريح أو حِزمة خارجية أخرى عبر OpenClaw	هذه الصفحة	جلسات مرتبطة بالدردشة، و`/acp spawn`، و`sessions_spawn({ runtime: "acp" })`، ومهام خلفية، وعناصر تحكم وقت التشغيل
كشف جلسة OpenClaw Gateway كخادم ACP لمحرر أو عميل	`openclaw acp`	وضع الجسر. يتحدث IDE/العميل ACP إلى OpenClaw عبر stdio/WebSocket
إعادة استخدام CLI ذكاء اصطناعي محلي كنموذج احتياطي نصي فقط	خلفيات CLI	ليس ACP. لا أدوات OpenClaw، ولا عناصر تحكم ACP، ولا وقت تشغيل للحِزمة

هل يعمل هذا مباشرةً؟

نعم، بعد تثبيت Plugin وقت تشغيل ACP الرسمي:

bash

openclaw plugins install @openclaw/acpxopenclaw config set plugins.entries.acpx.enabled true

يمكن لنسخ المصدر استخدام Plugin مساحة العمل المحلي extensions/acpx بعد pnpm install. شغّل /acp doctor لإجراء فحص جاهزية.

لا يعلّم OpenClaw الوكلاء عن إنشاء ACP إلا عندما يكون ACP قابلاً للاستخدام فعلاً: يجب أن يكون ACP مفعّلاً، ويجب ألا يكون الإرسال معطلاً، ويجب ألا تكون الجلسة الحالية محظورة بصندوق الرمل، ويجب تحميل خلفية وقت تشغيل. إذا لم تتحقق هذه الشروط، تبقى Skills الخاصة بـ Plugin ACP وإرشادات ACP لـ sessions_spawn مخفية حتى لا يقترح الوكيل خلفية غير متاحة.

ملاحظات التشغيل الأول

إذا كان plugins.allow مضبوطاً، فهو مخزون plugins تقييدي ويجب أن يتضمن acpx؛ وإلا فسيُحظر backend ACP المثبّت عمداً وسيبلغ /acp doctor عن إدخال قائمة السماح المفقود.
يُجهّز محوّل Codex ACP مع Plugin acpx ويُشغّل محلياً عندما يكون ذلك ممكناً.
يعمل Codex ACP باستخدام CODEX_HOME معزول؛ ينسخ OpenClaw إدخالات المشاريع الموثوقة إضافةً إلى إعدادات آمنة لتوجيه النموذج/المزوّد من إعدادات Codex على المضيف، بينما تبقى المصادقة والإشعارات والخطافات على إعدادات المضيف.
قد يستمر جلب محوّلات الحِزَم المستهدفة الأخرى عند الطلب باستخدام npx في أول مرة تستخدمها.
يجب أن تكون مصادقة المورّد موجودة على المضيف لتلك الحِزمة.
إذا لم يكن لدى المضيف npm أو وصول إلى الشبكة، تفشل عمليات جلب المحوّل عند التشغيل الأول إلى أن تُمهّد الذاكرات المؤقتة مسبقاً أو يُثبّت المحوّل بطريقة أخرى.

متطلبات وقت التشغيل

يطلق ACP عملية حِزمة خارجية حقيقية. يملك OpenClaw التوجيه، وحالة المهام الخلفية، والتسليم، والارتباطات، والسياسة؛ بينما تملك الحِزمة تسجيل دخول المزوّد، وكتالوج النماذج، وسلوك نظام الملفات، والأدوات الأصلية.

قبل لوم OpenClaw، تحقق مما يلي:

يبلغ /acp doctor عن backend مفعّل وسليم.
معرّف الهدف مسموح به عبر acp.allowedAgents عندما تكون قائمة السماح هذه مضبوطة.
يمكن لأمر الحِزمة البدء على مضيف Gateway.
مصادقة المزوّد موجودة لتلك الحِزمة (claude, codex, gemini, opencode, droid, وغيرها).
النموذج المحدد موجود لتلك الحِزمة - معرّفات النماذج غير قابلة للنقل بين الحِزَم.
المسار cwd المطلوب موجود ويمكن الوصول إليه، أو احذف cwd ودع backend يستخدم الافتراضي الخاص به.
وضع الأذونات يطابق العمل. لا تستطيع الجلسات غير التفاعلية النقر على مطالبات الأذونات الأصلية، لذا تحتاج عمليات الترميز الكثيفة في الكتابة/التنفيذ عادةً إلى ملف تعريف أذونات ACPX يمكنه المتابعة دون واجهة.

لا تُكشف أدوات OpenClaw Plugin وأدوات OpenClaw المدمجة لحِزَم ACP افتراضياً. فعّل جسور MCP الصريحة في إعداد وكلاء ACP فقط عندما ينبغي للحِزمة استدعاء تلك الأدوات مباشرةً.

أهداف الحِزَم المدعومة

مع backend acpx، استخدم معرّفات الحِزَم هذه كأهداف /acp spawn <id> أو sessions_spawn({ runtime: "acp", agentId: "<id>" }):

معرّف الحِزمة	backend المعتاد	ملاحظات
`claude`	محوّل Claude Code ACP	يتطلب مصادقة Claude Code على المضيف.
`codex`	محوّل Codex ACP	بديل ACP صريح فقط عندما يكون `/codex` الأصلي غير متاح أو عندما يُطلب ACP.
`copilot`	محوّل GitHub Copilot ACP	يتطلب مصادقة Copilot CLI/وقت التشغيل.
`cursor`	Cursor CLI ACP (`cursor-agent acp`)	تجاوز أمر acpx إذا كان التثبيت المحلي يكشف نقطة دخول ACP مختلفة.
`droid`	Factory Droid CLI	يتطلب مصادقة Factory/Droid أو `FACTORY_API_KEY` في بيئة الحِزمة.
`gemini`	محوّل Gemini CLI ACP	يتطلب مصادقة Gemini CLI أو إعداد مفتاح API.
`iflow`	iFlow CLI	يعتمد توفر المحوّل والتحكم في النموذج على CLI المثبّت.
`kilocode`	Kilo Code CLI	يعتمد توفر المحوّل والتحكم في النموذج على CLI المثبّت.
`kimi`	Kimi/Moonshot CLI	يتطلب مصادقة Kimi/Moonshot على المضيف.
`kiro`	Kiro CLI	يعتمد توفر المحوّل والتحكم في النموذج على CLI المثبّت.
`opencode`	محوّل OpenCode ACP	يتطلب مصادقة OpenCode CLI/المزوّد.
`openclaw`	جسر OpenClaw Gateway عبر `openclaw acp`	يتيح لحِزمة واعية بـ ACP التحدث مرة أخرى إلى جلسة OpenClaw Gateway.
`qwen`	Qwen Code / Qwen CLI	يتطلب مصادقة متوافقة مع Qwen على المضيف.

يمكن تكوين ألقاب وكلاء acpx مخصصة في acpx نفسه، لكن سياسة OpenClaw لا تزال تتحقق من acp.allowedAgents وأي ربط agents.list[].runtime.acp.agent قبل الإرسال.

دليل تشغيل المشغّل

تدفق /acp سريع من الدردشة:

الإنشاء

/acp spawn claude --bind here, /acp spawn gemini --mode persistent --thread auto، أو /acp spawn codex --bind here صريح.

العمل

تابع في المحادثة أو السلسلة المرتبطة (أو استهدف مفتاح الجلسة صراحةً).

فحص الحالة

/acp status

الضبط

/acp model <provider/model>, /acp permissions <profile>, /acp timeout <seconds>.

التوجيه

دون استبدال السياق: /acp steer tighten logging and continue.

الإيقاف

/acp cancel (الدورة الحالية) أو /acp close (الجلسة + الارتباطات).

تفاصيل دورة الحياة

ينشئ Spawn جلسة وقت تشغيل ACP أو يستأنفها، ويسجل بيانات ACP الوصفية في مخزن جلسات OpenClaw، وقد ينشئ مهمة خلفية عندما يكون التشغيل مملوكاً للأصل.
تُعامل جلسات ACP المملوكة للأصل كعمل خلفي حتى عندما تكون جلسة وقت التشغيل مستمرة؛ يمر الإكمال والتسليم عبر الأسطح من خلال مُخطِر المهمة الأصلية بدلاً من التصرف كجلسة دردشة عادية موجهة للمستخدم.
تغلق صيانة المهام جلسات ACP ذات اللقطة الواحدة الطرفية أو اليتيمة المملوكة للأصل. تُحفظ جلسات ACP المستمرة ما دام هناك ارتباط محادثة نشط؛ وتُغلق الجلسات المستمرة القديمة التي لا تملك ارتباطاً نشطاً حتى لا يمكن استئنافها بصمت بعد انتهاء المهمة المالكة أو زوال سجل مهمتها.
تذهب رسائل المتابعة المرتبطة مباشرةً إلى جلسة ACP إلى أن يُغلق الارتباط أو يُزال تركيزه أو يُعاد ضبطه أو تنتهي صلاحيته.
تبقى أوامر Gateway محلية. لا تُرسل /acp ... و/status و/unfocus أبداً كنص مطالبة عادي إلى حِزمة ACP مرتبطة.
يجهض cancel الدورة النشطة عندما يدعم backend الإلغاء؛ ولا يحذف الارتباط أو بيانات الجلسة الوصفية.
ينهي close جلسة ACP من وجهة نظر OpenClaw ويزيل الارتباط. قد تستمر الحِزمة في الاحتفاظ بسجلها upstream الخاص إذا كانت تدعم الاستئناف.
ينظّف Plugin acpx أشجار عمليات الغلاف والمحوّل المملوكة لـ OpenClaw بعد close، ويحصد أيتام ACPX القدماء المملوكين لـ OpenClaw أثناء بدء Gateway.
عمال وقت التشغيل الخاملون مؤهلون للتنظيف بعد acp.runtime.ttlMinutes؛ وتبقى بيانات الجلسة الوصفية المخزنة متاحة لـ /acp sessions.

قواعد توجيه Codex الأصلية

محفزات اللغة الطبيعية التي ينبغي توجيهها إلى Plugin Codex الأصلي عندما يكون مفعّلاً:

"اربط قناة Discord هذه بـ Codex."
"أرفق هذه الدردشة بسلسلة Codex <id>."
"اعرض سلاسل Codex، ثم اربط هذه."

ربط محادثة Codex الأصلي هو مسار التحكم في الدردشة الافتراضي. لا تزال أدوات OpenClaw الديناميكية تُنفَّذ عبر OpenClaw، بينما تُنفَّذ أدوات Codex الأصلية مثل shell/apply-patch داخل Codex. بالنسبة إلى أحداث أدوات Codex الأصلية، يحقن OpenClaw مرحّل hook أصلي لكل دورة حتى تتمكن hooks الخاصة بالـ plugins من حظر before_tool_call، ومراقبة after_tool_call، وتوجيه أحداث Codex PermissionRequest عبر موافقات OpenClaw. تُرحَّل hooks الخاصة بـ Codex Stop إلى OpenClaw before_agent_finalize، حيث يمكن للـ plugins طلب مرور نموذج إضافي قبل أن ينهي Codex إجابته. يبقى المرحّل محافظًا عمدًا: فهو لا يغيّر وسيطات أدوات Codex الأصلية ولا يعيد كتابة سجلات سلاسل Codex. استخدم ACP الصريح فقط عندما تريد نموذج وقت تشغيل/جلسة ACP. حُدِّد حد دعم Codex المضمّن في عقد دعم Codex harness v1.

ورقة مختصرة لاختيار النموذج / المزوّد / وقت التشغيل

مراجع نماذج Codex القديمة - مسار نموذج OAuth/الاشتراك القديم الخاص بـ Codex الذي يصلحه doctor.
openai/* - وقت تشغيل خادم تطبيق Codex الأصلي المضمّن لدورات وكيل OpenAI.
/codex ... - التحكم الأصلي في محادثة Codex.
/acp ... أو runtime: "acp" - تحكم ACP/acpx صريح.

مشغلات اللغة الطبيعية لتوجيه ACP

المشغلات التي يجب أن تُوجَّه إلى وقت تشغيل ACP:

"شغّل هذا كجلسة Claude Code ACP لمرة واحدة ولخّص النتيجة."
"استخدم Gemini CLI لهذه المهمة في سلسلة، ثم أبقِ المتابعات في السلسلة نفسها."
"شغّل Codex عبر ACP في سلسلة خلفية."

يختار OpenClaw runtime: "acp"، ويحل harness agentId، ويرتبط بالمحادثة أو السلسلة الحالية عندما يكون ذلك مدعومًا، ثم يوجّه المتابعات إلى تلك الجلسة حتى الإغلاق/انتهاء الصلاحية. لا يتبع Codex هذا المسار إلا عندما يكون ACP/acpx صريحًا أو عندما لا يكون Plugin Codex الأصلي متاحًا للعملية المطلوبة.

بالنسبة إلى sessions_spawn، لا يُعلَن عن runtime: "acp" إلا عندما يكون ACP مفعّلًا، ولا يكون الطالب داخل sandbox، وتكون خلفية وقت تشغيل ACP محمّلة. يوقف acp.dispatch.enabled=false الإرسال التلقائي لسلاسل ACP لكنه لا يخفي أو يحظر استدعاءات sessions_spawn({ runtime: "acp" }) الصريحة. يستهدف معرّفات ACP harness مثل codex، أو claude، أو droid، أو gemini، أو opencode. لا تمرّر معرّف وكيل إعداد OpenClaw عاديًا من agents_list إلا إذا كان ذلك الإدخال مكوّنًا صراحةً باستخدام agents.list[].runtime.type="acp"؛ وإلا فاستخدم وقت تشغيل الوكيل الفرعي الافتراضي. عندما يكون وكيل OpenClaw مكوّنًا باستخدام runtime.type="acp"، يستخدم OpenClaw runtime.acp.agent كمعرّف harness الأساسي.

ACP مقابل الوكلاء الفرعيين

استخدم ACP عندما تريد وقت تشغيل harness خارجيًا. استخدم خادم تطبيق Codex الأصلي لربط/التحكم في محادثات Codex عندما يكون Plugin codex مفعّلًا. استخدم الوكلاء الفرعيين عندما تريد تشغيلات مفوّضة أصلية من OpenClaw.

المجال	جلسة ACP	تشغيل وكيل فرعي
وقت التشغيل	Plugin خلفية ACP (مثل acpx)	وقت تشغيل الوكيل الفرعي الأصلي في OpenClaw
مفتاح الجلسة	`agent:<agentId>:acp:<uuid>`	`agent:<agentId>:subagent:<uuid>`
الأوامر الرئيسية	`/acp ...`	`/subagents ...`
أداة الإنشاء	`sessions_spawn` مع `runtime:"acp"`	`sessions_spawn` (وقت التشغيل الافتراضي)

راجع أيضًا الوكلاء الفرعيون.

كيف يشغّل ACP ‏Claude Code

بالنسبة إلى Claude Code عبر ACP، تكون الحزمة:

مستوى التحكم في جلسة OpenClaw ACP.
Plugin وقت التشغيل الرسمي @openclaw/acpx.
محوّل Claude ACP.
آليات وقت التشغيل/الجلسة من جهة Claude.

ACP Claude هو جلسة harness مع عناصر تحكم ACP، واستئناف الجلسة، وتتبع المهام الخلفية، وربط اختياري للمحادثة/السلسلة.

خلفيات CLI هي أوقات تشغيل احتياطية محلية نصية فقط ومنفصلة - راجع خلفيات CLI.

بالنسبة إلى المشغّلين، القاعدة العملية هي:

تريد /acp spawn، أو جلسات قابلة للربط، أو عناصر تحكم وقت التشغيل، أو عمل harness مستمرًا؟ استخدم ACP.
تريد بديلًا نصيًا محليًا بسيطًا عبر CLI الخام؟ استخدم خلفيات CLI.

الجلسات المربوطة

النموذج الذهني

سطح الدردشة - المكان الذي يواصل فيه الأشخاص الحديث (قناة Discord، موضوع Telegram، دردشة iMessage).
جلسة ACP - حالة وقت تشغيل Codex/Claude/Gemini الدائمة التي يوجّه OpenClaw إليها.
السلسلة/الموضوع الفرعي - سطح مراسلة إضافي اختياري يُنشأ فقط بواسطة --thread ....
مساحة عمل وقت التشغيل - موقع نظام الملفات (cwd، أو checkout للمستودع، أو مساحة عمل الخلفية) حيث يعمل harness. مستقل عن سطح الدردشة.

ربط المحادثة الحالية

يثبّت /acp spawn <harness> --bind here المحادثة الحالية على جلسة ACP المنشأة - بلا سلسلة فرعية، وبسطح الدردشة نفسه. يظل OpenClaw مالكًا للنقل، والمصادقة، والسلامة، والتسليم. تُوجَّه رسائل المتابعة في تلك المحادثة إلى الجلسة نفسها؛ يعيد /new و/reset ضبط الجلسة في مكانها؛ ويزيل /acp close الربط.

أمثلة:

text

/codex bind                                              # native Codex bind, route future messages here/codex model gpt-5.4                                     # tune the bound native Codex thread/codex stop                                              # control the active native Codex turn/acp spawn codex --bind here                             # explicit ACP fallback for Codex/acp spawn codex --thread auto                           # may create a child thread/topic and bind there/acp spawn codex --bind here --cwd /workspace/repo       # same chat binding, Codex runs in /workspace/repo

قواعد الربط والحصرية

--bind here و--thread ... متنافيان.
لا يعمل --bind here إلا على القنوات التي تعلن دعم ربط المحادثة الحالية؛ وإلا يُرجع OpenClaw رسالة واضحة تفيد بعدم الدعم. تستمر الارتباطات عبر عمليات إعادة تشغيل Gateway.
على Discord، يتحكم spawnSessions في إنشاء السلاسل الفرعية لـ --thread auto|here - وليس --bind here.
إذا أنشأت جلسة إلى وكيل ACP مختلف دون --cwd، يرث OpenClaw مساحة عمل الوكيل الهدف افتراضيًا. المسارات الموروثة المفقودة (ENOENT/ENOTDIR) تعود إلى الإعداد الافتراضي للخلفية؛ وتظهر أخطاء الوصول الأخرى (مثل EACCES) كأخطاء إنشاء.
تبقى أوامر إدارة Gateway محلية في المحادثات المربوطة - تتولى OpenClaw أوامر /acp ... حتى عندما يُوجَّه نص المتابعة العادي إلى جلسة ACP المربوطة؛ كما يبقى /status و/unfocus محليين كلما كان التعامل مع الأوامر مفعّلًا لذلك السطح.

الجلسات المربوطة بالسلاسل

عندما تكون ارتباطات السلاسل مفعّلة لمحوّل قناة:

يربط OpenClaw سلسلة بجلسة ACP مستهدفة.
تُوجَّه رسائل المتابعة في تلك السلسلة إلى جلسة ACP المربوطة.
يُسلَّم خرج ACP إلى السلسلة نفسها.
يؤدي إلغاء التركيز/الإغلاق/الأرشفة/مهلة الخمول أو انتهاء الحد الأقصى للعمر إلى إزالة الربط.
/acp close، و/acp cancel، و/acp status، و/status، و/unfocus هي أوامر Gateway، وليست مطالبات إلى ACP harness.

علامات الميزات المطلوبة لـ ACP المربوط بالسلاسل:

acp.enabled=true
يكون acp.dispatch.enabled مفعّلًا افتراضيًا (عيّن false لإيقاف إرسال سلاسل ACP التلقائي مؤقتًا؛ وتظل استدعاءات sessions_spawn({ runtime: "acp" }) الصريحة تعمل).
إنشاء جلسات سلاسل محوّل القناة مفعّل (افتراضيًا: true):
- Discord: channels.discord.threadBindings.spawnSessions=true
- Telegram: channels.telegram.threadBindings.spawnSessions=true

دعم ربط السلاسل خاص بالمحوّل. إذا لم يكن محوّل القناة النشط يدعم ارتباطات السلاسل، يُرجع OpenClaw رسالة واضحة تفيد بأن ذلك غير مدعوم/غير متاح.

القنوات التي تدعم السلاسل

أي محوّل قناة يوفّر قدرة ربط الجلسات/السلاسل.
الدعم المضمّن الحالي: سلاسل/قنوات Discord، وموضوعات Telegram (موضوعات المنتدى في المجموعات/المجموعات الفائقة وموضوعات الرسائل المباشرة).
يمكن لقنوات Plugin إضافة الدعم عبر واجهة الربط نفسها.

ارتباطات القنوات الدائمة

للمهام غير المؤقتة، كوّن ارتباطات ACP الدائمة في إدخالات bindings[] ذات المستوى الأعلى.

نموذج الربط

bindings[].type"acp"

يحدد ربط محادثة ACP دائمًا.

bindings[].matchobject

يحدد المحادثة الهدف. الأشكال حسب القناة:

قناة/سلسلة Discord: match.channel="discord" + match.peer.id="<channelOrThreadId>"
قناة/رسالة مباشرة Slack: match.channel="slack" + match.peer.id="<channelId|channel:<channelId>|#<channelId>|userId|user:<userId>|slack:<userId>|<@userId>>". فضّل معرّفات Slack الثابتة؛ كما تطابق ارتباطات القنوات الردود داخل سلاسل تلك القناة.
موضوع منتدى Telegram: match.channel="telegram" + match.peer.id="<chatId>:topic:<topicId>"
رسالة مباشرة/مجموعة WhatsApp: match.channel="whatsapp" + match.peer.id="<E.164|group JID>". استخدم أرقام E.164 مثل +15555550123 للدردشات المباشرة وWhatsApp group JIDs مثل 120363424282127706@g.us للمجموعات.
رسالة مباشرة/مجموعة iMessage: match.channel="imessage" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>". فضّل chat_id:* لارتباطات المجموعات الثابتة.

bindings[].agentIdstring

معرّف وكيل OpenClaw المالك.

bindings[].acp.mode"persistent" | "oneshot"

تجاوز ACP اختياري.

bindings[].acp.labelstring

تسمية اختيارية موجّهة للمشغّل.

bindings[].acp.cwdstring

دليل عمل اختياري لوقت التشغيل.

bindings[].acp.backendstring

تجاوز خلفية اختياري.

الإعدادات الافتراضية لوقت التشغيل لكل وكيل

استخدم agents.list[].runtime لتعريف إعدادات ACP الافتراضية مرة واحدة لكل وكيل:

agents.list[].runtime.type="acp"
agents.list[].runtime.acp.agent (معرّف harness، مثل codex أو claude)
agents.list[].runtime.acp.backend
agents.list[].runtime.acp.mode
agents.list[].runtime.acp.cwd

أسبقية التجاوز لجلسات ACP المربوطة:

bindings[].acp.*
agents.list[].runtime.acp.*
إعدادات ACP العامة الافتراضية (مثل acp.backend)

مثال

json5

{  agents: {    list: [      {        id: "codex",        runtime: {          type: "acp",          acp: {            agent: "codex",            backend: "acpx",            mode: "persistent",            cwd: "/workspace/openclaw",          },        },      },      {        id: "claude",        runtime: {          type: "acp",          acp: { agent: "claude", backend: "acpx", mode: "persistent" },        },      },    ],  },  bindings: [    {      type: "acp",      agentId: "codex",      match: {        channel: "discord",        accountId: "default",        peer: { kind: "channel", id: "222222222222222222" },      },      acp: { label: "codex-main" },    },    {      type: "acp",      agentId: "claude",      match: {        channel: "telegram",        accountId: "default",        peer: { kind: "group", id: "-1001234567890:topic:42" },      },      acp: { cwd: "/workspace/repo-b" },    },    {      type: "route",      agentId: "main",      match: { channel: "discord", accountId: "default" },    },    {      type: "route",      agentId: "main",      match: { channel: "telegram", accountId: "default" },    },  ],  channels: {    discord: {      guilds: {        "111111111111111111": {          channels: {            "222222222222222222": { requireMention: false },          },        },      },    },    telegram: {      groups: {        "-1001234567890": {          topics: { "42": { requireMention: false } },        },      },    },  },}

السلوك

يضمن OpenClaw وجود جلسة ACP المكوّنة بعد القبول الخاص بالقناة وقبل الاستخدام.
تُوجَّه الرسائل في تلك القناة أو الموضوع أو المحادثة إلى جلسة ACP المكوّنة.
تملك ارتباطات ACP المكوّنة مسار جلستها. ولا يستبدل التوزيع المتشعب لبث القناة جلسة ACP المكوّنة لارتباط مطابق.
في المحادثات المرتبطة، يعيد /new و/reset تعيين مفتاح جلسة ACP نفسه في مكانه.
تظل ارتباطات وقت التشغيل المؤقتة، مثل تلك التي تنشئها تدفقات التركيز على السلاسل، مطبقة حيثما وُجدت.
عند إنشاء ACP عابر للوكلاء من دون cwd صريح، يرث OpenClaw مساحة عمل الوكيل الهدف من إعدادات الوكيل.
تعود مسارات مساحة العمل الموروثة المفقودة إلى cwd الافتراضي للخلفية؛ وتظهر إخفاقات الوصول غير المفقودة كأخطاء إنشاء.

بدء جلسات ACP

طريقتان لبدء جلسة ACP:

From sessions_spawn

استخدم runtime: "acp" لبدء جلسة ACP من دور وكيل أو استدعاء أداة.

json

{  "task": "Open the repo and summarize failing tests",  "runtime": "acp",  "agentId": "codex",  "thread": true,  "mode": "session"}

From /acp command

استخدم /acp spawn للتحكم الصريح من المشغّل عبر المحادثة.

text

/acp spawn codex --mode persistent --thread auto/acp spawn codex --mode oneshot --thread off/acp spawn codex --bind here/acp spawn codex --thread here

الخيارات الأساسية:

--mode persistent|oneshot
--bind here|off
--thread auto|here|off
--cwd <absolute-path>
--label <name>

راجع أوامر الشرطة المائلة.

معلمات `sessions_spawn`

taskstringrequired

الموجّه الأولي المرسل إلى جلسة ACP.

runtime"acp"required

يجب أن تكون "acp" لجلسات ACP.

agentIdstring

معرّف إطار تشغيل ACP الهدف. يعود إلى acp.defaultAgent إذا كان مضبوطًا.

threadbooleandefault: false

اطلب تدفق ارتباط بالسلسلة حيث يكون ذلك مدعومًا.

mode"run" | "session"default: run

"run" تشغيل لمرة واحدة؛ و"session" مستمرة. إذا كان thread: true و حُذف mode، فقد يختار OpenClaw افتراضيًا السلوك المستمر بحسب مسار وقت التشغيل. يتطلب mode: "session" وجود thread: true.

cwdstring

دليل العمل المطلوب لوقت التشغيل، ويُتحقق منه وفق سياسة الخلفية/وقت التشغيل. إذا حُذف، يرث إنشاء ACP مساحة عمل الوكيل الهدف عند تهيئتها؛ وتعود المسارات الموروثة المفقودة إلى الإعدادات الافتراضية للخلفية، بينما تُعاد أخطاء الوصول الحقيقية.

labelstring

تسمية موجهة للمشغّل تُستخدم في نص الجلسة/الشعار.

resumeSessionIdstring

استأنف جلسة ACP موجودة بدلًا من إنشاء جلسة جديدة. يعيد الوكيل تشغيل سجل محادثته عبر session/load. يتطلب runtime: "acp".

streamTo"parent"

يبث "parent" ملخصات تقدم تشغيل ACP الأولية إلى جلسة الطالب كأحداث نظام. تتضمن الاستجابات المقبولة streamLogPath الذي يشير إلى سجل JSONL مقيّد بالجلسة (<sessionId>.acp-stream.jsonl) يمكنك تتبعه للاطلاع على سجل الترحيل الكامل. تعرض تدفقات تقدم الأصل تعليقات المساعد وتقدم حالة ACP افتراضيًا ما لم يكن streaming.progress.commentary=false. كما يضبط Discord افتراضيًا معاينات الأصل على وضع التقدم عندما لا يكون وضع البث مكوّنًا. لا يزال تقدم الحالة يلتزم بـ acp.stream.tagVisibility، لذلك تبقى وسوم مثل plan مخفية ما لم تُفعّل صراحةً.

تستخدم عمليات تشغيل ACP عبر sessions_spawn القيمة agents.defaults.subagents.runTimeoutSeconds كحد افتراضي لدور الطفل. لا تقبل الأداة تجاوزات المهلة لكل استدعاء.

modelstring

تجاوز صريح للنموذج لجلسة ACP الطفل. تعمل عمليات إنشاء Codex ACP على تطبيع مراجع OpenAI مثل openai/gpt-5.4 إلى إعدادات بدء Codex ACP قبل session/new؛ كما تضبط صيغ الشرطة المائلة مثل openai/gpt-5.4/high جهد الاستدلال في Codex ACP. عند الحذف، يستخدم sessions_spawn({ runtime: "acp" }) الإعدادات الافتراضية الحالية لنموذج الوكيل الفرعي (agents.defaults.subagents.model أو agents.list[].subagents.model) عند تهيئتها؛ وإلا يترك إطار تشغيل ACP يستخدم نموذجه الافتراضي. يجب على أطر التشغيل الأخرى الإعلان عن ACP models ودعم session/set_model؛ وإلا يفشل OpenClaw/acpx بوضوح بدلًا من العودة بصمت إلى القيمة الافتراضية للوكيل الهدف.

thinkingstring

جهد تفكير/استدلال صريح. بالنسبة إلى Codex ACP، تُربط minimal بجهد منخفض، وتُربط low/medium/high/xhigh مباشرةً، بينما يحذف off تجاوز بدء جهد الاستدلال. عند الحذف، تستخدم عمليات إنشاء ACP الإعدادات الافتراضية الحالية لتفكير الوكيل الفرعي و agents.defaults.models["provider/model"].params.thinking الخاصة بكل نموذج للنموذج المحدد.

أوضاع ارتباط الإنشاء والسلاسل

--bind here|off

الوضع	السلوك
`here`	اربط المحادثة النشطة الحالية في مكانها؛ وافشل إذا لم تكن هناك محادثة نشطة.
`off`	لا تنشئ ارتباطًا بالمحادثة الحالية.

ملاحظات:

--bind here هو أبسط مسار للمشغّل من أجل "جعل هذه القناة أو المحادثة مدعومة من Codex."
لا ينشئ --bind here سلسلة فرعية.
لا يتوفر --bind here إلا على القنوات التي تكشف دعم ارتباط المحادثة الحالية.
لا يمكن الجمع بين --bind و--thread في استدعاء /acp spawn نفسه.

--thread auto|here|off

الوضع	السلوك
`auto`	داخل سلسلة نشطة: اربط تلك السلسلة. خارج سلسلة: أنشئ/اربط سلسلة فرعية عند الدعم.
`here`	اشترط وجود سلسلة نشطة حالية؛ وافشل إذا لم تكن داخل واحدة.
`off`	لا يوجد ارتباط. تبدأ الجلسة بلا ارتباط.

ملاحظات:

على أسطح الارتباط التي لا تستخدم السلاسل، يكون السلوك الافتراضي فعليًا off.
يتطلب الإنشاء المرتبط بسلسلة دعم سياسة القناة:
- Discord: channels.discord.threadBindings.spawnSessions=true
- Telegram: channels.telegram.threadBindings.spawnSessions=true
استخدم --bind here عندما تريد تثبيت المحادثة الحالية من دون إنشاء سلسلة فرعية.

نموذج التسليم

يمكن أن تكون جلسات ACP إما مساحات عمل تفاعلية أو عملًا خلفيًا مملوكًا للأصل. يعتمد مسار التسليم على ذلك الشكل.

Interactive ACP sessions

تهدف الجلسات التفاعلية إلى إبقاء الحديث على سطح محادثة مرئي:

يربط /acp spawn ... --bind here المحادثة الحالية بجلسة ACP.
يربط /acp spawn ... --thread ... سلسلة/موضوع قناة بجلسة ACP.
توجّه bindings[].type="acp" المستمرة والمكوّنة المحادثات المطابقة إلى جلسة ACP نفسها.

تُوجَّه رسائل المتابعة في المحادثة المرتبطة مباشرةً إلى جلسة ACP، ويُسلَّم خرج ACP مرة أخرى إلى القناة/السلسلة/الموضوع نفسه.

ما يرسله OpenClaw إلى إطار التشغيل:

تُرسل المتابعات المرتبطة العادية كنص موجّه، مع المرفقات فقط عندما يدعمها إطار التشغيل/الخلفية.
تُعترض أوامر إدارة /acp وأوامر Gateway المحلية قبل إرسال ACP.
تُجسَّد أحداث الإكمال التي يولدها وقت التشغيل لكل هدف. تحصل وكلاء OpenClaw على غلاف سياق وقت التشغيل الداخلي الخاص بـ OpenClaw؛ وتحصل أطر تشغيل ACP الخارجية على موجّه عادي يتضمن نتيجة الطفل والتعليمة. يجب ألا يُرسل غلاف <<<BEGIN_OPENCLAW_INTERNAL_CONTEXT>>> الخام إلى أطر التشغيل الخارجية أو يُحفظ كنص نسخة محادثة لمستخدم ACP.
تستخدم إدخالات نسخة ACP النص المرئي للمستخدم الذي شغّلها أو موجّه الإكمال العادي. تبقى بيانات التعريف الداخلية للأحداث منظمة في OpenClaw حيثما أمكن ولا تُعامل كمحتوى محادثة كتبه المستخدم.

Parent-owned one-shot ACP sessions

جلسات ACP لمرة واحدة التي ينشئها تشغيل وكيل آخر هي أطفال خلفيون، شبيهة بالوكلاء الفرعيين:

يطلب الأصل العمل باستخدام sessions_spawn({ runtime: "acp", mode: "run" }).
يعمل الطفل في جلسة إطار تشغيل ACP الخاصة به.
تعمل أدوار الطفل على المسار الخلفي نفسه المستخدم لإنشاء الوكيل الفرعي الأصلي، لذلك لا يحظر إطار تشغيل ACP البطيء عمل الجلسة الرئيسية غير ذي الصلة.
تعود تقارير الإكمال عبر مسار إعلان إكمال المهمة. يحوّل OpenClaw بيانات تعريف الإكمال الداخلية إلى موجّه ACP عادي قبل إرسالها إلى إطار تشغيل خارجي، حتى لا ترى أطر التشغيل علامات سياق وقت التشغيل الخاصة بـ OpenClaw فقط.
يعيد الأصل صياغة نتيجة الطفل بصوت المساعد العادي عندما تكون الاستجابة المرئية للمستخدم مفيدة.

لا تتعامل مع هذا المسار كدردشة نظير إلى نظير بين الأصل والطفل. لدى الطفل بالفعل قناة إكمال عائدة إلى الأصل.

sessions_send and A2A delivery

يمكن لـ sessions_send استهداف جلسة أخرى بعد الإنشاء. بالنسبة إلى جلسات النظراء العادية، يستخدم OpenClaw مسار متابعة من وكيل إلى وكيل (A2A) بعد حقن الرسالة:

انتظر رد الجلسة الهدف.
اسمح اختياريًا للطالب والهدف بتبادل عدد محدود من أدوار المتابعة.
اطلب من الهدف إنتاج رسالة إعلان.
سلّم ذلك الإعلان إلى القناة أو السلسلة المرئية.

مسار A2A هذا هو مسار احتياطي لإرسالات النظراء التي يحتاج فيها المرسل إلى متابعة مرئية. يبقى مفعّلًا عندما تستطيع جلسة غير ذات صلة رؤية هدف ACP ومراسلته، مثلًا ضمن إعدادات tools.sessions.visibility الواسعة.

يتخطى OpenClaw متابعة A2A فقط عندما يكون الطالب هو والدَ طفله ACP أحادي التشغيل المملوك لوالده. في هذه الحالة، يمكن أن يؤدي تشغيل A2A فوق إكمال المهمة إلى إيقاظ الوالد بنتيجة الطفل، وتمرير رد الوالد مرة أخرى إلى الطفل، وإنشاء حلقة صدى بين الوالد والطفل. تُبلغ نتيجة sessions_send عن delivery.status="skipped" لحالة الطفل المملوك هذه لأن مسار الإكمال مسؤول بالفعل عن النتيجة.

استئناف جلسة موجودة

استخدم resumeSessionId لمتابعة جلسة ACP سابقة بدلاً من البدء من جديد. يعيد الوكيل تشغيل سجل محادثته عبر session/load، لذلك يتابع بسياق كامل لما حدث سابقاً.

json

{  "task": "Continue where we left off - fix the remaining test failures",  "runtime": "acp",  "agentId": "codex",  "resumeSessionId": "<previous-session-id>"}

حالات الاستخدام الشائعة:

سلّم جلسة Codex من حاسوبك المحمول إلى هاتفك - أخبر وكيلك أن يتابع من حيث توقفت.
واصل جلسة برمجة بدأتها تفاعلياً في CLI، والآن بلا واجهة تفاعلية عبر وكيلك.
استأنف عملاً انقطع بسبب إعادة تشغيل Gateway أو انتهاء مهلة الخمول.

ملاحظات:

ينطبق resumeSessionId فقط عندما يكون runtime: "acp"؛ يتجاهل وقت تشغيل الوكيل الفرعي الافتراضي هذا الحقل الخاص بـ ACP فقط.
ينطبق streamTo فقط عندما يكون runtime: "acp"؛ يتجاهل وقت تشغيل الوكيل الفرعي الافتراضي هذا الحقل الخاص بـ ACP فقط.
resumeSessionId هو معرّف استئناف ACP/أداة تشغيل محلي للمضيف، وليس مفتاح جلسة قناة OpenClaw؛ لا يزال OpenClaw يتحقق من سياسة إنشاء ACP وسياسة الوكيل الهدف قبل الإرسال، بينما تمتلك واجهة ACP الخلفية أو أداة التشغيل صلاحية تحميل ذلك المعرّف الصاعد.
يستعيد resumeSessionId سجل محادثة ACP الصاعد؛ لا يزال thread وmode ينطبقان بشكل طبيعي على جلسة OpenClaw الجديدة التي تنشئها، لذلك لا يزال mode: "session" يتطلب thread: true.
يجب أن يدعم الوكيل الهدف session/load (يدعمه Codex وClaude Code).
إذا لم يُعثر على معرّف الجلسة، يفشل الإنشاء بخطأ واضح - بدون رجوع صامت إلى جلسة جديدة.

اختبار دخان بعد النشر

بعد نشر Gateway، شغّل فحصاً حياً شاملاً بدلاً من الاعتماد على اختبارات الوحدة:

تحقّق من إصدار Gateway المنشور والالتزام على المضيف الهدف.
افتح جلسة جسر ACPX مؤقتة إلى وكيل حي.
اطلب من ذلك الوكيل استدعاء sessions_spawn مع runtime: "acp" وagentId: "codex" وmode: "run" والمهمة Reply with exactly LIVE-ACP-SPAWN-OK.
تحقّق من accepted=yes ووجود childSessionKey حقيقي وعدم وجود خطأ مدقّق.
نظّف جلسة الجسر المؤقتة.

أبقِ البوابة على mode: "run" وتخطَّ streamTo: "parent" - فمسارات mode: "session" المرتبطة بالخيوط ومسارات ترحيل البث هي جولات تكامل منفصلة وأكثر ثراءً.

توافق بيئة العزل

تعمل جلسات ACP حالياً على وقت تشغيل المضيف، وليس داخل بيئة عزل OpenClaw.

القيود الحالية:

إذا كانت جلسة الطالب معزولة، تُحظر عمليات إنشاء ACP لكل من sessions_spawn({ runtime: "acp" }) و/acp spawn.
لا يدعم sessions_spawn مع runtime: "acp" الخيار sandbox: "require".

تحديد هدف الجلسة

تقبل معظم إجراءات /acp هدف جلسة اختيارياً (session-key، session-id أو session-label).

ترتيب الحل:

وسيطة الهدف الصريحة (أو --session لـ /acp steer)
- تجرّب المفتاح
- ثم معرّف جلسة بشكل UUID
- ثم التسمية
ربط الخيط الحالي (إذا كانت هذه المحادثة/الخيط مرتبطة بجلسة ACP).
الرجوع إلى جلسة الطالب الحالية.

تشارك روابط المحادثة الحالية وروابط الخيوط معاً في الخطوة 2.

إذا لم يُحل أي هدف، يعيد OpenClaw خطأً واضحاً (Unable to resolve session target: ...).

عناصر تحكم ACP

الأمر	ما يفعله	مثال
`/acp spawn`	ينشئ جلسة ACP؛ مع ربط حالي أو ربط خيط اختياري.	`/acp spawn codex --bind here --cwd /repo`
`/acp cancel`	يلغي الدور الجاري للجلسة الهدف.	`/acp cancel agent:codex:acp:<uuid>`
`/acp steer`	يرسل تعليمة توجيه إلى جلسة قيد التشغيل.	`/acp steer --session support inbox prioritize failing tests`
`/acp close`	يغلق الجلسة ويفك ربط أهداف الخيط.	`/acp close`
`/acp status`	يعرض الواجهة الخلفية والوضع والحالة وخيارات وقت التشغيل والإمكانات.	`/acp status`
`/acp set-mode`	يضبط وضع وقت التشغيل للجلسة الهدف.	`/acp set-mode plan`
`/acp set`	يكتب خيار إعداد عام لوقت التشغيل.	`/acp set model openai/gpt-5.4`
`/acp cwd`	يضبط تجاوز دليل العمل لوقت التشغيل.	`/acp cwd /Users/user/Projects/repo`
`/acp permissions`	يضبط ملف تعريف سياسة الموافقة.	`/acp permissions strict`
`/acp timeout`	يضبط مهلة وقت التشغيل (بالثواني).	`/acp timeout 120`
`/acp model`	يضبط تجاوز نموذج وقت التشغيل.	`/acp model anthropic/claude-opus-4-6`
`/acp reset-options`	يزيل تجاوزات خيارات وقت تشغيل الجلسة.	`/acp reset-options`
`/acp sessions`	يسرد جلسات ACP الحديثة من المخزن.	`/acp sessions`
`/acp doctor`	صحة الواجهة الخلفية والإمكانات وإصلاحات قابلة للتنفيذ.	`/acp doctor`
`/acp install`	يطبع خطوات تثبيت وتمكين حتمية.	`/acp install`

تتطلب عناصر تحكم وقت التشغيل (spawn وcancel وsteer وclose وstatus وset-mode و set وcwd وpermissions وtimeout وmodel وreset-options) هوية المالك من القنوات الخارجية وoperator.admin من عملاء Gateway الداخليين. لا يزال بإمكان المرسلين غير المالكين المصرح لهم استخدام sessions وdoctor و install وhelp.

يعرض /acp status خيارات وقت التشغيل الفعلية بالإضافة إلى معرّفات الجلسة على مستوى وقت التشغيل ومستوى الواجهة الخلفية. تظهر أخطاء عناصر التحكم غير المدعومة بوضوح عندما تفتقر الواجهة الخلفية إلى إمكانية. يقرأ /acp sessions المخزن للجلسة الحالية المرتبطة أو جلسة الطالب؛ تُحل رموز الهدف (session-key أو session-id أو session-label) عبر اكتشاف جلسات Gateway، بما في ذلك جذور session.store المخصصة لكل وكيل.

ربط خيارات وقت التشغيل

لدى /acp أوامر ملائمة ومُعيّن عام. العمليات المكافئة:

الأمر	يرتبط بـ	ملاحظات
`/acp model <id>`	مفتاح إعداد وقت التشغيل `model`	بالنسبة إلى Codex ACP، يطبّع OpenClaw ‏`openai/<model>` إلى معرّف نموذج المهايئ ويربط لواحق التفكير ذات الشرطة المائلة مثل `openai/gpt-5.4/high` بـ `reasoning_effort`.
`/acp set thinking <level>`	الخيار القانوني `thinking`	يرسل OpenClaw المكافئ المعلن من الواجهة الخلفية عند وجوده، مفضلاً `thinking`، ثم `effort` أو `reasoning_effort` أو `thought_level`. بالنسبة إلى Codex ACP، يربط المهايئ القيم بـ `reasoning_effort`.
`/acp permissions <profile>`	الخيار القانوني `permissionProfile`	يرسل OpenClaw المكافئ المعلن من الواجهة الخلفية عند وجوده، مثل `approval_policy` أو `permission_profile` أو `permissions` أو `permission_mode`.
`/acp timeout <seconds>`	الخيار القانوني `timeoutSeconds`	يرسل OpenClaw المكافئ المعلن من الواجهة الخلفية عند وجوده، مثل `timeout` أو `timeout_seconds`.
`/acp cwd <path>`	تجاوز cwd لوقت التشغيل	تحديث مباشر.
`/acp set <key> <value>`	عام	يستخدم `key=cwd` مسار تجاوز cwd.
`/acp reset-options`	يمسح كل تجاوزات وقت التشغيل	-

أداة تشغيل acpx، وإعداد Plugin، والأذونات

لإعداد أداة تشغيل acpx (أسماء Claude Code / Codex / Gemini CLI المستعارة)، وجسور MCP الخاصة بـ plugin-tools وOpenClaw-tools، وأوضاع أذونات ACP، راجع وكلاء ACP - الإعداد.

استكشاف الأخطاء وإصلاحها

العَرَض	السبب المحتمل	الإصلاح
`ACP runtime backend is not configured`	Plugin الخلفية مفقود أو معطّل أو محظور بواسطة `plugins.allow`.	ثبّت ومكّن Plugin الخلفية، وضمّن `acpx` في `plugins.allow` عند ضبط قائمة السماح هذه، ثم شغّل `/acp doctor`.
`ACP is disabled by policy (acp.enabled=false)`	ACP معطّل عموميًا.	اضبط `acp.enabled=true`.
`ACP dispatch is disabled by policy (acp.dispatch.enabled=false)`	التوزيع التلقائي من رسائل السلاسل العادية معطّل.	اضبط `acp.dispatch.enabled=true` لاستئناف توجيه السلاسل التلقائي؛ لا تزال استدعاءات `sessions_spawn({ runtime: "acp" })` الصريحة تعمل.
`ACP agent "<id>" is not allowed by policy`	الوكيل غير موجود في قائمة السماح.	استخدم `agentId` مسموحًا به أو حدّث `acp.allowedAgents`.
`/acp doctor` يبلغ أن الخلفية غير جاهزة مباشرة بعد بدء التشغيل	Plugin الخلفية مفقود أو معطّل أو محظور بواسطة سياسة السماح/المنع، أو أن الملف التنفيذي المضبوط له غير متاح.	ثبّت/مكّن Plugin الخلفية، وأعد تشغيل `/acp doctor`، وافحص خطأ تثبيت الخلفية أو السياسة إذا بقيت غير سليمة.
لم يُعثر على أمر الحزمة	لم تُثبّت CLI المهايئ، أو أن Plugin الخارجي مفقود، أو فشل جلب `npx` عند التشغيل الأول لمهايئ غير Codex.	شغّل `/acp doctor`، وثبّت/سخّن المهايئ مسبقًا على مضيف Gateway، أو اضبط أمر وكيل acpx صراحةً.
لم يُعثر على النموذج من الحزمة	معرّف النموذج صالح لمزوّد/حزمة آخر لكن ليس لهدف ACP هذا.	استخدم نموذجًا مدرجًا بواسطة تلك الحزمة، أو اضبط النموذج في الحزمة، أو احذف التجاوز.
خطأ مصادقة المورّد من الحزمة	OpenClaw سليم، لكن CLI/المزوّد الهدف لم يسجّل الدخول.	سجّل الدخول أو وفّر مفتاح المزوّد المطلوب في بيئة مضيف Gateway.
`Unable to resolve session target: ...`	رمز مفتاح/معرّف/تسمية غير صحيح.	شغّل `/acp sessions`، وانسخ المفتاح/التسمية بدقة، ثم أعد المحاولة.
`--bind here requires running /acp spawn inside an active ... conversation`	استُخدم `--bind here` دون محادثة نشطة قابلة للربط.	انتقل إلى الدردشة/القناة الهدف وأعد المحاولة، أو استخدم الإنشاء غير المربوط.
`Conversation bindings are unavailable for <channel>.`	يفتقر المهايئ إلى إمكانية ربط ACP بالمحادثة الحالية.	استخدم `/acp spawn ... --thread ...` حيث يكون ذلك مدعومًا، أو اضبط `bindings[]` ذات المستوى الأعلى، أو انتقل إلى قناة مدعومة.
`--thread here requires running /acp spawn inside an active ... thread`	استُخدم `--thread here` خارج سياق سلسلة.	انتقل إلى السلسلة الهدف أو استخدم `--thread auto`/`off`.
`Only <user-id> can rebind this channel/conversation/thread.`	مستخدم آخر يملك هدف الربط النشط.	أعد الربط بصفتك المالك أو استخدم محادثة أو سلسلة مختلفة.
`Thread bindings are unavailable for <channel>.`	يفتقر المهايئ إلى إمكانية ربط السلاسل.	استخدم `--thread off` أو انتقل إلى مهايئ/قناة مدعومة.
`Sandboxed sessions cannot spawn ACP sessions ...`	وقت تشغيل ACP يعمل على جانب المضيف؛ جلسة الطالب معزولة.	استخدم `runtime="subagent"` من الجلسات المعزولة، أو شغّل إنشاء ACP من جلسة غير معزولة.
`sessions_spawn sandbox="require" is unsupported for runtime="acp" ...`	طُلب `sandbox="require"` لوقت تشغيل ACP.	استخدم `runtime="subagent"` للعزل المطلوب، أو استخدم ACP مع `sandbox="inherit"` من جلسة غير معزولة.
`Cannot apply --model ... did not advertise model support`	الحزمة الهدف لا تكشف تبديل نماذج ACP العام.	استخدم حزمة تعلن عن `models`/`session/set_model` في ACP، أو استخدم مراجع نماذج ACP في Codex، أو اضبط النموذج مباشرةً في الحزمة إذا كان لديها علم بدء تشغيل خاص بها.
بيانات ACP الوصفية مفقودة للجلسة المربوطة	بيانات ACP الوصفية للجلسة قديمة/محذوفة.	أعد إنشاءها باستخدام `/acp spawn`، ثم أعد ربط/تركيز السلسلة.
`AcpRuntimeError: Permission prompt unavailable in non-interactive mode`	`permissionMode` يمنع الكتابة/التنفيذ في جلسة ACP غير تفاعلية.	اضبط `plugins.entries.acpx.config.permissionMode` على `approve-all` وأعد تشغيل Gateway. راجع إعدادات الأذونات.
تفشل جلسة ACP مبكرًا مع مخرجات قليلة	مطالبات الأذونات محظورة بواسطة `permissionMode`/`nonInteractivePermissions`.	تحقّق من سجلات Gateway بحثًا عن `AcpRuntimeError`. للأذونات الكاملة، اضبط `permissionMode=approve-all`؛ وللتدهور السلس، اضبط `nonInteractivePermissions=deny`.
تتوقف جلسة ACP إلى أجل غير مسمى بعد إكمال العمل	انتهت عملية الحزمة لكن جلسة ACP لم تبلغ عن الاكتمال.	حدّث OpenClaw؛ تنظيف acpx الحالي يحصد عمليات الغلاف والمهايئ القديمة المملوكة لـ OpenClaw عند الإغلاق وبدء تشغيل Gateway.
ترى الحزمة `<<<BEGIN_OPENCLAW_INTERNAL_CONTEXT>>>`	تسرّب غلاف الحدث الداخلي عبر حدود ACP.	حدّث OpenClaw وأعد تشغيل تدفق الإكمال؛ يجب أن تتلقى الحزم الخارجية مطالبات إكمال عادية فقط.

وكلاء ACP

أي صفحة أريد؟

هل يعمل هذا مباشرةً؟

أهداف الحِزَم المدعومة

دليل تشغيل المشغّل

الإنشاء

العمل

فحص الحالة

الضبط

التوجيه

الإيقاف

ACP مقابل الوكلاء الفرعيين

كيف يشغّل ACP ‏Claude Code

الجلسات المربوطة

النموذج الذهني

ربط المحادثة الحالية

ارتباطات القنوات الدائمة

نموذج الربط

الإعدادات الافتراضية لوقت التشغيل لكل وكيل

مثال

السلوك

بدء جلسات ACP

From sessions_spawn

From /acp command

معلمات `sessions_spawn`

أوضاع ارتباط الإنشاء والسلاسل

--bind here|off

--thread auto|here|off

نموذج التسليم

توافق بيئة العزل

تحديد هدف الجلسة

عناصر تحكم ACP

ربط خيارات وقت التشغيل

أداة تشغيل acpx، وإعداد Plugin، والأذونات

استكشاف الأخطاء وإصلاحها

ذات صلة

On this page

Molty

أي صفحة أريد؟

هل يعمل هذا مباشرةً؟

أهداف الحِزَم المدعومة

دليل تشغيل المشغّل

الإنشاء

العمل

فحص الحالة

الضبط

التوجيه

الإيقاف

ACP مقابل الوكلاء الفرعيين

كيف يشغّل ACP ‏Claude Code

الجلسات المربوطة

النموذج الذهني

ربط المحادثة الحالية

ارتباطات القنوات الدائمة

نموذج الربط

الإعدادات الافتراضية لوقت التشغيل لكل وكيل

مثال

السلوك

بدء جلسات ACP

From sessions_spawn

From /acp command

معلمات sessions_spawn

أوضاع ارتباط الإنشاء والسلاسل

--bind here|off

--thread auto|here|off

نموذج التسليم

توافق بيئة العزل

تحديد هدف الجلسة

عناصر تحكم ACP

ربط خيارات وقت التشغيل

أداة تشغيل acpx، وإعداد Plugin، والأذونات

استكشاف الأخطاء وإصلاحها

ذات صلة

On this page

معلمات `sessions_spawn`