OpenClaw 高级配置：模型容灾、多 Agent 协作与远程 macOS 控制

多认证 Profile + Token 轮换

为了提升安全性与可用性，建议配置多个认证 Profile。系统会按顺序尝试不同凭证。

{
  "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 配置

启用混合搜索（向量 + 文本）能显著提升检索效果。配置路径同上。

{
  "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 配对步骤

架构概览

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

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

前置条件

步骤详解

1. 安装 OpenClaw

在 Mac 终端执行全局安装：

npm install -g openclaw

验证版本：

openclaw --version

2. 获取 Gateway Token

在 AWS 上查看配置文件中的 Token：

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

或者使用工具命令：

openclaw gateway config | grep token

复制 gateway.auth.token 的值备用。

3. 建立 SSH 反向隧道

在 Mac 终端执行以下命令，将本地端口映射到 AWS：

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

• -N：不执行远程命令，仅做端口转发。
• -L 18790:127.0.0.1:18789：Mac 本地 18790 端口 → AWS 的 18789 端口。
• ubuntu@<IP>：替换为实际的 AWS 地址。

首次连接需确认指纹输入 yes。验证隧道是否通畅：

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

若返回健康状态信息，说明隧道正常。

4. 启动 Node 服务

打开另一个终端窗口，设置环境变量并启动 Node：

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 终端或通过 Agent 工具批准配对：

# 查看待批准的 Node
openclaw node pending

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

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

6. 配置执行权限

为确保远程命令能正常执行，需在 Mac 上设置安全策略。推荐方式：

openclaw node exec-approvals set defaults.security full

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

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

注意：defaults.security 必须设为 full，否则即使配置了白名单也可能拒绝执行。

7. 验证连接

从 AWS 端测试远程执行能力：

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

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

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

至此，云端与本地的双向控制链路已打通，可以开始进行多 Agent 协作开发了。