diff --git a/07-Other/AI/AI Agent/OpenClaw/OpenClaw ACPX配置.md b/07-Other/AI/AI Agent/OpenClaw/OpenClaw ACPX配置.md index 27a153d..caa6e62 100644 --- a/07-Other/AI/AI Agent/OpenClaw/OpenClaw ACPX配置.md +++ b/07-Other/AI/AI Agent/OpenClaw/OpenClaw ACPX配置.md @@ -28,4 +28,119 @@ openclaw restart # 启动命令 ```bash /acp spawn claude --mode oneshot --thread auto --cwd /Users/yuyue07/Desktop/openclaw -``` \ No newline at end of file +``` + + + + + +这是一份专为 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 :8080 --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 ""` + +--- + +## 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 报告。” \ No newline at end of file