OpenClaw 高级配置与云端本地协同实战

文件路径通常为 /home/ubuntu/.openclaw/openclaw.json。

多认证 Profile 与 Token 轮换

为了管理不同服务商的凭证，建议配置多个 Profile 并按需轮换。

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

记忆搜索配置

启用混合搜索（向量 + 文本）能显著提升检索效果。

{
  "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 }
        }
      }
    }
  }
}

云端与本地协同实战

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

前置条件

• AWS 服务器：已安装并运行 OpenClaw Gateway。
• macOS：安装 Node.js ≥ 22 和 npm。
• SSH：Mac 能 SSH 登录 AWS（公钥已配置）。
• 网络：Mac 需有互联网访问权限。

实施步骤

首先，在本地安装 OpenClaw 工具包。

npm install -g openclaw
openclaw --version

接着，获取 Gateway Token。在 AWS 服务器上查看配置文件：

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

或者使用工具命令提取。

然后，建立 SSH 反向隧道。在 Mac 终端执行以下命令，将本地端口 18790 映射到 AWS 的 127.0.0.1:18789。

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

首次连接需确认指纹。验证隧道是否通畅可请求健康检查接口：

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

随后，启动 Node 服务。在另一个终端中运行：

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

看到 Connected 提示即表示连接成功。

之后，在 AWS 端批准配对。可以通过 Agent 查看待批准的节点并执行批准操作：

openclaw node approve <node-id>

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

最后，配置执行权限以确保安全。推荐设置默认安全级别为 full，否则即使允许列表配了通配符也可能拒绝执行。

openclaw node exec-approvals set defaults.security full

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

验证阶段，从 AWS 的 OpenClaw Agent 测试远程执行命令，例如查看 Mac 系统信息：

nodes(action="run", node="Master-Mac", command=["sw_vers"])

参考资源：

• Team Tasks Skill: https://github.com/win4r/team-tasks