Tác nhân ACP

Documentation Index

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

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

​

Tôi cần trang nào?

​

Tính năng này có hoạt động ngay sau khi cài không?

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

​

Các mục tiêu harness được hỗ trợ

​

Runbook cho operator

​

ACP so với sub-agent

​

Cách ACP chạy Claude Code

1. Control plane phiên ACP của OpenClaw.
2. Plugin runtime chính thức @openclaw/acpx.
3. Adapter ACP của Claude.
4. Cơ chế runtime/session phía Claude.

• Muốn /acp spawn, phiên có thể liên kết, điều khiển runtime, hoặc công việc harness bền vững? Dùng ACP.
• Muốn dự phòng văn bản cục bộ đơn giản thông qua CLI thô? Dùng backend CLI.

​

Phiên được liên kết

​

Mô hình tư duy

• Bề mặt trò chuyện - nơi mọi người tiếp tục trao đổi (kênh Discord, chủ đề Telegram, cuộc trò chuyện iMessage).
• Phiên ACP - trạng thái runtime Codex/Claude/Gemini bền vững mà OpenClaw định tuyến tới.
• Luồng/chủ đề con - bề mặt nhắn tin bổ sung tùy chọn chỉ được tạo bởi --thread ....
• Workspace runtime - vị trí hệ thống tệp (cwd, repo checkout, backend workspace) nơi harness chạy. Độc lập với bề mặt trò chuyện.

​

Liên kết cuộc trò chuyện hiện tại

/codex bind                                              # liên kết Codex gốc, định tuyến tin nhắn tương lai tại đây
/codex model gpt-5.4                                     # tinh chỉnh luồng Codex gốc đã liên kết
/codex stop                                              # điều khiển lượt Codex gốc đang hoạt động
/acp spawn codex --bind here                             # dự phòng ACP tường minh cho Codex
/acp spawn codex --thread auto                           # có thể tạo một luồng/chủ đề con và liên kết ở đó
/acp spawn codex --bind here --cwd /workspace/repo       # cùng liên kết trò chuyện, Codex chạy trong /workspace/repo

​

Liên kết kênh bền vững

​

Mô hình liên kết

​

Mặc định runtime theo từng agent

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (id harness, ví dụ codex hoặc 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. Mặc định ACP toàn cục (ví dụ acp.backend)

​

Ví dụ

{
  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 } },
        },
      },
    },
  },
}

​

Hành vi

• OpenClaw đảm bảo phiên ACP đã cấu hình tồn tại trước khi sử dụng.
• Tin nhắn trong kênh hoặc chủ đề đó được định tuyến đến phiên ACP đã cấu hình.
• Trong các cuộc trò chuyện đã liên kết, /new và /reset đặt lại cùng khóa phiên ACP ngay tại chỗ.
• Các liên kết runtime tạm thời (ví dụ được tạo bởi các luồng tập trung vào luồng thảo luận) vẫn áp dụng khi có.
• Với các lần tạo ACP liên agent không có cwd rõ ràng, OpenClaw kế thừa không gian làm việc của agent đích từ cấu hình agent.
• Các đường dẫn không gian làm việc được kế thừa nhưng bị thiếu sẽ quay về cwd mặc định của backend; các lỗi truy cập không phải do thiếu đường dẫn sẽ hiển thị dưới dạng lỗi tạo phiên.

​

Bắt đầu phiên 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

​

Tham số sessions_spawn

​

Chế độ liên kết và thread khi tạo phiên

​

Mô hình phân phối

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

​

Khả năng tương thích sandbox

• Nếu phiên yêu cầu đang ở trong sandbox, các lần spawn ACP bị chặn cho cả sessions_spawn({ runtime: "acp" }) và /acp spawn.
• sessions_spawn với runtime: "acp" không hỗ trợ sandbox: "require".

​

Phân giải mục tiêu phiên

1. Đối số mục tiêu tường minh (hoặc --session cho /acp steer)
   • thử khóa
   • sau đó là id phiên dạng UUID
   • sau đó là nhãn
2. Liên kết luồng hiện tại (nếu cuộc trò chuyện/luồng này được liên kết với một phiên ACP).
3. Dự phòng về phiên yêu cầu hiện tại.

​

Điều khiển ACP

​

Ánh xạ tùy chọn runtime

​

Harness acpx, thiết lập Plugin và quyền

​

Khắc phục sự cố

​

Liên quan

• Tác nhân ACP - thiết lập
• Gửi tác nhân
• Backend CLI
• Harness Codex
• Runtime harness Codex
• Công cụ sandbox đa tác nhân
• openclaw acp (chế độ cầu nối)
• Tác nhân phụ