ACP Agents 安装与配置

概述

本页面覆盖 acpx harness 配置、MCP 桥接插件设置和 ACP 权限配置。是 ACP agents 概览页的配套安装指南。

acpx 内置 Harness 别名

claude、codex、copilot、cursor、droid、gemini、iflow、kilocode、kimi、kiro、openclaw、opencode、pi、qwen

安装步骤

openclaw plugins install @openclaw/acpx
openclaw config set plugins.entries.acpx.enabled true
/acp doctor  # 验证后端健康状态

插件工具 MCP 桥接

默认 ACPX 会话不向 ACP harness 暴露 OpenClaw 插件工具。需要时显式启用：

# 暴露 OpenClaw 插件工具（如 memory recall/store）
openclaw config set plugins.entries.acpx.config.pluginToolsMcpBridge true
 
# 暴露内置 OpenClaw 工具（如 cron）
openclaw config set plugins.entries.acpx.config.openClawToolsMcpBridge true

权限配置

ACP 会话非交互式运行，无 TTY 处理权限提示。

permissionMode	行为
approve-all	自动批准所有文件写入和 shell 命令
approve-reads	自动批准读取；写入和执行需提示（默认）
deny-all	拒绝所有权限提示

nonInteractivePermissions	行为
fail	无 TTY 时中止会话（默认）
deny	静默拒绝并继续（优雅降级）

openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

自定义 Agent 命令

{
  "plugins": {
    "entries": {
      "acpx": {
        "config": {
          "agents": {
            "claude": {
              "command": "node",
              "args": ["/path/to/custom-adapter.mjs", "--verbose"]
            }
          }
        }
      }
    }
  }
}

相关页面

• concepts/tool-acp-agents — ACP agents 概览与操作手册
• concepts/tool-subagents — Sub-agents（OpenClaw 原生运行时）
• multi-agent — 多 Agent 路由配置