Tác tử ACP

​

Tôi cần trang nào?

​

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

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

​

Mục tiêu harness được hỗ trợ

​

Runbook cho operator

​

ACP so với tác tử con

​

Cách ACP chạy Claude Code

1. Mặt phẳng điều khiển phiên ACP của OpenClaw.
2. Plugin runtime chính thức @openclaw/acpx.
3. Bộ điều hợp Claude ACP.
4. Cơ chế runtime/phiên 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 tinh thần

• Bề mặt trò chuyện - nơi mọi người tiếp tục trò chuyện (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 - một bề mặt nhắn tin bổ sung tùy chọn chỉ được tạo bởi --thread ....
• Không gian làm việc runtime - vị trí hệ thống tệp (cwd, repo checkout, không gian làm việc backend) 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 các tin nhắn tương lai ở đâ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 rõ ràng cho Codex
/acp spawn codex --thread auto                           # có thể tạo 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 tác tử

• 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 sau bước tiếp nhận theo kênh cụ thể và trước khi sử dụng.
• Tin nhắn trong kênh, chủ đề hoặc cuộc trò chuyện đó được định tuyến đến phiên ACP đã cấu hình.
• Các liên kết ACP đã cấu hình sở hữu tuyến phiên của chúng. Việc phát tán broadcast của kênh không thay thế phiên ACP đã cấu hình cho một liên kết khớp.
• 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 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 hội thoại) vẫn áp dụng khi có mặt.
• Với các lần sinh ACP giữa các agent mà không có cwd rõ ràng, OpenClaw kế thừa workspace của agent đích từ cấu hình agent.
• Các đường dẫn workspace kế thừa bị thiếu sẽ rơi về cwd mặc định của backend; các lỗi truy cập không bị thiếu sẽ hiển thị dưới dạng lỗi spawn.

​

Khởi động 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 spawn và thread

​

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>"
}

​

Tương thích sandbox

• Nếu phiên yêu cầu đang ở trong sandbox, các thao tác sinh 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 đích phiên

1. Đối số đích tường minh (hoặc --session cho /acp steer)
   • thử khóa
   • rồi id phiên có dạng UUID
   • rồi nhãn
2. Ràng buộc luồng hiện tại (nếu cuộc hội thoại/luồng này được ràng buộc 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 tử ACP - thiết lập
• Gửi tác tử
• Backend CLI
• Bộ chạy Codex
• Runtime bộ chạy Codex
• Công cụ sandbox đa tác tử
• openclaw acp (chế độ cầu nối)
• Tác tử phụ