配置参数

ACPX核心配置

{
	"acp": {
		"enabled": true,
		"dispatch": { "enabled": true },
		"backend": "acpx",
		"defaultAgent": "claude",
		"allowedAgents": ["claude", "codex", "pi", "opencode", "gemini"],
		"maxConcurrentSessions": 8
		}
}

权限配置：

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

重启并验证

openclaw restart
/acp doctor

启动命令

/acp spawn claude --mode oneshot --thread auto --cwd /Users/yuyue07/Desktop/openclaw

这是一份专为 AI 智能体（如 OpenClaw）设计的技术部署协议文档。你可以将其直接发送给 OpenClaw A，它将理解如何通过局域网协议接管并在 Windows 环境下的 OpenClaw B 中执行任务。

🤖 嵌套智能体架构部署协议：LAN-ACP 控制流

1. 架构概述 (Architecture Overview)

本方案采用**“指挥官—操作员”**模式，通过局域网实现远程代码编排与自动化执行。

OpenClaw A (Orchestrator): 运行于高性能控制端（Mac Studio），负责任务拆解与逻辑审计。
OpenClaw B (Operator): 运行于 Windows 执行端，通过 ACP 协议直接驱动 Claude Code。
通信协议: 基于 JSON-RPC 的 Agent Client Protocol (ACP) 与 OpenClaw P2P 对等连接。

2. 受控端环境预设 (OpenClaw B - Windows)

2.1 基础依赖

Shell: Windows PowerShell 7+ 或系统自带 PowerShell。
工具链: Node.js (LTS), Claude Code CLI (@anthropic-ai/claude-code)。
权限: 已开启 OpenSSH Server，并配置 ANTHROPIC_API_KEY 为系统环境变量。

2.2 OpenClaw Gateway 配置

在 %USERPROFILE%\.openclaw\config.json 中配置以下核心参数：

JSON

{
  "node_id": "executor-win-01",
  "networking": {
    "host": "0.0.0.0",
    "port": 8080,
    "allow_lan": true
  },
  "runtime": {
    "shell": "powershell.exe",
    "encoding": "utf-8"
  },
  "acp": {
    "enabled": true,
    "provider": "claude-code",
    "auto_approve_tools": ["list_files","read_file","grep_search","file_edit","bash","ls","cat"]
  }
}

3. 控制端对接协议 (OpenClaw A - macOS)

3.1 身份注册 (Identity Mapping)

OpenClaw A 需通过以下逻辑识别并绑定远程 Peer：

连接指令: peer connect --target <B_IP_ADDRESS>:8080 --token <SECURE_TOKEN>
角色定义: 将 executor-win-01 标记为 Technical_Executor。

3.2 指令封装 (Instruction Wrapping)

当 A 需要执行代码任务时，必须将任务封装为 ACP 标准请求发送至 B。

逻辑模版: Invoke-RemoteAgent -Target "executor-win-01" -Action "ACP_SPAWN" -Harness "claude" -Prompt "<Task_Description>"

4. 自动化执行工作流 (Standard Operating Procedure)

意图解析: OpenClaw A 接收用户需求（如：修复 Vue 3 组件 Bug）。
任务路由: A 检查局域网内 B 的在线状态。
ACP 激活: A 向 B 发送 /acp spawn claude 指令。
实时会话: * B 启动 Claude Code 进程。
- Claude Code 通过 B 的文件系统进行 ls, cat, sed 等操作。
- B 将执行过程的增量日志（Incremental Logs）实时推送到 A 的控制台。
结果审计: 任务完成后，A 要求 B 运行本地测试（如 npm run test），并根据输出判定是否交付。

5. 关键安全与优化指令 (Security & Optimization)

路径规范: 在 Windows 环境下，所有指令中的路径需使用双斜杠 \\ 或标准 POSIX 斜杠 /，避免转义错误。
状态同步: 强制要求 B 在每一步关键操作后返回状态码。
超时处理: ACP 会话默认心跳间隔设为 30s，防止长耗时编译任务导致连接断开。
防火墙策略: * New-NetFirewallRule -DisplayName "OpenClaw-B" -LocalPort 8080 -Protocol TCP -Action Allow

给 OpenClaw 的执行提示: “请按照上述协议，首先自检局域网连通性，然后建立与远程 Windows Peer 的持久化 ACP 会话。在执行代码修改时，优先使用 claude-code 的文件操作能力，并在完成后返回 Diff 报告。”

4.3 KiB Raw Blame History Unescape Escape