146 lines
4.3 KiB
Markdown
146 lines
4.3 KiB
Markdown
# 配置参数
|
||
## 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 报告。” |