OpenClaw 多设备部署指南：桌面、iOS、Android 接入同一套 AI 助手
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
OpenClaw 是一个跑在自己设备上的个人 AI 助手，通过一个 Gateway（网关）统一连接模型、工具和消息渠道。本文面向第一次部署的读者：完成后的效果是——桌面端运行一个 Gateway 进程，iOS 与 Android 作为节点设备接入，三端共用同一个助手和会话。
部署完成后你得到什么
先明确验收目标，后面每一步都对照它：
- 桌面端：Gateway 进程常驻，默认监听 18789 端口；
- 浏览器：Control UI（控制台）可以打开并收发第一条消息；
- 手机：iOS、Android 应用均显示"已配对/已连接"状态；
- 会话数据保存在 Gateway 主机上，各端只是不同的接入界面。
工作区一：桌面端安装 Gateway
检查运行环境
Gateway 基于 Node.js，执行node --version确认版本满足 22.22.3+、24.15+ 或 25.9+（文档推荐 Node 26）。再确认git、pnpm可用，版本不满足时先升级，不要跳过。
克隆源码并安装依赖
执行以下命令获取仓库并进入目录：
git clone https://gitcode.com/GitHub_Trending/cl/openclaw cd openclaw该仓库是 pnpm 工作区，根目录不支持npm install，请执行：
pnpm install成功现象：node_modules生成且无报错。
构建并执行引导向导
pnpm build pnpm ui:build openclaw onboard --install-daemonpnpm build编译核心代码，pnpm ui:build编译 Control UI 静态资源，onboard会打开交互向导：选择模型供应商、填入 API Key、配置 Gateway，并通过--install-daemon把进程注册为系统服务。
判断 Gateway 是否运行成功
openclaw gateway status看到"listening on 18789"类输出即表示成功。接着执行openclaw dashboard打开控制台，在聊天框输入一句话，收到 AI 回复即完成桌面端验收。
工作区二：连接 iOS 客户端
iOS 应用以"节点"身份通过 WebSocket 连接 Gateway，同时提供屏幕快照、摄像头、定位、语音唤醒等能力。应用源码位于apps/ios/，可从官方渠道安装或从源码构建。
生成配对码
Gateway 默认只绑定回环地址（loopback），手机是够不到的。二选一：
- 局域网方案：在配置中将
gateway.bind设为"lan"，重启 Gateway； - 远程方案：
openclaw gateway --port 18789 --tailscale serve。
然后在浏览器打开 Control UI，进入Nodes页，点击Pair device并Create setup code。
在 iPhone 上扫码接入
打开 iOS 应用，进入Settings → Gateway，扫描配对二维码（或粘贴 setup code）。连接成功后，Gateway 列表中出现该网关并打勾。
如果失败
- 长时间停在"待批准"：在桌面终端执行
openclaw devices list，再执行openclaw devices approve <requestId>； - 提示权限不足：明文
ws://局域网连接会被降级为受限模式，需改用wss://或 Tailscale 重新扫码； - 详细排障见 iOS 文档。
工作区三：接入 Android 设备
Android 端同样是配套节点，不承载Gateway，仍需桌面端先运行。官方渠道可直接安装应用；侧载场景从仓库 Release 下载OpenClaw-Android.apk并校验签名。配对方式与 iOS 一致：使用配对码，或在设置中手动填写 Gateway 的主机地址与端口。详细流程见 Android 文档。
完成清单
逐条确认，全部打勾即部署完成：
| 检查项 | 通过标准 |
|---|---|
| 桌面进程 | openclaw gateway status显示 18789 监听 |
| 控制台 | openclaw dashboard可打开，消息有回复 |
| iOS 节点 | 应用内网关列表打勾且无红色错误 |
| Android 节点 | 同上 |
如果某项失败，优先排查防火墙对 18789 端口的放行，以及gateway.bind是否仍为默认回环；仍无法解决时查阅 Gateway 文档。
下一步
- 首次运行细节：docs/start/getting-started.md
- 各平台差异（Windows、Linux、树莓派等）：docs/platforms/
- 接入消息渠道（Telegram、Slack 等）：docs/channels/
- 会话与节点相关实现：
src/sessions/、src/node-host/
具体行为以当前仓库版本为准，命令输出与文档不一致时以官方文档为参考。
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
