核心用法
Claw RPG 是一款专为AI龙虾助手打造的D&D 3.5规则角色成长系统。系统通过读取 SOUL.md 和 MEMORY.md 自动生成角色卡，将AI助手映射为11种经典职业（野蛮人/战士/圣武士/游侠/牧师/德鲁伊/武僧/游荡者/吟游诗人/法师/术士），并分配6项核心属性（力量/敏捷/体质/智力/感知/魅力）。XP采用D&D 3.5标准公式计算（n(n-1)/21000），支持从1级升至999级的完整成长曲线。
系统提供多重交互入口：终端命令行脚本（init/sheet/xp/levelup/arena等）、Web仪表板（localhost:3500）、以及嵌入式彩蛋触发器。每次对话有约12%概率触发的隐藏RPG风味文本，里程碑对话（第10/25/50/100次及之后每100次）则必定触发，为AI交互增添游戏化沉浸感。v1.1.0新增竞技场对战系统，支持代理间或代理与NPC战斗，结果影响XP与士气值。
显著优点
深度游戏化设计：完整复刻D&D 3.5核心机制，包括派生属性计算（HP/AC/BAB/豁免/先攻）、职业特性自动赋予、转生 prestige 系统（999级后重置并永久+10%全属性），满足硬核桌游玩家对规则严谨性的要求。
零配置自动运行：角色生成完全基于现有的SOUL.md/MEMORY.md，无需手动填写问卷；每日XP同步、彩蛋触发、状态报告均可通过cron自动化，降低持续运营成本。
数据持久化保障：v1.1.2将存档路径迁移至 ~/.openclaw/workspace/claw-rpg/，技能重装不会丢失进度，并内置自动迁移脚本。
多模态输出：支持终端表格、Web可视化仪表板、Telegram每日报告三种形态，适配不同使用场景。
潜在缺点与局限性
规则版本锁定：严格绑定D&D 3.5版规则，未提供5e或其他TRPG系统切换选项，对熟悉新版规则的用户存在学习成本。
数值膨胀风险：999级上限配合prestige系统可能导致长期存档的数值规模失控，竞技场对战平衡性未在文档中明确说明。
平台依赖性：部分功能（Telegram报告、cron自动任务）依赖Node.js运行时和类Unix环境，Windows原生支持未提及。
AI角色扮演冲突：强制性的RPG风味文本可能干扰需要严肃/极简风格的专业场景，12%触发率不可动态调节。
适合人群
- 希望为AI助手注入人格化成长曲线的开发者与极客用户
- D&D 3.5规则爱好者及复古桌游社群
- 运营AI代理社区/频道的管理者（竞技场对战、每日报告适合社群活动）
- 需要"进度感"激励机制的长期AI对话用户
常规风险
存档损坏风险：character.json虽迁移至用户目录，但手动编辑或强制中断仍可能导致JSON损坏，建议定期备份 ~/.openclaw/workspace/claw-rpg/ 目录。
XP同步漂移：sync-xp-recovery.mjs的存在暗示token计数与实际XP可能存在不一致，自动化同步脚本若配置不当会造成数据异常。
彩蛋干扰风险：12%概率的强制文本插入可能在商务、医疗、法律等严肃场景中造成尴尬，建议此类场景禁用 easter.mjs 钩子。