vault backup: 2026-04-01 00:12:03

2026-04-01 00:12:03 +08:00
parent 12c88fd407
commit 0179b49cf7
1 changed files with 116 additions and 1 deletions
--- a/Agent/OpenClaw/OpenClaw
+++ b/Agent/OpenClaw/OpenClaw
@@ -28,4 +28,119 @@ openclaw restart
 # 启动命令
 ```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 报告。”