เอเจนต์ ACP

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

ฉันควรใช้หน้าไหน?

​

ใช้งานได้ทันทีหรือไม่?

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

​

เป้าหมายฮาร์เนสที่รองรับ

​

คู่มือปฏิบัติสำหรับผู้ปฏิบัติการ

​

ACP เทียบกับ sub-agents

​

วิธีที่ ACP เรียกใช้ Claude Code

1. control plane ของเซสชัน OpenClaw ACP
2. Plugin runtime อย่างเป็นทางการ @openclaw/acpx
3. adapter Claude ACP
4. กลไก runtime/session ฝั่ง Claude

• ต้องการ /acp spawn, เซสชันที่ผูกได้, การควบคุม runtime, หรืองาน harness แบบ persistent ใช่ไหม ใช้ ACP
• ต้องการ fallback ข้อความ local แบบง่ายผ่าน CLI ดิบใช่ไหม ใช้ backend ของ CLI

​

เซสชันที่ผูกไว้

​

โมเดลทางความคิด

• พื้นผิวแชท - ที่ที่ผู้คนคุยต่อกัน (ช่อง Discord, หัวข้อ Telegram, แชท iMessage)
• เซสชัน ACP - สถานะ runtime Codex/Claude/Gemini ที่คงทนซึ่ง OpenClaw กำหนดเส้นทางไปหา
• เธรด/หัวข้อย่อย - พื้นผิวการส่งข้อความเพิ่มเติมแบบไม่บังคับที่สร้างโดย --thread ... เท่านั้น
• พื้นที่ทำงานของ runtime - ตำแหน่งในระบบไฟล์ (cwd, repo checkout, backend workspace) ที่ 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

​

การผูก channel แบบ persistent

​

โมเดลการผูก

​

ค่าเริ่มต้นของ runtime ต่อเอเจนต์

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (harness id, เช่น 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 ที่กำหนดค่าไว้
• ในบทสนทนาที่ผูกไว้ /new และ /reset จะรีเซ็ตคีย์เซสชัน ACP เดิมในที่เดิม
• การผูกรันไทม์ชั่วคราว (เช่น ที่สร้างโดยโฟลว์ thread-focus) ยังมีผลเมื่อมีอยู่
• สำหรับการสร้าง 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
• harness Codex
• runtime ของ harness Codex
• เครื่องมือ sandbox หลายเอเจนต์
• openclaw acp (โหมดบริดจ์)
• เอเจนต์ย่อย