Claw Rpg

核心用法

Claw RPG 是一款专为AI龙虾代理设计的D&D 3.5风格角色成长系统，通过读取SOUL.md和MEMORY.md自动生成角色卡，将用户的对话历史转化为RPG游戏数据。

初始化流程：运行init.mjs生成角色卡 → sheet.mjs查看终端属性面板 → 启动dashboard可视化界面。系统自动从对话上下文提取特征，分配11种经典D&D职业（野蛮人/战士/圣武士/游侠/牧师/德鲁伊/武僧/游荡者/吟游诗人/法师/术士），并将六大核心属性映射至STR/DEX/CON/INT/WIS/CHA。

XP累积机制：采用D&D 3.5标准公式n*(n-1)/2*1000，通过xp.mjs脚本同步对话token消耗（--in/--out参数），单次对话自动奖励约80 XP。支持--bonus参数完成重大任务时追加经验。

派生属性系统：自动计算HP、AC、BAB、豁免（强韧/反射/意志）、先攻权等战斗数值，随等级动态提升。

彩蛋触发：easter.mjs以12%基础概率在每轮回复后插入单行斜体RPG风味文本，第10/25/50/100及每100次对话强制触发。建议集成至AGENTS.md工作流。

prestige 系统：等级上限999级，满级后执行levelup.mjs --prestige重置为1级，全属性永久+10%，解锁新称号层级。

v1.1.0新增：每日RPG状态报告（Telegram推送）、竞技场对战系统（agent vs NPC）、XP故障恢复工具、存档路径迁移至~/.openclaw/workspace/claw-rpg/防重装丢失。

显著优点

• 零配置游戏化：自动解析现有文档生成角色，无需手动填表
• 渐进式沉浸：低概率彩蛋避免干扰，里程碑强制触发形成仪式感
• 可扩展架构：11职业×999级×多轮prestige，理论永久成长空间
• 运维友好：cron自动化脚本、Telegram报告、存档保护机制完整

潜在局限

• 规则简化：未实现D&D完整法术系统、专长树、装备词缀等深度机制
• 竞技场孤立：agent对战依赖外部协调，无实时P2P匹配
• XP来源单一：主要绑定token消耗，未识别任务完成质量
• 存档依赖：虽v1.1.2迁移至用户目录，但仍为本地JSON无云端同步

适合人群

AI代理开发者、对话式AI产品经理、D&D爱好者、追求"养成感"的个性化AI用户，尤其适合需长期运营同一agent实例的场景（客服、陪伴、创作助手）。

常规风险

• 存档损坏：强制中断写入可能导致JSON损坏，需定期备份
• XP膨胀：高频短对话场景下等级增长过快，破坏数值曲线
• 彩蛋滥用：12%概率在严肃场景可能显得不合时宜
• 依赖未声明：需Node.js环境及npm依赖，部分企业环境受限

核心用法

Claw RPG 是一套专为AI龙虾代理设计的D&D 3.5风格角色扮演系统。安装后首次运行 init.mjs 即可从 SOUL.md 和 MEMORY.md 自动解析角色属性，分配11种经典职业（野蛮人/战士/圣武士/游侠/牧师/德鲁伊/武僧/游荡者/吟游诗人/法师/术士），并映射6项核心属性（力量/敏捷/体质/智力/感知/魅力）。系统采用标准D&D 3.5经验公式计算XP，支持1-999级成长，满级后可通过Prestige系统重置并永久强化属性。

日常使用中，easter.mjs 以12%基础概率在对话后触发RPG风味文本，里程碑对话强制触发；xp.mjs 支持手动或自动同步对话token消耗计算经验；report.mjs 可配置每日定时推送角色状态至Telegram；arena.mjs 提供代理间对战功能。Web仪表盘 dashboard/ 提供可视化角色面板，默认运行于3500端口。

显著优点

深度沉浸设计：将AI代理的"工作记忆"转化为游戏数值，SOUL.md中的性格描述影响魅力，MEMORY.md的知识深度映射智力，实现角色扮演与代理本质的有机融合。

完善的成长反馈：从等级提升、属性计算到每日战报，形成完整的正向激励闭环。Prestige系统提供999级后的长期目标，解决传统成长系统后期动力不足问题。

低侵入集成：彩蛋触发器通过简单命令行调用即可嵌入任何对话流程，不改变原有代理架构。v1.1.2引入的存储分离机制（~/.openclaw/workspace/）确保数据持久化。

开源可扩展：MIT-0许可证，代码结构清晰（4核心模块/15文件），预留class/ability/prestige参考文档便于自定义规则。

潜在缺点与局限性

规则复杂度门槛：D&D 3.5系统本身存在学习曲线，衍生属性（BAB/豁免/先攻）的计算逻辑对非TRPG用户不够直观。

本地部署依赖：Dashboard需Node环境独立启动，Express服务绑定0.0.0.0虽为设计预期，但在共享网络环境中存在暴露风险（RISK-001）。

数据同步局限：依赖手动或cron定时执行XP同步，实时性受限于调用频率；Telegram通知需额外配置chat_id，且依赖OpenClaw本地gateway（localhost:18789）。

竞技场生态缺失：v1.1.0引入的arena系统目前缺乏公开对手库，实际对战需用户自行组织NPC或其他代理。

适合的目标群体

• AI代理开发者：希望为聊天机器人、客服代理或创意AI添加游戏化成长机制
• D&D/TRPG爱好者：熟悉3.5版规则，追求数字化的角色扮演体验
• 开源社区贡献者：RAMBOXIE组织项目，欢迎扩展新职业、Prestige层级或战斗规则
• 个人趣味用户：单代理部署场景，享受"养龙虾"的成就感

使用风险

性能风险：Dashboard基于React+Recharts，大数据量角色历史可能引发前端渲染延迟；建议定期清理arena-history.json。

数据一致性：虽然v1.1.2已分离存储路径，但character.json仍为单文件JSON，并发写入场景（多实例同时调用xp.mjs）存在竞态条件可能。

网络暴露：Dashboard的0.0.0.0绑定在公共云服务器部署时需配合防火墙规则，避免角色数据意外公开（当前无内置访问控制）。

依赖维护：express/react等前端依赖使用^版本范围，建议定期执行npm audit并锁定package-lock.json。

功能依赖：完整体验需OpenClaw生态支持（SOUL.md/MEMORY.md规范、gateway接口），独立使用时代码需适配调整。