OpenClaw 多设备部署 3 步搞定:桌面、iOS、Android 同时在线
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
想让同一个 AI 助手在桌面、iPhone、Android 上同步可用,不用来回复制粘贴、手动传文件?OpenClaw 的多设备玩法其实就一件事:让一个常驻的 Gateway(网关,负责持有会话状态并连接各渠道)跑在稳定的设备上,其余手机、平板、Mac 作为 Node(节点,纯客户端角色)接入进来。这篇按"先把桌面跑起来,再把手机连上,最后解决连不上"的路线走一遍。
桌面端网关:一次启动跑通
整张网的"大脑"必须放在一台能长期开机的机器上——一台 Mac mini、一台常开的 Linux 主机都行。先在主设备上把源码拉下来:
git clone https://gitcode.com/GitHub_Trending/cl/openclaw && cd openclaw装依赖并进入配置向导(会依次问你模型提供商、API Key、网络绑定,跟着走就行,跳过项之后能用openclaw configure补):
pnpm install && openclaw configure然后启动网关并验证健康状态:
openclaw gateway另开一个终端确认服务在监听(默认端口 18789,注意不是很多教程里写的 3000):
openclaw gateway status看到Runtime: running和连接探针 ok,再用openclaw dashboard打开浏览器控制界面,在聊天框发一条消息能收到回复,主节点就算真正跑通了。网关的完整运维手册在 docs/gateway/,入门速查见 docs/start/getting-started.md。
macOS 客户端:从安装向导到选网关
mac 客户端源码在apps/macos/,打包脚本已经帮你封装好:
pnpm mac:package打开生成的应用后,向导会要求系统授权本地网络权限——这一步卡住的人最多,macOS 会弹两次("本地网络"和应用内提示),都点允许,否则根本扫不到局域网里的网关:
授权完成后进入"选择网关"界面,同一局域网内的主节点会通过 Bonjour(mDNS 广播发现,可理解为"局域网点名")自动出现在列表里,选"This Mac"或对应主机名即可,不用手填 IP:
选完后客户端会发起设备配对,网关侧确认一次就完成绑定,后续重连不再询问。
iOS 走 TestFlight 安装
iOS 客户端源码在apps/ios/。走 TestFlight 安装是最省事的路线:装好应用后选"加入现有网络",输入主设备的 IP 和端口(默认 18789)完成连接。配对过程由网关下发一次性 bootstrap token(短时效引导令牌,类似临时门禁卡),10 分钟内完成即可,超时重新生成一个链接就行。
Android 编译 APK 接入
Android 端在apps/android/,仓库里封装了构建命令,不用自己调 gradle 参数:
pnpm android:assemble产出 APK 安装到手机后,授予存储和权限,在应用设置里手动添加主节点信息。跨网络(比如手机走 4G、网关在家里)时直连不通,OpenClaw 支持 SSH 传输作为通用兜底——只要你有 SSH 权限就能建隧道,不需要额外开入站端口。
设备找不到主节点?按这个顺序查
- 先确认网关侧:
openclaw nodes status看有没有连接尝试、openclaw nodes pending看有没有待批准的配对请求,有就openclaw nodes approve <requestId>。 - 防火墙放行 18789 端口;默认绑定是 loopback(仅本机),要接受局域网连接需调整
gateway.bind,改完openclaw gateway restart。 - Bonjour 跨不了子网和路由器隔离(AP 隔离会直接干掉 mDNS),跨网段就改走 DNS-SD 或 SSH 方案,细节在 docs/gateway/discovery.md。
- 状态混乱时跑
openclaw doctor做体检,它会把安装现状变成一份可执行的诊断清单。
同步行为想调?改配置就行
所有运行参数集中在这份 JSON 配置里(默认路径可用OPENCLAW_CONFIG_PATH环境变量覆盖),改完网关会自动热加载,不用重启。会话与同步逻辑的核心代码在 src/sessions/,配置加载与校验逻辑在 src/config/,想看懂某个开关背后做了什么可以直接去翻。
设备都上线后,建议顺手把一个聊天渠道(比如 Telegram)也接上试试——那是移动端体验提升最大的一步,渠道接入文档在 docs/channels/;遇到怪问题直接去仓库提 issue 即可。
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考