OpenClaw 高级使用：多 Agent 协作与云端本地联动配置指南

多认证 Profile + Token 轮换

支持多种 Provider 的认证管理，可配置 OAuth 或 Token 模式，并设定调用顺序。

{
  "auth": {
    "profiles": {
      "openai-codex:default": { "provider": "openai-codex", "mode": "oauth" },
      "anthropic:default": { "provider": "anthropic", "mode": "token" },
      "anthropic:manual": { "provider": "anthropic", "mode": "token" },
      "google-antigravity:[email protected]": { "provider": "google-antigravity", "mode": "oauth", "email": "[email protected]" },
      "google-antigravity:[email protected]": { "provider": "google-antigravity", "mode": "oauth" }
    },
    "order": {
      "anthropic": ["anthropic:default", "anthropic:manual"],
      "google-antigravity": ["google-antigravity:[email protected]", "google-antigravity:[email protected]"]
    }
  }
}

Memory Search 配置

启用混合搜索（向量 + 文本），设置远程 API Key 及模型参数。

文件路径：/home/ubuntu/.openclaw/openclaw.json

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "sources": ["memory", "sessions"],
        "experimental": { "sessionMemory": true },
        "provider": "gemini",
        "remote": { "apiKey": "AIzaSy***************" },
        "fallback": "gemini",
        "model": "gemini-embedding-001",
        "query": {
          "hybrid": {
            "enabled": true,
            "vectorWeight": 0.7,
            "textWeight": 0.3
          }
        }
      }
    }
  }
}

云端 Gateway 与本地 macOS 联动

架构概览

当 macOS 处于 NAT 内网无公网 IP 时，无法被 AWS 主动连接。解决方案是 Mac 主动建立 SSH 反向隧道至 AWS，将流量转发到本地 Node 服务。

┌─────────────────────────┐ SSH 反向隧道 ┌─────────────────────────┐
│ 云端 AWS (Ubuntu)       │ ◄────────────│ 本地 macOS (MacBook)    │
│                         │              │                         │
│ 端口 18790              │              │ 端口 18789              │
│ OpenClaw Gateway        │              │ OpenClaw Node           │
│ 监听：127.0.0.1:18789   │              │ 连接：localhost:18790     │
│ 公网 IP: xx.xx.xx.xx    │              │ NAT 内网                  │
└─────────────────────────┘              └─────────────────────────┘

前置条件

配置步骤

1. Mac 安装 OpenClaw

npm install -g openclaw
openclaw --version

2. 获取 Gateway Token

在 AWS 上查看配置文件中的 gateway.auth.token 值：

cat ~/.openclaw/openclaw.json | grep -A2 '"auth'"

或使用工具命令：

openclaw gateway config | grep token

3. 建立 SSH 反向隧道

在 Mac 终端执行，将本地端口映射到 AWS Gateway：

ssh -N -L 18790:127.0.0.1:18789 ubuntu@<AWS 公网 IP>

• -N：不执行远程命令，仅做端口转发。
• -L 18790:127.0.0.1:18789：Mac 本地 18790 → AWS 的 18789。
• 首次连接需确认指纹输入 yes。

验证隧道连通性：

curl -s http://localhost:18790/health

若返回内容，说明隧道已通。

4. 启动 Node 服务

在 Mac 另一个终端启动 Node，连接到 Gateway：

OPENCLAW_GATEWAY_TOKEN="<你的 Gateway Token>" \
openclaw node run \
--host 127.0.0.1 \
--port 18790 \
--display-name "Master-Mac"

启动成功后会显示连接状态：

🔗 Connecting to gateway at ws://127.0.0.1:18790 ...
✅ Connected! Waiting for pairing approval...

5. AWS 端批准配对

在 AWS 终端或通过 Agent 执行批准操作：

# 查看待批准的 Node
openclaw node pending

# 批准配对（使用 Node ID 或名称）
openclaw node approve <node-id>

批准后 Mac 终端会提示配对成功。

6. 配置执行权限

为安全起见，需设置 Node 的执行权限。推荐通过命令设置：

openclaw node exec-approvals set defaults.security full

或者手动创建配置文件 ~/.openclaw/exec-approvals.json：

{
  "defaults": {
    "security": "full"
  }
}

注意：defaults.security 必须设为 full，否则即使白名单配了 * 也会拒绝执行命令。

7. 验证连接

从 AWS 的 OpenClaw Agent 测试远程执行：

# 查看 Node 状态
nodes(action="status")

# 在 Mac 上执行命令
nodes(action="run", node="Master-Mac", command=["echo", "Hello from Mac!"])

# 查看 Mac 系统信息
nodes(action="run", node="Master-Mac", command=["sw_vers"])

通过以上步骤，即可完成云端与本地设备的深度联动，实现高效的分布式 AI 开发环境。