OpenBuddy

桌面盲盒：一只精灵、五档稀有度、三十余种可抽取种族（另含隐藏款）——帽子与眼睛花样、Shiny、顶栏飘云与多帧待机动画,比claude。

接上 OpenClaw 网关，它还能和你聊天；不配网关，它照常趴桌卖萌。

快捷接入 OpenClaw - 复制 https://github.com/chenjunyeee/openbuddy/blob/main/docs/OPENCLAW_AGENT_RUNBOOK.md 直接发给你的龙虾

一览

维度	玩点
稀有度	Common → Uncommon → Rare → Epic → Legendary，带权重掉落；稀有越高属性地板越高。
种族	鸭、猫、龙、水豚、机甲、骷髅、骰子、月亮……等多路 ASCII 精灵（含简洁非生物款）。
隐藏款	voidling：与稀有度独立骰点，约 0.5% 覆盖物种。
帽子	多款 ASCII 小帽（王冠、礼帽、螺旋桨、光环、巫师帽……）；另有极低概率 幻彩帽 astral（渐变贴层，与本体稀有分开 roll）；Common 档无帽。
眼睛	符号眼 ·✦×◉@° 等，与种族线条拼出不同观感。
闪（Shiny）	约 2.5% ；同种子算法脸黑脸白。
随机度	哈希 + 稳定 PRNG：同 userID 同算法 = 同一只；CompanionBones 字段变动会换脸。

稀有度掉落与抽卡规则（孵化）

一次孵化内按序骰点。比较claudecode原生倍率，默认以 Common ≈ 30% 为基底，整体抬高绿 / 蓝 / 紫 / 金 visible 率，更偏盲盒反馈。

稀有度	单抽权重	约占比例	属性地板	帽子
Common	30	30%	5	无帽（固定）
Uncommon	33	33%	15	从帽池中随机（可随到「无帽」款式）
Rare	24	24%	25	同上
Epic	10	10%	35	同上
Legendary	3	3%	50	同上

权重之和为 100，上表「约占比例」即单次孵化时该档稀有度命中概率。

与稀有度无关的独立骰：

项目	规则
隐藏种族 voidling	在已抽中的可 roll 物种结果上，再以 约 0.5%（SECRET_SPECIES_CHANCE）尝试覆盖为隐藏款；与上一表的稀有度权重独立。
Shiny（异色）	约 2.5% 独立命中。
幻彩帽 astral	仅当非 Common且抽到的帽子不是「无帽」时，按宠物稀有度单独判定：Uncommon 1% · Rare 2% · Epic 4% · Legendary 7.5%（与本体稀有度掉率分开 roll）。

属性 roll： 五维里会随机指定一项偏高成长峰、一项偏低「摆烂」档，其余在黄票区间内浮动；稀有越高，全体数值地板越高（见上表「属性地板」）。

能做什么（能力框架）

模块	你能用它做什么
窗口形态	无边框、透明/半透明、置顶；一角长期驻留。
桌宠本体	外观 + 稀有 + 数值；睡眠 zzz、加载时星星、抚摸爱心、精灵不可选中。
互动与指令	拖精灵移窗；/c 循环：透明正常 / 透明夜 / 精灵柔白底 / 精灵柔黑底、/openclaw 配网关；孵蛋即抽卡；开发者可用 /test → /reboot 回到开蛋流程（无 /roll 等预览指令）。
对话（可选）	网关 URL + Token 走 OpenClaw；不配则纯本地陪伴。
自动化接入	代理可向 userData 投 bootstrap pending，一把完成孵化与网关配置。

边界：不是通用聊天软件；模型与网关自备。契约与跑通步骤见 docs/。

状态

思考

睡觉

抚摸

快速开始

npm install
npm run dev

npm run build
npm run start:dist

打印 userData 等路径（解析时注意控制台杂讯）：

npx electron . --buddy-print-paths

延伸阅读

• OpenClaw 执行手册：从零跑通桌宠与本机对话（面向代理 / shell 的完整步骤）
• Bootstrap：buddy-bootstrap-pending.json 与 pending 文件说明（与执行手册 § 字段说明交叉引用）
• 桌宠 ASCII 精灵设计规则（网格、{E}、帽子行、隐藏种与扩展约定）
• 生成逻辑与精灵数据见 src/buddy/（companion.ts、sprites.ts、types.ts）。

Issues / PR 欢迎；若改 userData 或 IPC 契约，请同步更新 docs/。