Claw3D连接OpenClaw网关完全指南：从本地到远程的4种部署模式

Claw3D连接OpenClaw网关完全指南从本地到远程的4种部署模式【免费下载链接】Claw3DClaw3D is an open source 3D engine built on OpenClaw for creating games, simulations, and high-performance 3D applications.项目地址: https://gitcode.com/gh_mirrors/cl/Claw3DClaw3D 是一个为 AI Agent 打造的 3D 虚拟办公室它的核心能力是与 OpenClaw Gateway 建立稳定的 WebSocket 连接让智能体在 3D 办公室里实时协作、开会、跑任务。这篇完整指南将按照从本地到远程的顺序带你走通 4 种最常用的 Claw3D 部署模式本地网关直连、Tailscale 远程接入、SSH 隧道、以及把 Studio 共享给多台设备。跟着做你也能快速点亮第一间 3D 智能体办公室。先搞懂架构Claw3D 的两跳连接模型在开始部署前先理解一个关键概念Claw3D 连接 OpenClaw 网关时并不是浏览器直连网关而是经过两跳浏览器 → Studio通过 HTTP 和同源 WebSocket/api/gateway/ws通信Studio → OpenClaw Gateway由 Studio 服务端再开一条上游 WebSocket 连接到网关。这意味着配置里写的ws://localhost:18789指的是Studio 所在主机能访问到的网关而不是浏览器所在设备。这也是理解后面 4 种部署模式的地基。 相关实现可以看两处代码Studio 端的 WebSocket 代理在 server/gateway-proxy.js前端连接界面含 OpenClaw / Hermes / Demo / Local / Custom 五种后端选择在 GatewayConnectScreen.tsx。开始前的三个前提OpenClaw 已在目标机器上运行且网关健康openclaw gateway status拿到网关地址默认ws://localhost:18789和令牌openclaw config get gateway.auth.tokenClaw3D 通过npm install npm run dev启动访问http://localhost:3000。部署模式一本地网关 本地 Studio最快跑通这是最简单的起点适合第一次体验网关和 Claw3D 跑在同一台机器上。三步走确保本机 OpenClaw Gateway 正在运行默认监听127.0.0.1:18789启动 Claw3Dnpm run dev打开http://localhost:3000在连接界面填写ws://localhost:18789和网关令牌选择OpenClaw backend点击 Connect。✅ 连接成功后你会看到绿色的 CONNECTED 状态左侧 Agent 列表开始加载此时进入主界面即可看到全部智能体的运行状态、实时对话流和 Agent 设置面板部署模式二远程网关 本地 StudioTailscale 与 SSH 双通道网关在另一台机器或服务器上时有两条成熟路线二选一即可。方案 ATailscale 内网穿透推荐两台机器都安装 Tailscale 并加入同一 tailnet执行tailscale up确认连通在网关机器上通过 Tailscale Serve 暴露网关tailscale serve --yes --bg --https 443 http://127.0.0.1:18789在 Studio 连接界面填写wss://gateway-host.ts.net注意是wss因为走的是 HTTPS 端点。方案 BSSH 隧道ssh -L 18789:127.0.0.1:18789 usergateway-host然后在 Studio 里照旧填ws://localhost:18789流量会自动经由隧道转发到远端网关。别忘了设备配对审批首次连接后OpenClaw 会生成一条待审批的设备配对请求。在网关机器上执行openclaw devices list openclaw devices approve --latest这一步是远程部署中最容易漏掉的一步。跨机器的完整操作手册含验证清单见 TUTORIAL.md。部署模式三远程 Studio 远程网关纯服务器部署想把整个 Claw3D 也放到服务器上比如家里的小主机或 VPS时在远程主机上运行 Studionpm run build npm run start生产模式将 Studio 暴露在私有网络或 Tailscale 内不要直接暴露公网一旦绑定到公网地址务必设置STUDIO_ACCESS_TOKEN环境变量做访问保护在 Studio 界面里配置上游网关 URL 和令牌此时应使用wss://远程地址。部署模式四把 Studio 共享给局域网 / Tailscale 设备多人或多设备共用一个 Claw3D 办公室时用HOST0.0.0.0或指定 LAN/Tailscale 地址启动 Studio设置STUDIO_ACCESS_TOKEN再向局域网暴露 Studio其他设备改用 LAN / Tailscale 地址而非localhost打开 Claw3D⚠️ 注意OpenClaw 的设备审批是按浏览器/设备粒度的——新设备首次连接仍需在网关机器上执行openclaw devices approve --latest。常见问题速查表症状原因解决EPROTO/wrong version number对非 TLS 端点用了wss://Tailscale Serve 端点用wss://本地/SSH 隧道用ws://minProtocol/maxProtocol报错网关版本过旧不支持协议 v3升级 OpenClaw或改用npm run demo-gateway401 Studio access token requiredStudio 启用了访问令牌确认请求携带了studio_accessCookie令牌正确但仍连不上设备配对未审批在网关机器执行openclaw devices approve --latest生产环境拒绝上游连接未配置白名单设置UPSTREAM_ALLOWLIST为允许的网关主机 没有现成的 OpenClaw 环境也可以先用内置演示网关体验办公室运行npm run demo-gateway后再npm run dev连接界面选择Demo backend即可看到一个带演示智能体、流式聊天和工位在线状态的模拟网关。延伸阅读文档与源码路径跨机器部署完整操作手册TUTORIAL.md六种运行时档案openclaw / hermes / demo / local / claw3d / custom详解docs/runtime-profiles.mdHermes 适配器接入指南docs/hermes-gateway.md远程办公室 Beta 与连接模式说明docs/multi-agent-beta.mdStudio 端 WebSocket 代理实现server/gateway-proxy.js网关客户端核心代码src/lib/gateway/GatewayClient.ts连接界面组件src/features/agents/components/GatewayConnectScreen.tsx写在最后4 种模式本质上都围绕同一套两跳连接模型展开——本地模式追求最快跑通Tailscale/SSH 模式解决跨机器访问共享模式则让整支 AI 团队搬进一间人人可见的 3D 办公室。选对你的场景照着重名环境变量的名字和wss://前缀这两个细节核对基本不会翻车。【免费下载链接】Claw3DClaw3D is an open source 3D engine built on OpenClaw for creating games, simulations, and high-performance 3D applications.项目地址: https://gitcode.com/gh_mirrors/cl/Claw3D创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考