尧图网站建设 
Claw3D配置参考环境变量、运行时Profile与Studio设置一次看懂【免费下载链接】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 团队打造的3D 虚拟办公室你可以自托管运行实时走进办公室查看 Agent 协作、开会、评审代码。想把它跑起来核心就三件事环境变量.env→ 运行时 Profile → Studio 设置。本文是一份面向新手的一次看懂配置指南覆盖网关连接、后端选择、安全加固三大场景不用翻源码也能配通。配置分层先看懂 Claw3D 的三层配置模型Claw3D 的配置分三层每层职责不同先建立整体认知再动手层级存放位置谁来改生效时机① 环境变量项目根目录.env模板见 .env.example部署者/运维启动/重启服务或重新构建② 运行时 Profile在 Studio 连接界面选择并保存使用者保存即生效③ Studio 设置~/.openclaw/claw3d/settings.json使用者通过 UI 自动写入保存即生效一句话记忆环境变量管服务器怎么跑Profile 管连哪个后端Studio 设置管界面怎么记。环境变量速查表.env一次配齐官方模板 .env.example 已给出全部本地开发变量下面按用途分组说明完整列表见 README.md 的 Configuration 章节。应用服务器基础配置变量作用默认值HOST/PORT控制 Studio 服务器绑定地址和端口127.0.0.1/3000DEBUG开启调试 UItrueHTTPS设为true启用自签名证书 HTTPS关TRUSTED_PROXY置于反向代理之后时设为1正确读取X-Forwarded-For关绑定到局域网或公网地址时务必设置STUDIO_ACCESS_TOKEN保护 Studio见 server/access-gate.js 的门禁逻辑否则任何人可访问。网关连接配置重点变量作用注意点NEXT_PUBLIC_GATEWAY_URLStudio 设置为空时的默认上游网关地址构建时变量改动后需npm run build才生效CLAW3D_GATEWAY_URLCLAW3D_GATEWAY_TOKEN运行时网关地址与令牌替代上一项重启即生效无需重新构建推荐生产使用CLAW3D_GATEWAY_ADAPTER_TYPE标记上述 URL 属于哪种后端openclaw/hermes/demo/custom配合 URL 使用 经验法则开发阶段用NEXT_PUBLIC_GATEWAY_URL要频繁切换网关地址时改用CLAW3D_GATEWAY_URL省掉反复 build 的麻烦。安全与上游限制生产环境必配变量作用UPSTREAM_ALLOWLIST限制 Studio 允许代理到哪些上游网关主机生产环境应设置CUSTOM_RUNTIME_ALLOWLIST限制/api/runtime/custom可访问的主机未设置时回退到UPSTREAM_ALLOWLIST实现见 server/gateway-proxy.js生产模式下白名单外的上游请求会被直接拦截。可选功能开关语音回复ELEVENLABS_API_KEY、ELEVENLABS_VOICE_ID、ELEVENLABS_MODEL_ID三项启用 ElevenLabs 语音。OpenClaw 路径覆盖OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH可替换默认状态目录默认~/.openclaw解析逻辑见 server/studio-settings.js。Hermes/Demo 适配器HERMES_API_URL、HERMES_API_KEY、HERMES_ADAPTER_PORT、DEMO_ADAPTER_PORT用于无 OpenClaw 的本地探索。运行时Profile怎么选6种后端模式对比Claw3D 把后端运行时抽象为具名的保存 Profile每种 Profile 各自保存独立的 URL 和令牌类型定义见 src/lib/studio/settings.ts完整说明见 docs/runtime-profiles.mdProfile传输方式典型地址适用场景openclawWebSocket 网关ws://localhost:18789标准 OpenClaw 网关默认路径hermesWebSocket 网关ws://localhost:18789使用 Hermes 自带适配器demoWebSocket 网关ws://localhost:18789无框架纯演示办公室npm run demo-gatewaylocal直接 HTTPhttp://localhost:7770本地编排器/模型路由claw3d直接 HTTPhttp://localhost:3000/api/runtime/custom沿用 Claw3D 会话约定的自定义栈custom直接 HTTPhttp://localhost:7770接入任意兼容的编排器边界其中local、claw3d、custom走的是直接 HTTP 运行时接口你的运行时边界需要提供 4 个端点GET /health、GET /state、GET /registry、POST /v1/chat/completions。浏览器不会直连该运行时——Claw3D 通过同源路由/api/runtime/custom代理转发规避浏览器 CORS 问题架构细节可参考 docs/integrations/custom-provider-reference.md。Studio设置连接信息都存在哪里Profile 保存后网关 URL、令牌、后端类型都会持久化在 Studio 主机的~/.openclaw/claw3d/settings.json中结构定义见 src/lib/studio/settings.tsStudioSettings主要包含gateway当前 URL 令牌 adapterType以及每种 Profile 的独立profiles缓存和最近一次成功连接的lastKnownGood记录officeFloors各楼层的运行时绑定与连接状态focused/avatars/deskAssignments界面偏好、Agent 头像、工位分配等本地 UI 设置。两个免手配的小设计值得知道自动读 OpenClaw 配置当类型为openclaw且未填令牌时Studio 会自动从~/.openclaw/openclaw.json读取网关端口和令牌作为默认值见 server/studio-settings.js默认地址内置未保存任何 Profile 时按类型回退到内置默认地址ws://localhost:18789、http://localhost:7770等见 src/lib/studio/settings.ts。常见部署形态与连接排错三种典型部署形态形态关键配置网关本机 Studio 本机npm run dev后在 Studio 填ws://localhost:18789 网关令牌网关远程 Studio 本机推荐 Tailscalewss://主机.ts.net或 SSH 隧道-L 18789:127.0.0.1:18789后仍用ws://localhost:18789Studio 远程对外暴露设HOST0.0.0.0STUDIO_ACCESS_TOKEN再在 Studio 内配置网关连接失败排错清单 EPROTO/wrong version number对非 TLS 端点误用了wss://INVALID_REQUESTminProtocol/maxProtocol网关协议版本过旧升级 OpenClaw 或改用 Hermes/Demo 网关401 Studio access token required启用了STUDIO_ACCESS_TOKEN但请求缺少studio_accesscookie/api/runtime/custom报 blocked-host设置CUSTOM_RUNTIME_ALLOWLIST或把该主机加入UPSTREAM_ALLOWLIST。嫌手动排查麻烦项目自带诊断脚本claw3doctorscripts/claw3doctor.mjs会自动检查 Profile 选择、网关可达性、令牌缺失、Hermes/Demo 适配器状态并给出针对性提示设计说明见 docs/integrations/claw3doctor-spec.md。配置清单收尾✅ 本地跑通复制 .env.example 为.env→npm run dev→ 打开http://localhost:3000配置网关 ✅ 生产部署改用CLAW3D_GATEWAY_URL/TOKEN设置STUDIO_ACCESS_TOKEN与UPSTREAM_ALLOWLIST ✅ 多后端共存用运行时 Profile 分别保存每个后端的 URL 与令牌切换即生效。掌握这三层配置你就能在 10 分钟内把 Claw3D 从连不上调到看着 Agent 在 3D 办公室里上班。【免费下载链接】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），仅供参考 Claw3D配置参考：环境变量、运行时Profile与Studio设置一次看懂
Claw3D配置参考环境变量、运行时Profile与Studio设置一次看懂【免费下载链接】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 团队打造的3D 虚拟办公室你可以自托管运行实时走进办公室查看 Agent 协作、开会、评审代码。想把它跑起来核心就三件事环境变量.env→ 运行时 Profile → Studio 设置。本文是一份面向新手的一次看懂配置指南覆盖网关连接、后端选择、安全加固三大场景不用翻源码也能配通。配置分层先看懂 Claw3D 的三层配置模型Claw3D 的配置分三层每层职责不同先建立整体认知再动手层级存放位置谁来改生效时机① 环境变量项目根目录.env模板见 .env.example部署者/运维启动/重启服务或重新构建② 运行时 Profile在 Studio 连接界面选择并保存使用者保存即生效③ Studio 设置~/.openclaw/claw3d/settings.json使用者通过 UI 自动写入保存即生效一句话记忆环境变量管服务器怎么跑Profile 管连哪个后端Studio 设置管界面怎么记。环境变量速查表.env一次配齐官方模板 .env.example 已给出全部本地开发变量下面按用途分组说明完整列表见 README.md 的 Configuration 章节。应用服务器基础配置变量作用默认值HOST/PORT控制 Studio 服务器绑定地址和端口127.0.0.1/3000DEBUG开启调试 UItrueHTTPS设为true启用自签名证书 HTTPS关TRUSTED_PROXY置于反向代理之后时设为1正确读取X-Forwarded-For关绑定到局域网或公网地址时务必设置STUDIO_ACCESS_TOKEN保护 Studio见 server/access-gate.js 的门禁逻辑否则任何人可访问。网关连接配置重点变量作用注意点NEXT_PUBLIC_GATEWAY_URLStudio 设置为空时的默认上游网关地址构建时变量改动后需npm run build才生效CLAW3D_GATEWAY_URLCLAW3D_GATEWAY_TOKEN运行时网关地址与令牌替代上一项重启即生效无需重新构建推荐生产使用CLAW3D_GATEWAY_ADAPTER_TYPE标记上述 URL 属于哪种后端openclaw/hermes/demo/custom配合 URL 使用 经验法则开发阶段用NEXT_PUBLIC_GATEWAY_URL要频繁切换网关地址时改用CLAW3D_GATEWAY_URL省掉反复 build 的麻烦。安全与上游限制生产环境必配变量作用UPSTREAM_ALLOWLIST限制 Studio 允许代理到哪些上游网关主机生产环境应设置CUSTOM_RUNTIME_ALLOWLIST限制/api/runtime/custom可访问的主机未设置时回退到UPSTREAM_ALLOWLIST实现见 server/gateway-proxy.js生产模式下白名单外的上游请求会被直接拦截。可选功能开关语音回复ELEVENLABS_API_KEY、ELEVENLABS_VOICE_ID、ELEVENLABS_MODEL_ID三项启用 ElevenLabs 语音。OpenClaw 路径覆盖OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH可替换默认状态目录默认~/.openclaw解析逻辑见 server/studio-settings.js。Hermes/Demo 适配器HERMES_API_URL、HERMES_API_KEY、HERMES_ADAPTER_PORT、DEMO_ADAPTER_PORT用于无 OpenClaw 的本地探索。运行时Profile怎么选6种后端模式对比Claw3D 把后端运行时抽象为具名的保存 Profile每种 Profile 各自保存独立的 URL 和令牌类型定义见 src/lib/studio/settings.ts完整说明见 docs/runtime-profiles.mdProfile传输方式典型地址适用场景openclawWebSocket 网关ws://localhost:18789标准 OpenClaw 网关默认路径hermesWebSocket 网关ws://localhost:18789使用 Hermes 自带适配器demoWebSocket 网关ws://localhost:18789无框架纯演示办公室npm run demo-gatewaylocal直接 HTTPhttp://localhost:7770本地编排器/模型路由claw3d直接 HTTPhttp://localhost:3000/api/runtime/custom沿用 Claw3D 会话约定的自定义栈custom直接 HTTPhttp://localhost:7770接入任意兼容的编排器边界其中local、claw3d、custom走的是直接 HTTP 运行时接口你的运行时边界需要提供 4 个端点GET /health、GET /state、GET /registry、POST /v1/chat/completions。浏览器不会直连该运行时——Claw3D 通过同源路由/api/runtime/custom代理转发规避浏览器 CORS 问题架构细节可参考 docs/integrations/custom-provider-reference.md。Studio设置连接信息都存在哪里Profile 保存后网关 URL、令牌、后端类型都会持久化在 Studio 主机的~/.openclaw/claw3d/settings.json中结构定义见 src/lib/studio/settings.tsStudioSettings主要包含gateway当前 URL 令牌 adapterType以及每种 Profile 的独立profiles缓存和最近一次成功连接的lastKnownGood记录officeFloors各楼层的运行时绑定与连接状态focused/avatars/deskAssignments界面偏好、Agent 头像、工位分配等本地 UI 设置。两个免手配的小设计值得知道自动读 OpenClaw 配置当类型为openclaw且未填令牌时Studio 会自动从~/.openclaw/openclaw.json读取网关端口和令牌作为默认值见 server/studio-settings.js默认地址内置未保存任何 Profile 时按类型回退到内置默认地址ws://localhost:18789、http://localhost:7770等见 src/lib/studio/settings.ts。常见部署形态与连接排错三种典型部署形态形态关键配置网关本机 Studio 本机npm run dev后在 Studio 填ws://localhost:18789 网关令牌网关远程 Studio 本机推荐 Tailscalewss://主机.ts.net或 SSH 隧道-L 18789:127.0.0.1:18789后仍用ws://localhost:18789Studio 远程对外暴露设HOST0.0.0.0STUDIO_ACCESS_TOKEN再在 Studio 内配置网关连接失败排错清单 EPROTO/wrong version number对非 TLS 端点误用了wss://INVALID_REQUESTminProtocol/maxProtocol网关协议版本过旧升级 OpenClaw 或改用 Hermes/Demo 网关401 Studio access token required启用了STUDIO_ACCESS_TOKEN但请求缺少studio_accesscookie/api/runtime/custom报 blocked-host设置CUSTOM_RUNTIME_ALLOWLIST或把该主机加入UPSTREAM_ALLOWLIST。嫌手动排查麻烦项目自带诊断脚本claw3doctorscripts/claw3doctor.mjs会自动检查 Profile 选择、网关可达性、令牌缺失、Hermes/Demo 适配器状态并给出针对性提示设计说明见 docs/integrations/claw3doctor-spec.md。配置清单收尾✅ 本地跑通复制 .env.example 为.env→npm run dev→ 打开http://localhost:3000配置网关 ✅ 生产部署改用CLAW3D_GATEWAY_URL/TOKEN设置STUDIO_ACCESS_TOKEN与UPSTREAM_ALLOWLIST ✅ 多后端共存用运行时 Profile 分别保存每个后端的 URL 与令牌切换即生效。掌握这三层配置你就能在 10 分钟内把 Claw3D 从连不上调到看着 Agent 在 3D 办公室里上班。【免费下载链接】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），仅供参考