企业官网建设流程全解析

clawdbot 多节点部署教程：三步把 iOS、Android 和桌面设备接进同一个 AI 助手

【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw

clawdbot 是一个个人 AI 助手项目（开源名 OpenClaw），网关服务跑在桌面端，手机作为「节点」接入后，就能用同一套系统同时管多台设备。这篇 clawdbot 多节点部署教程带你从零完成接入，读完你可以把一台手机、一台电脑挂到同一个助手上，并用 Web 界面统一查看和管理。

为什么要多节点：手机和电脑各干各的活

clawdbot 的架构分两层：跑在桌面或服务器上的Gateway（网关，负责接消息、调模型、路由工具）和挂在它下面的node（节点，就是 iPhone、Android 这类伴侣设备，提供摄像头、屏幕、通知等设备能力）。

分开跑的好处很实际：

• 电脑上跑长任务时，出门在外还能从手机发指令、看进度；
• 相机、截屏这类能力跟着设备走——让助手「看一眼」手机屏幕，调用的是手机节点的能力，而不是占用电脑资源；
• 消息统一落在网关侧，你在 Telegram、Web 界面、手机上聊天，都是同一个助手、同一份上下文。

开始前先做三件事

⚠️ 注意：clawdbot 的网关端口是18789，不是常见的 3000。配置和状态文件默认放在~/.openclaw目录，升级前建议先了解这个位置。

三步走快速上手

第 1 步：把桌面变成「中枢」

目标：在电脑上装好 clawdbot 并让 Gateway 常驻运行。

1. 克隆仓库并进入目录：

git clone https://gitcode.com/GitHub_Trending/cl/openclaw cd openclaw

2. 安装依赖（项目使用 pnpm 管理多包工作区）：

pnpm install pnpm openclaw

安装程序会自动带出初始化向导，跟着提示选模型供应商、填 API Key、配置网关即可。

3. 验证网关已启动：

openclaw gateway status

看到 Gateway 正在监听 18789 端口，说明主节点就位。再执行openclaw dashboard打开 Web 控制台，页面能加载就代表中枢完全可用。

第 2 步：接上移动设备

移动端接入走的是「设备配对」：手机出示一个签名身份，网关生成配对请求，你批准后节点正式挂上。整个过程 1 分钟内能完成。

iOS 设备

1. 通过 TestFlight 安装 clawdbot 应用；如果你已拿到源码，也可以直接编译apps/ios/下的 Xcode 工程。
2. 在电脑终端为这台设备生成配对命令（setup link 包含网关地址和一次性短效令牌，10 分钟有效）：

openclaw node run --pair "oc-pair://<setup-code>"

3. 在 iOS 应用里打开「添加节点」，按提示输入配对信息并连接。

Android 设备

1. 用apps/android/下的源码工程编译 APK，或下载已构建的安装包，安装后授予相机、通知等基础权限。
2. 在电脑端执行：

openclaw devices join-code

3. 在 Android 应用中选择「连接到现有网络」，输入网关 IP:18789 和加入码（或扫描配对二维码）完成连接。

批准配对请求

手机发起连接后，回到电脑终端批准它：

openclaw nodes pending openclaw nodes approve <requestId>

待批请求会在设备最后一次重试后 5 分钟过期，所以批准后手机会立刻完成握手。

第 3 步：验证同步并集中管理

1. 确认设备在线：

openclaw nodes status

输出里该设备显示为 paired + connected，就说明节点已入网。

2. 打开 Web 控制台（openclaw dashboard或浏览器访问http://<电脑IP>:18789），在设备页面可以看到所有已接入节点的在线状态和能力列表。

3. 按需调整同步项：消息、任务、媒体同步以及技能/插件共享，都在控制台对应配置页勾选即可。节点本身是「外设」——它只提供设备能力，所有会话和消息都统一落在网关侧，所以你在任何一台设备上发起的对话，其他设备看到的都是同一份记录。

进阶：让协作更顺

网络层面

• 端口与绑定：网关默认绑定 loopback（本机回环地址），手机要连进来需把gateway.bind设为lan，或在路由器上做 18789 端口的端口转发；
• 跨网段访问：手机和电脑不在同一网络时，用 Tailscale 或远程网关方式打通链路，参考 远程访问文档；
• 稳定性：给桌面主机分配静态 IP，手机侧优先用 WiFi，能减少断连重配。

节点权限管理

clawdbot 用「全局命令策略」统一控制节点可以暴露哪些能力，配置项是gateway.nodes.commands.allow/gateway.nodes.commands.deny（在网关配置中，见 网关配置参考）。要点：

• allow白名单之外的命令一律不下发，适合给手机只开放camera.*、device.*；
• deny优先级高于allow，可以精确禁用某一条命令，例如关掉system.run防止远程执行；
• 高危能力（如远程执行）还有独立的执行审批层（exec approvals），策略细节见 节点配对机制。

出问题时怎么办：三个高频故障速查

节点连不上

依次执行openclaw status、openclaw gateway status、openclaw logs --follow，重点看三类原因：网关没起来、gateway.bind还是 loopback、防火墙拦了 18789。若设备一直重试，待批请求会保活 5 分钟，批准即可，不必反复重连。

同步延迟或工具调用失败

先用openclaw nodes describe --node <id>看该节点声明了哪些能力，再对照日志里的错误码：

• NODE_BACKGROUND_UNAVAILABLE：App 退到后台了，把应用切回前台重试（相机、截屏是前台能力）；
• *_PERMISSION_REQUIRED：系统权限没给全，回手机设置里补授权；
• 配对正常但命令没有：检查gateway.nodes.commands.allow是否漏配。

移动设备耗电快

• 把 clawdbot 应用留在前台或锁屏保活，避免反复重连握手；
• 相机、录屏类调用只在需要时触发，不要让节点长时间挂screen.record；
• 尽量在 WiFi 下工作，减少蜂窝网络的唤醒开销。

写在最后

到这里，一台桌面中枢加多台移动设备的 clawdbot 多节点网络就跑起来了：桌面管模型和会话，手机出设备能力，Web 界面统一调度。想继续深入，建议直接读 官方文档，尤其是 节点能力说明 和 节点故障排查手册，里面把每个命令的边界和错误码都写得很细。

【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw