Agentshire 互动拆解课
把 OpenClaw/QClaw 智能体变成 3D 小镇 NPC，实现“可看见的多 Agent 协作”。
先理解它解决的问题
把它看成一个“能力打包器”：把复杂流程拆成稳定步骤。关键概念是 workflow，你理解流程边界后，才能高质量指挥 AI 协作。
代码/配置翻译
CODE
Town Mode + Chat Mode 双模式界面
Agent = NPC (每个子 Agent 自动映射为 3D 市民)
Cinematic workflow: Summon -> Rally -> Assign -> Office -> Code -> Celebrate
Bridge layer: DirectorBridge phase state machine
PLAIN ENGLISH
这些行是项目的“核心动作按钮”。
先跑通它们，就能建立可验证的主链路。
应用测验
第一次上手该项目，优先动作是什么？
核心组件如何协作
用“群聊”视角理解模块关系，定位问题更快。
组件对话动画
代码翻译
CODE
openclaw plugins install --link .
openclaw gateway
townPort: 55210 (frontend + editor API)
wsPort: 55211 (plugin <-> frontend real-time WS)
Citizen Workshop: /citizen-editor.html
PLAIN ENGLISH
这一段决定了系统的职责边界。
边界清晰时，AI 才不会“哪里都想改”。
应用测验
功能异常时，最佳排查动作是？
数据流与执行路径
所有复杂系统都可以拆成“输入 -> 处理 -> 输出”。
消息流动画
User
Entry
Core
UI
点击 Next Step 开始
代码翻译
CODE
town_announce
town_spawn_npc
create_project
create_plan
mission_complete
next_step
PLAIN ENGLISH
这部分描述系统如何传递状态与结果。
当你能画出链路图，就能更快发现断点。
应用测验
结果错了，最有效的动作是？
部署与风险控制
最终目标不是“能跑一次”，而是“可持续使用”。
关键约束
上线稳定性的核心在于边界约束：版本兼容、权限最小化、以及可回溯日志。这里涉及 regression 风险，必须在每轮迭代后验证。
CODE
OpenClaw 2026.3.13 recommended
2026.4.x has channel init regression
Do not manually override tools.allow in openclaw.json
Frontend: Three.js + 4 entry pages (town/editor/workshop/preview)
PLAIN ENGLISH
这是落地时最容易踩坑的清单。
先管理风险，再扩展功能。