3 步把 openclaw 铺到每一台设备：从局域网到远程接入指南

3 步把 openclaw 铺到每一台设备从局域网到远程接入指南【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw你大概也遇到过这种局面Mac 上的 AI 助手干得很带劲但手机想接着聊一句就得掏电脑出门在外直接失联。openclaw 的设计就是为了解决这个一台设备跑网关Gateway持有会话、状态和渠道手机、Mac、树莓派这些节点连上来各自贡献摄像头、麦克风和算力。照这篇走你能把同一套助手铺到家里的每一台设备上并且从外面也能安全地够到它。openclaw 控制台Control UI设备、会话和技能都在这一个页面里管理一、先选型什么场景走什么架构openclaw 只有一个主网关多设备是一个网关 N 个节点不存在多主对等网络。选型的意义在于网关放哪台机器、外面怎么进来。部署方式优势代价适合谁局域网直连延迟低、配置最简单Bonjour 自动发现设备必须在同一网段出门就断家里/办公室几台固定设备Tailscale 组网不暴露端口、跨网段、手机随时在线要装 Tailscale 并理解 Serve经常远程用、设备多SSH 隧道万能兜底只要 SSH 通就能连每次要先开隧道体验多一步有一台能 SSH 的机器、其他都不想折腾建议先从局域网直连跑通再按需加 Tailscale 或 SSH 隧道不要一上来就公网暴露。二、动手前检查环境、权限与关键决策装之前花两分钟过一遍清单能省掉后面大半的排查时间Node 版本网关主机需要 Node 22.22.3、24.15 或 25.9官方推荐 Node 26老机器上 Node 18/20 装不上去一个模型 API keyAnthropic、OpenAI、Google 任选onboarding 向导会提示输入防火墙放行网关默认监听 127.0.0.1:18789想让它出现在局域网里必须允许入站连接一台常开的机器网关要一直跑睡眠频繁的笔记本不适合当主节点Git 克隆仓库源码安装时git clone https://gitcode.com/GitHub_Trending/cl/openclaw快速自检一条命令node --version # 确认版本满足 22.22.3 / 24.15 / 25.9 之一⚠️ 避坑网关默认只绑 loopback这不是故障是安全设计远程接入要用隧道解决而不是直接改绑。三、跑通最小链路主节点三步启动最少只需三步装、配、验。# 源码安装macOS / Linux 也可用官方安装脚本 cd openclaw npm install npm run configure # 进入 onboarding 向导向导里选模型服务商、填 API key、确认网关端口。跳过可选步骤没关系之后用openclaw configure补。启动后验证网关活着openclaw gateway status # 应显示监听 18789 端口 openclaw dashboard # 浏览器打开控制台能加载即成功✅ 控制台能打开、能发消息收到回复最小链路就跑通了。接入第二台节点粘贴一条命令openclaw 的节点配对不需要手动填 IP 端口走setup link在 Control UI 的 Devices 页面打开配对对话框选Node host复制生成的命令贴到目标设备的终端执行openclaw node run --pair oc-pair://setup-code回到网关侧批准能力申请openclaw nodes pending # 查看待批准的节点 openclaw nodes approve requestId openclaw nodes status # 确认节点在线 建议setup link 里的引导令牌 10 分钟过期复制出来就尽快执行过期重新生成即可。手机接入iOS 和 AndroidiOS 应用源码在 apps/ios/Android 在 apps/android/从源码编译后用 App 内的连接网关流程指向主节点。连上后设备会自动出现然后在网关侧批准节点能力——从 2026.3.31 起只完成设备连接不等于能执行命令节点命令必须经过能力审批批准前队列里的指令会被丢弃而不是排队。⚠️ 避坑手机和网关不在同一网段时别硬填 IP走第四节的隧道方案。四、卡点排查连不上、不同步怎么办现象原因处理客户端列表里找不到网关mDNS/Bonjour 不跨路由或插件未启用openclaw plugins enable bonjour仍不行就手动填ws://IP:18789粘贴的配对命令报错setup code 超过 10 分钟过期回 Devices 页面重新生成并立即执行节点在线但命令不执行节点能力未批准2026.3.31 起的强制门槛openclaw nodes pending查看approve批准待批准请求自己消失了节点最后一次重试后 5 分钟自动过期让节点重新发起连接再批准外面完全连不上网关默认只绑 loopback走 SSH 隧道或 Tailscale Serve别直接改绑公网隧道连上后认证失败--url模式不回退读本地凭据显式带--token或--password更细的分项排查见 docs/gateway/troubleshooting.mdopenclaw doctor也值得先跑一遍。五、进阶玩法出门也能连SSH 隧道与 Tailscale改哪里不改任何配置只加一条隧道命令。效果任意网络都能按ws://127.0.0.1:18789访问网关端口零暴露。ssh -N -L 18789:127.0.0.1:18789 usergateway-host设备多、常远程的话Tailscale Serve 是更省心的替代详见 docs/gateway/remote.md。自动发现让客户端看见网关改哪里openclaw plugins enable bonjour或调整discovery.mdns.mode默认minimal。效果同网段的 Mac/iOS 客户端自动列出可用网关免去手填地址TXT 里的提示字段没有签名只当 UX 参考路由仍以解析出的服务地址为准。收紧权限删掉不再用的节点改哪里openclaw nodes remove --node id|name|ip。效果撤销该设备的 node 角色、断开其会话避免旧手机留着一条能调命令的长连接。改名用openclaw nodes rename给客厅 iPad这种设备起个好认的名字。到这里一台主机当网关、手机和其他设备当节点的最小网络就搭完了局域网里靠 Bonjour 自动发现出门靠隧道兜底权限靠节点审批兜底。下一步可以往两个方向走接上 Telegram/Slack 等渠道让助手长驻在聊天软件里或者给网关配一台常开的 VPS 彻底告别回家才能用。完整参考看 docs/配对机制细节在 docs/gateway/pairing.md。【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考