Claw3D演示模式教程：不装OpenClaw也能秒速体验AI Agent协同办公-开发者社区

Claw3D演示模式教程：不装OpenClaw也能秒速体验AI Agent协同办公

【免费下载链接】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

Claw3D 演示模式（Demo Mode）让你零门槛体验 AI Agent 协同办公：无需安装 OpenClaw，只需两条命令，就能启动一个内置的模拟网关，在 3D 虚拟办公室里实时查看 Agent 们聊天、协同与办公的动态。本文用 5 分钟带你从零跑通 Claw3D 演示模式，感受"办公室化的 AI 团队"是什么体验。

什么是 Claw3D 演示模式？

Claw3D 是一个为 AI Agent 打造的 3D 虚拟办公室——与其盯着日志和仪表盘，你直接进入一个真实的办公空间，看你的 AI 团队在工位上协作、开会、处理任务。

完整运行 Claw3D 通常需要一个后端运行时（OpenClaw Gateway、Hermes 等），但如果你只想先"看看效果"，内置的演示网关就是为你准备的：

无需安装任何 Agent 框架，开箱即用；
自带 3 个模拟 Agent：Avery（Orchestrator 协调者）、Mika（Research 研究员）、Rune（Builder 构建者）；
支持流式聊天、会话预览、办公室在场状态等核心体验；
演示模式运行在本地ws://localhost:18789，完全离线、无外部依赖。

演示网关的核心逻辑在 server/demo-gateway-adapter.js 中，Studio 前端则通过 src/lib/runtime/demo/provider.ts 识别出演示模式并启用对应能力。

演示模式快速上手：5分钟跑通

第一步：克隆仓库并安装依赖

环境要求：Node.js 20+、npm 10+

git clone https://gitcode.com/gh_mirrors/cl/Claw3D claw3d cd claw3d npm install

第二步：启动演示网关 + Studio 开发服务器

打开两个终端，分别执行：

# 终端 1：启动演示网关（监听 18789 端口） npm run demo-gateway

# 终端 2：启动 Studio npm run dev

这两个脚本定义在 package.json 中：demo-gateway启动模拟网关，dev启动 Studio 开发服务器。

第三步：连接 Demo backend

浏览器打开http://localhost:3000，在连接界面选择Demo backend，填入地址ws://localhost:18789，点击连接。连接成功后，你会看到 Avery、Mika、Rune 三位演示 Agent 出现在 Agent 列表中。

在3D办公室里体验 Agent 协同办公

连上之后，访问/office路由进入 3D 复古办公室。每个 Agent 会以"打工人"的形象出现在对应工位，你可以：

🗣️与 Agent 聊天：给 Avery 发一句具体任务，它会以协调者身份回复"如何分派工作、如何对齐团队"；给 Rune 发需求，它会按"实现步骤、边界情况、验证方式"来回应——回复逻辑见 server/demo-gateway-adapter.js 中的buildDemoReply；
🧍观察在场状态：谁空闲、谁在忙碌，办公室里有实时活动提示；
📋体验会话功能：查看会话预览、重置上下文（sessions.preview/sessions.reset）；
🏗️编辑办公室布局：进入/office/builder调整工位并发布布局。

办公室场景使用等距视角渲染，背景资产位于 public/office-assets/backgrounds/office-bg.png：

多 Agent 之间还能互相发消息和"交接任务"（agents.message、agents.handoffs），模拟真实团队协同：

演示模式能做什么、不能做什么？

演示模式支持的能力集定义在 src/lib/runtime/demo/provider.ts：Agent 管理、会话、聊天、Agent 间消息与交接、流式输出、审批、配置、模型列表、文件读写等一应俱全。

需要注意的边界：

支持 ✅	不支持 ❌
Agent 创建 / 编辑 / 删除	定时任务（cron 相关方法会返回`unsupported_method`）
流式聊天、会话重置	真实大模型推理（回复是规则生成的模拟内容）
3D 办公室与在场状态	真实 Agent 框架的完整能力

演示数据全部保存在内存中，重启即清空，不用担心污染真实环境。

常见问题 FAQ

Q1：连接时提示INVALID_REQUEST或协议版本错误？说明网关协议不匹配。演示模式下直接运行npm run demo-gateway即可，参考 README.md 的 Troubleshooting 章节。

Q2：演示模式体验完，如何切换到真实的 OpenClaw？停掉演示网关，启动你的 OpenClaw Gateway，然后在 Studio 连接界面把后端切换为 OpenClaw，填入真实的 Gateway URL 和 Token 即可，无需改动代码。完整跨机器部署可参考 TUTORIAL.md。

Q3：端口被占用怎么办？演示网关默认监听 18789，可通过环境变量DEMO_ADAPTER_PORT修改端口。