Agentshire开源插件：让QClaw变3D小镇，Agent工作可视化 ​

15天4.5万行代码，开发一款QClaw/OpenClaw的UGC游戏插件——装上之后，你的龙虾Agents就能住进一座3D小镇，Agent工作全程可视化。

一句话安装 ​

QClaw用户（适配0.2.x版本） ​

发送如下提示词，重启QClaw，小镇自动在浏览器打开：

安装插件 https://github.com/Agentshire/Agentshire

OpenClaw CLI用户（适配2026.3.13版本） ​

openclaw plugins install agentshire

不需要改任何配置文件。插件首次启动自动创建管家、注册Agent、设置路由，全部零配置。

手机浏览器也能访问小镇：电脑在跑任务，手机扫一眼进度。

为什么做这个 ​

Agent产品现在的交互体验，基本都一个样：一个聊天框，一段流式文本，一个转圈。

你说一句话，它开始跑，你就坐那等。让多个子Agent一起跑的时候更夸张，完全黑盒，干到哪了/有没有在干，完全看不出来。

Agent的界面难道只能是聊天框？

不是给用户一个固定的3D小镇，而是让用户自己捏角色、搭小镇、定义规则。

有哪些好玩的 ​

多Agent协作，全程可视化 ​

QClaw/OpenClaw把任务交给子Agent之后，就是个黑盒。装上插件，每个子Agent变成一个看得见的NPC。谁在工作、谁在等待、进度到哪一步、中间出了什么问题——看一眼小镇就知道。

等AI干活不再无聊 ​

NPC写代码写太久，头顶会冒出紫色的「班味团子」，点击消灭它们，连击有combo，甚至还有Boss战。

这是一套可插拔的小游戏框架，类似红白机的卡带槽，班味消除是第一个内置卡带。后面可以接入更多小游戏。

跟任何居民聊天 ​

点击小镇里任何一个NPC，直接跟它对话。消息路由到这个居民自己的独立Agent会话——每个居民有一份灵魂文件，性格、语气、专长都不一样。

比如"小烈"：热血行动派，直来直去，代码即信仰。跟温柔型的"点点"完全不同。不是换了个头像，是换了个人。

一座活着的小镇 ​

• 24小时昼夜循环，6个时段，路灯自动开关
• 12种天气，晴天到极光，每天随机主题
• NPC有自己的日常——散步、去咖啡馆、路上偶遇聊天、回家休息
• 4轨BGM按时段和场景自动切换
• 所有环境音零音频文件，全部Web Audio API实时程序合成

技术架构 ​

设计出发点：Agent不该活在日志里，它该活在一个你能看见、能理解、能亲手改造的世界里。

可见：事件翻译 + 实时追踪 ​

QClaw/OpenClaw（10+ Hook回调）
    │  Hook事件
    ▼
Plugin翻译层（Node.js）
    │  Hook → 26+种AgentEvent → WebSocket广播
    ▼
Bridge编排层（浏览器）
    │  AgentEvent → 65种GameEvent → Phase状态机
    ▼
Frontend表演层（Three.js）
    NPC状态机 · 工作流动画 · 天气 · 昼夜 · 环境音

关键点：

• Agent = NPC自动映射，不需要手动配置
• 子Agent实时追踪，300ms轮询监听JSONL会话日志
• 意图+回传架构，两个系统之间不共享状态

可控：多Agent协作编排 ​

管家通过四步完成编排：

create_project → create_plan → next_step → mission_complete

可改：JSON驱动的UGC ​

居民的外观、人设、动画、技能全部是JSON配置，改配置就能改世界，不用动代码。

灵魂系统四级覆盖：插件内置 → 项目级 → 用户自定义 → 工坊发布，后者覆盖前者。

后续进化 ​

扩展资产包 ​

如需高级功能，可下载扩展资产包：

• 居民工坊Library角色（308个角色模型）
• 编辑器Cartoon City资产（建筑、车辆、道路、公园等）

插件安装成功后，发送：

按照 https://github.com/Agentshire/Agentshire/releases/tag/v0.1.0 的指引下载和解压3D资源

总结 ​

从日志到聊天窗到游戏世界，是Agent可观测性的三次跃迁。我们或许正处在第二次到第三次之间。

GitHub：github.com/Agentshire/Agentshire

关键词：Agentshire插件, QClaw 3D小镇, Agent可视化, OpenClaw插件, UGC编辑器, Agent工作流