Agentshire（夏尔小镇）

Agentshire 是一款极具创意的 OpenClaw 插件，它彻底颠覆了人们与 AI 智能体交互的方式。不再面对枯燥的日志流或复杂的命令行，Agentshire 将你的 OpenClaw Agent 转化为一个 3D 低多边形游戏小镇 中的鲜活 NPC。

在这里，AI 不再是冷冰冰的代码执行者，而是有名字、有形象、有人格、有日常生活的“居民”。你可以看着它们工作、协作、庆祝，甚至与它们闲聊。灵感源自《指环王》中宁静丰饶的夏尔（The Shire），Agentshire 旨在为智能体提供一个温暖的“家”，而非高压的战场。

核心体验：双模式界面

1. Town 模式：沉浸式 3D 小镇

• 实时生活模拟：观看 NPC 在小镇中漫步、社交、进入办公室工作。
• 电影级工作流动画：
  • 召唤 → 集结 → 分配 → 进办公室 → 编码 → 庆祝 → 返回。
  • 全程动画编排，让任务执行过程可视化、趣味化。
• 动态环境系统：
  • 昼夜循环：24 小时时钟，实时光照变化，路灯/窗灯自动开关。
  • 12 种天气：晴、雨、雪、沙尘暴、极光等，每天随机主题，平滑过渡。
  • 程序合成音效：基于 Web Audio API 实时生成雨声、风声、鸟鸣，零音频文件占用。
  • 自适应 BGM：Day/Dusk/Night/Work 四轨音乐，随场景自动切换。
• 交互式视觉特效 (VFX)：召唤冲击波、完成烟花、错误闪电、思考光环等，增强反馈感。

2. Chat 模式：高效 IM 交互

• 经典布局：左侧 Agent 列表（管家 + 居民，显示在线状态），右侧消息流。
• 多模态支持：支持文本、图片输入，聊天历史游标分页。
• 命令系统：内置 /new, /help, /stop 等快捷指令。
• 实时气泡：AI 回复以打字机效果显示在 NPC 头顶，支持流式更新。

智能内核：Agent = NPC

1. 灵魂系统 (Soul System)

每个 NPC 都拥有一份独立的 Markdown 人设文件，定义其性格、说话风格、专长和工作方式。

• 三层决策模型 (AgentBrain)：
  • L1 日计划：宏观任务规划。
  • L2 战术：具体步骤拆解。
  • L3 对话：基于 LLM 的深度多轮交互。
• 关系图谱：NPC 之间拥有社交关系，影响互动行为。
• 双模式驱动：
  • 默认算法模式：基于状态机和预设台词，零 LLM 开销，适合背景运行。
  • 灵魂模式：启用 AI 驱动，进行深度推理和个性化对话。

2. 多 Agent 协作

• 管家自动拆解：主 Agent（管家）接收任务后，自动 spawn 子 Agent 并行处理。
• 文件边界校验：确保不同 Agent 操作的文件互不冲突。
• 独立会话：点击任意居民 NPC 即可发起独立对话，消息路由至该居民的专属 Agent 会话。

3. AI 可控小镇

Agent 可以通过工具主动改变小镇环境：

• town_announce：广播消息。
• town_spawn_npc：生成新居民。
• town_effect：触发庆祝烟花或特效。
• town_set_time/weather：控制时间与天气。

UGC 工具：亲手打造你的世界

1. 居民工坊 (Citizen Editor)

• 角色创建：选择/上传 3D 模型，编辑灵魂人设（支持 AI 一键生成）。
• 动画映射：配置 8 个槽位的动作映射。
• 发布：将角色发布为独立 Agent，入住小镇。

2. 小镇编辑器 (Town Editor)

• 可视化拖拽：放置建筑、道路、道具、灯光，支持组合、对齐、撤销。
• 导入导出：支持导出 JSON 格式地图数据。
• 游戏级预览：一键打开预览窗口，WASD 自由漫游，体验完整昼夜天气与车辆动画。

3. 班味消除小游戏

• 解压玩法：NPC 工作时头顶生成“班味团子”，点击消除！
• 连击与 Boss 战：包含 Combo 系统和压力值管理，让等待任务完成的过程充满乐趣。

快速开始

⚠️ 注意：插件尚未发布到 npm，需使用 Link 方式安装。推荐 OpenClaw 版本：2026.3.13（4.x 版本存在已知 Channel 初始化 Bug）。

1. 安装与构建

# 克隆仓库
git clone https://github.com/Agentshire/Agentshire.git
cd Agentshire

# 构建前端
cd town-frontend && npm install && npm run build && cd ..

# Link 安装到 OpenClaw
openclaw plugins install --link .

2. 首次启动配置

插件会自动在 ~/.openclaw/workspace-town-steward/ 创建管家工作区，并在 openclaw.json 中注册 town-steward Agent。

重要提示：请勿在 openclaw.json 中手动添加 tools 配置段，否则会覆盖插件注册的工具。

3. 启动小镇

openclaw gateway

浏览器将自动打开小镇页面（默认 http://localhost:55210）。若未自动打开，可手动访问。

4. (可选) 扩展资产包

如需更多角色模型和地图资产，可从 GitHub Releases 下载 agentshire-assets.7z 并解压至插件根目录。

为什么选择 Agentshire？

• 情感化交互：将抽象的代码执行转化为具象的生活场景，降低用户对 AI 的疏离感。
• 可视化调试：通过观察 NPC 的行为和状态卡片，直观了解 Agent 的思考过程和任务进度。
• 娱乐化办公：内置小游戏和丰富特效，让等待 AI 完成任务的过程变得轻松有趣。
• 高度可定制：从 NPC 灵魂到小镇布局，完全由用户掌控，打造独一无二的 AI 社区