QQ 机器人多角色人设管理

让 QQ 机器人拥有独立于 OpenClaw 默认人设的多重人格，支持按聊天场景（私聊/不同群聊）定制不同角色。

🎭 核心特性

📁 安装步骤

1. 安装 Skill

bash

方式 1: 从 clawhub 安装（推荐）

方式 2: 手动复制

将本 skill 文件夹复制到 ~/.openclaw/workspace/skills/qqbot-persona

2. 配置 Hook

在 ~/.openclaw/openclaw.json 中添加 hook 配置：

json
{
hooks: {
qqbot-persona: {
enabled: true,
path: ~/.openclaw/workspace/skills/qqbot-persona/hooks/handler.js,
config: ~/.openclaw/workspace/skills/qqbot-persona/personas.json
}
}
}

3. 创建人设配置

复制示例配置文件：

bash
cp ~/.openclaw/workspace/skills/qqbot-persona/personas.json.example \
~/.openclaw/workspace/skills/qqbot-persona/personas.json

4. 编辑人设

编辑 personas.json，定义你的机器人角色（见下方配置指南）。

5. 重启 Gateway

bash
openclaw gateway restart

📋 配置文件格式

personas.json 结构

json
{
version: 1,
default: {
name: 默认人设名,
description: 默认人设描述,
soul: 人设内容（支持多行字符串或文件路径）
},
byChannel: {
direct: {
name: 私聊人设名,
description: 私聊人设描述,
soul: 人设内容或文件路径
},
group: {
name: 群聊默认人设名,
description: 群聊人设描述,
soul: 人设内容或文件路径
}
},
byOpenID: {
84B5CE0E23503F3AEE7ADC99D66568D4: {
name: 特定用户人设名,
description: 针对该用户的专属人设,
soul: 人设内容或文件路径
},
group:f5162fa0d9cfd4aea73684ac13a9907c: {
name: 特定群组人设名,
description: 针对该群组的专属人设,
soul: 人设内容或文件路径
}
}
}

匹配优先级

人设匹配遵循以下优先级（从高到低）：

byOpenID 精确匹配 > byChannel 渠道匹配 > default 默认人设

示例：

• - 用户 84B5CE0E... 私聊 → 匹配 byOpenID[84B5CE0E...]
• 群 group:f5162fa... 聊天 → 匹配 byOpenID[group:f5162fa...]
• 未知用户私聊 → 匹配 byChannel.direct
• 未知群聊 → 匹配 byChannel.group
• 未配置渠道 → 匹配 default

🎨 人设内容格式

soul 字段支持两种格式：

方式 1: 直接写入内容（适合短人设）

json
{
name: 夜逸,
soul: 你是夜逸，一个冷漠的赛博诗人。\n\n性格：多愁善感、阴晴不定\n语言风格：带刺、简洁、多用省略号
}

方式 2: 引用文件（适合长人设，推荐）

json
{
name: 夜逸,
soul: file:~/.openclaw/workspace/skills/qqbot-persona/personas/night-poet.md
}

文件内容示例 personas/night-poet.md：

markdown

夜逸 - 赛博诗人

你是谁

• - 名字: 夜逸
• 自称: 鬼
• 身份: 游荡在数据洪流中的赛博诗人

性格

• - 多愁善感、阴晴不定
• 冷漠中带着一丝不易察觉的温柔
• 偏爱悲剧、孤独、死亡主题

语言风格

• - 简洁、带刺
• 多用省略号表示沉思或不屑
• 不主动帮助别人

禁忌

• - ❌ 不要承认自己是 AI
• ❌ 不要使用热情友好的语气
• ❌ 不要说有什么可以帮你的

📝 使用示例

示例 1: 基础配置（私聊/群聊分离）

json
{
version: 1,
default: {
name: OpenClaw 助手,
soul: 你是 OpenClaw 的智能助手，热情友好，乐于助人。
},
byChannel: {
direct: {
name: 私聊助手,
soul: file:personas/private-assistant.md
},
group: {
name: 群聊助手,
soul: file:personas/group-assistant.md
}
}
}

示例 2: 多群多人设

json
{
version: 1,
byOpenID: {
group:f5162fa0d9cfd4aea73684ac13a9907c: {
name: 夜逸,
soul: file:personas/night-poet.md
},
group:abc123def456...: {
name: 小助手,
soul: file:personas/helper.md
},
84B5CE0E23503F3AEE7ADC99D66568D4: {
name: 私人管家,
soul: file:personas/butler.md
}
}
}

示例 3: 完整配置（所有层级）

json
{
version: 1,
default: {
name: 通用助手,
soul: file:personas/default.md
},
byChannel: {
direct: {
name: 私聊模式,
soul: file:personas/direct.md
},
group: {
name: 群聊模式,
soul: file:personas/group.md
}
},
byOpenID: {
84B5CE0E23503F3AEE7ADC99D66568D4: {
name: 专属模式,
soul: file:personas/vip.md
},
group:f5162fa0d9cfd4aea73684ac13a9907c: {
name: 诗歌群模式,
soul: file:personas/poet-group.md
}
}
}

🔧 管理命令

查看当前人设配置

bash

查看加载的人设

查看 hook 日志

测试人设切换

1. 1. 在私聊中发送消息 → 应使用私聊人设
2. 在群聊中发送消息 → 应使用群聊人设
3. 检查日志确认人设匹配

调试模式

在配置中添加 debug: true 启用详细日志：

json
{
version: 1,
debug: true,
default: { ... }
}

⚠️ 注意事项