وكلاء ACP

​

أي صفحة أريد؟

​

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

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

​

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

​

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

​

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

​

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

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

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

​

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

​

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

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

​

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

/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

​

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

​

نموذج الربط

​

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

• 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

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

​

مثال

{
  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

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

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

​

معلمات sessions_spawn

​

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

​

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

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

​

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

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

​

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

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

​

عناصر تحكم ACP

​

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

​

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

​

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

​

ذات صلة

• وكلاء ACP - الإعداد
• إرسال الوكيل
• خلفيات CLI
• حزمة Codex
• وقت تشغيل حزمة Codex
• أدوات عزل الوكلاء المتعددين
• openclaw acp (وضع الجسر)
• الوكلاء الفرعيون