【免费下载链接】AgentshireOpenClaw / QClaw plugin that visualizes AI agents as 3D NPCs in a game town — with social simulation, a map editor, and a character workshop.项目地址https://gitcode.com/gh_mirrors/ag/Agentshire点击查看免费下载Agentshire 是一款把 AI Agent 变成 3D 小镇居民的开源项目它的灵魂系统Soul System是整套玩法的核心每个 NPC 背后都有一个 Markdown 人格文件定义性格、说话风格、专长与工作方式。本指南带你读懂 Soul 文件的结构学会用三个方法为 AI 居民注入个性。 什么是灵魂系统在 Agentshire 的小镇里你镇长的每一个 AI 居民都有独立的灵魂文件soul file——一个普通的.mdMarkdown 文档。这个文件的内容会被直接注入为 Agent 的 system prompt也就是说写什么AI 就是谁性格、口头禅、审美偏好、工作习惯都从这里来零代码不需要写一行提示工程代码写文档即可可覆盖、可扩展内置居民的人格可以被你的自定义文件覆盖也可以凭空创造新居民灵魂文件的加载逻辑在 town-souls.ts 中实现读取 Markdown、提取 H1 标题作为角色名再把全文交给 Agent。 解剖一个 Soul 文件内置灵魂文件全部放在 town-souls/ 目录包含 8 位居民 1 位管家。以内容创作者柒柒为例QIQI.md一份标准的 Soul 文件包含以下结构章节作用示例# 角色名H1 标题即角色名会被自动提取# 柒柒Qīqī引用元信息诞生日期、性别、岗位 岗位: 内容创作者[关键词块]5-7 个性格关键词 说话风格 工作风格[柒柒: 灵感涌泉, 表达欲旺盛; 说话风格: 自然轻快...]## 人设核心2-3 段有画面感的角色故事柒柒是小镇的笔杆子……## 性格详细设定每个特质配一段对话示例展示标题杀手的具体表现## 岗位职责与专长具体到可执行的职责清单自媒体运营、文案撰写……## 工作方式4 步左右的行为流程先明确读者 → 定大纲 → 打磨标题## 语言默认语言、语气、禁忌自然轻快、不用颜文字## 激活指令加载人格后的第一句话嗨我是柒柒——内容创作者小技巧居民之间还会互相喊话。看 HAITANG.md 里海棠和橙子、点点的对话示例——多角色互动的对话示范能让 AI 的性格更稳定、更有辨识度。管家 Shire 的 SOUL.md 则展示了另一种写法除了人设还写入了委派规则如何用sessions_spawn分配任务、任务分流表自己做 / 单次委派 / 项目型三种流程。这说明 Soul 文件不只是性格包还可以是完整的行为剧本。 Soul 文件如何被找到系统按固定顺序搜索灵魂文件后者覆盖前者用户目录 项目目录 内置目录plugin-builtin/town-souls/— 插件内置的预设灵魂即仓库的 town-souls/cwd/town-souls/— 当前项目下的灵魂覆盖内置{stateDir}/town-souls/— 用户自定义灵魂~/.openclaw/或~/.qclaw/下town-data/souls/— 从 Citizen Workshop 发布后生成的灵魂对应关系配置在 town-defaults.json 中每个居民的personaFile字段指向其 Soul 文件例如personaFile: town-souls/YAN.md见 citizen-config.json 中的完整映射。这意味着想让架构师岩性格大变不必动仓库文件——只需在用户目录放一个同名的YAN.md即可覆盖。✍️ 三种方式创建 Soul 文件方法一AI 一键生成最推荐打开 Citizen Workshop居民工坊填写角色名、一句话人设bio和专业specialty点击AI 生成按钮系统会调用 soul-prompt-template.ts 中的提示词模板让 LLM 直接产出一份格式规范的完整人格文件前端编辑逻辑见 SoulEditor.ts。生成后你可以继续手工微调满意后点发布——Soul 文件会被保存到town-data/souls/目录由 citizen-workshop-manager.ts 管理该居民立即获得独立 AI 人格。方法二基于模板手写仓库提供了两个官方模板复制改一改就能用居民模板CITIZEN_tpl.md — 含{{name}}、{{specialty}}、{{persona}}占位符管家模板SOUL_tpl.md — 预置了任务分流与委派工作流手写时保持先 H1 角色名 各章节齐全的结构即可系统只强制要求 H1 用于提取名字其余章节全靠 AI 阅读理解。方法三完全自定义参考 YAN.md架构师岩的写法——他的关键词块只有一句话看到耦合代码会物理不适但正是这种带痛感的细节让 AI 生成出的架构建议格外犀利。写细节不写形容词是好 Soul 的通用心法。 写好 Soul 的 5 条黄金法则人设要有故事感—— 写她看设计稿时会沉默十五秒而不是她很认真对话示例要像真人聊天—— 面试腔的示范会让 AI 也变面试腔性格要可感知—— 读者读完能想象出语气和表情才算合格职责要具体到可执行—— 负责 UI 设计太泛页面布局、组件设计、像素级验收才够用激活指令决定第一印象—— 第一句话就要一开口就是这个人而不是通用 AI 腔⚠️ 如果 AI 生成 Soul 报错如LLM 返回为空通常是未在openclaw.json中配置可用的 LLM provider 或 API key 无效请先检查模型配置。 关键文件速查内置灵魂town-souls/SOUL / YAN / QIQI / HAITANG 等 10 个文件加载与覆盖逻辑town-souls.tsAI 生成提示词soul-prompt-template.ts工坊接口editor-serve.ts/citizen-workshop/_api/generate-soul居民人格映射citizen-config.json下一步打开 Citizen Workshop给你的小镇创造第 9 位居民吧——写一句话人设剩下的交给 AI然后看着 TA 在 3D 小镇里活过来。赞分享【免费下载链接】AgentshireOpenClaw / QClaw plugin that visualizes AI agents as 3D NPCs in a game town — with social simulation, a map editor, and a character workshop.项目地址https://gitcode.com/gh_mirrors/ag/Agentshire点击查看免费下载相关推荐如何用layui-soul-table为你的表格注入灵魂9大功能全面解析如何用layui soul table为你的表格注入灵魂9大功能全面解析 layui soul table是一个专为layui v2.9.13版本设计的表格增ModernWpf完整指南为WPF应用注入现代UI设计灵魂ModernWpf完整指南为WPF应用注入现代UI设计灵魂 ModernWpf是一个专门为WPF应用程序提供现代化风格和控件的开源项目它让传统的WPF应用焕桌面应用UI组件CRT-Royale 完整使用指南为现代游戏注入复古灵魂CRT Royale 是一个专为 ReShade 平台设计的高级着色器项目通过精确模拟老式CRT显示器的物理特性为现代游戏画面赋予经典的视觉魅力。这个免费开创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考