# 配置参数
## ACPX核心配置
```json
{
	"acp": {
		"enabled": true,
		"dispatch": { "enabled": true },
		"backend": "acpx",
		"defaultAgent": "claude",
		"allowedAgents": ["claude", "codex", "pi", "opencode", "gemini"],
		"maxConcurrentSessions": 8
		}
}
```
## 权限配置：
```bash
openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

```

## 重启并验证
```bash
openclaw restart
/acp doctor
```

# 启动命令
```bash
/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：

1. **连接指令:** `peer connect --target <B_IP_ADDRESS>:8080 --token <SECURE_TOKEN>`
    
2. **角色定义:** 将 `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)

1. **意图解析:** OpenClaw A 接收用户需求（如：修复 Vue 3 组件 Bug）。
    
2. **任务路由:** A 检查局域网内 B 的在线状态。
    
3. **ACP 激活:** A 向 B 发送 `/acp spawn claude` 指令。
    
4. **实时会话:** * B 启动 Claude Code 进程。
    
    - Claude Code 通过 B 的文件系统进行 `ls`, `cat`, `sed` 等操作。
        
    - B 将执行过程的增量日志（Incremental Logs）实时推送到 A 的控制台。
        
5. **结果审计:** 任务完成后，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 报告。”