🔗 云端 OpenClaw 与本地 macOS Node 配对教程

简介

通过 Node 配对，你可以将云端的 OpenClaw 能力扩展到本地 macOS，实现控制本地浏览器、执行本地脚本、访问本地文件（如当前的 Obsidian 库）等硬核操作。

---

🗺️ 流程概览

graph TD
    A[云端 OpenClaw] -- 1. 执行 /nodes pairing --> B(获取 Gateway URL & Token)
    B -- 2. 提供给本地终端 --> C[本地 macOS]
    C -- 3. 执行 npx openclaw node join --> D{等待配对请求}
    D -- 4. 云端执行 /nodes approve --> E[✅ 配对成功]
    E -- 5. 跨设备控制 --> F(控制本地浏览器/执行脚本/管理文件)

---

🛠️ 环境准备

• 云端：正常运行 of OpenClaw 实例。
• 本地：安装了 `Node.js` (建议 v18+) 环境 of macOS。

---

📝 操作步骤

Step 1: 获取云端配对码

在云端 OpenClaw 的会话中（例如 Telegram 或 Web UI）输入：

Command

`/nodes pairing`

系统会返回一个包含 `gatewayUrl` 和 `gatewayToken` 的 JSON 片段。

Step 2: 本地安装并启动 Node

打开本地 macOS 终端，执行以下命令：

```bash npx openclaw node join —url <GATEWAY_URL> —token <GATEWAY_TOKEN> —name Mac-mini ```

注意

请将 `<GATEWAY_URL>` 和 `<GATEWAY_TOKEN>` 替换为第一步中获取的真实值。

Step 3: 云端确认配对

本地节点启动后，云端会收到挂起的配对请求。

1. 查看请求： `/nodes pending`
2. 批准请求（替换 `<REQUEST_ID>`）： `/nodes approve <REQUEST_ID>`

---

✅ 验证连接

配对成功后，在云端输入状态查询命令： ```bash /nodes status ```

如果看到 `Mac-mini` 状态显示为 `connected` 🟢，恭喜你，连接成功！

---

🚀 常用场景示例

• 控制本地浏览器：`browser —node Mac-mini …`
• 执行本地命令：`nodes run —node Mac-mini “ls -la”`
• 管理 Obsidian：就像二壮现在正在为你整理笔记一样。

---

Last Updated: 2026-03-10