7.5 KiB
Session: 2026-06-08 18:34:28 GMT+8
- Session Key: agent:val:telegram:direct:8745444509
- Session ID: f635575f-4ad2-4436-bfc5-aac223137b30
- Source: telegram
Conversation Summary
user: Val,有个事 assistant: 谷老板,说。 assistant: 谷老板,说。 user: 我想在增加一个新Agent,全新的人格,独立的空间,独立的记忆和对话,走qq渠道,我该怎么做? assistant: 好问题。让我先看看当前 gateway 的 agent 配置情况,再给你方案。 assistant: 现在清楚了。来看看你的 QQ 渠道相关配置和当前 agent 结构。 assistant: 现在去看看现有的 agents 结构(以 helux 为例),了解一个独立 agent 的完整配置。 assistant: 好了,信息够全了。以下是完整方案:
你要的东西:全新 Agent + QQ 渠道
这件事需要两个层面来完成
- 先搞定 QQ 渠道 — 安装 QQ Bot 插件,连上你的 bot
- 再创建独立 Agent — 全新人格、独立空间、绑定 QQ 渠道
先明确一个架构选择
你现有的 agent 模型是这样的——每个 agent 有独立的 agentDir 来存储模型配置和 session 数据,但没有独立的 MEMORY/SOUL。全系统共享 val 的那套。
要一个「全新人格、独立空间、独立记忆」的 Agent,有两种路线:
| 方案 A:自洽 Agent(推荐) | 方案 B:普通 Agent + 专用渠道 | |
|---|---|---|
| 人格 | 自己带 SOUL/MEMORY/bootstrap | 靠 channel prompt 和 model 决定 personality |
| 记忆 | 独立 memory 目录 | 无独立记忆,或少量的 system prompt 约定 |
| 空间 | 独立 workspace | 不创建 |
| 复杂程度 | 高点 | 低点,但有约束 |
| 灵活性 | 最高,想怎样就怎样 | 靠 system prompt 调风格 |
如果你想要「全新的、独立的、有自己记忆的」人格,方案 A 是正解。和 helix/oracle/sentinel 是同一层级的设计。
实际操作步骤
Step 1: 安装 QQ Bot 插件
openclaw plugins install @openclaw/qqbot
然后配置 AppID 和 AppSecret(需要去 QQ 开放平台 创建 bot 获取)。
Step 2: 创建新 Agent 的目录结构
参考现有 agent 的结构(以 helix 为例):
~/.openclaw/agents/<新Agent名>/agent/
├── models.json # 模型配置(可继承全局或独立)
└── plugins/ # 可选插件
~/.openclaw/workspace-<新Agent名>/
├── SOUL.md # ⬅ 自定义人格
├── MEMORY.md # ⬅ 独立记忆
├── IDENTITY.md # ⬅ 独立身份
└── ... # 其他 workspace 文件
Step 3: 在 openclaw.json 注册 Agent 和渠道绑定
{
agents: {
list: [
// ... 现有 ...
{
"id": "你的Agent名",
"name": "名字",
"channel": "qqbot", // ⬅ 绑定 QQ 渠道
"account": "default", // 如果有多个 QQ bot 账号可以指定
"workspace": "/Users/guchen/.openclaw/workspace-你的Agent名",
"agentDir": "/Users/guchen/.openclaw/agents/你的Agent名/agent",
"model": {
"primary": "deepseek/deepseek-v4-flash",
"fallbacks": ["lkeap/glm-5"]
}
}
]
},
channels: {
qqbot: {
enabled: true,
appId: "你的AppID",
clientSecret: "***",
// 或者配置只让某些人私聊
dmPolicy: "allowlist",
allowFrom: ["你的QQ_OpenID"]
}
}
}
Step 4: 写 SOUL.md 和 IDENTITY.md(人格定义)
全新人格的核心就在这里。你想要什么风格?随口说说我帮你写一个。
Step 5: 重启网关生效
openclaw gateway restart
几个需要你确认的点
- 名字叫什么? — 新 Agent 你想起什么名(如
iris、nova、echo、随你) - 人格风格? — 想要什么样的性格?更毒舌?更温柔?更技术向?更话痨?
- 用哪个模型? — 继承默认的 deepseek V4 Flash,还是用别的?
- QQ Bot 你有账号了吗? — 需要先到 QQ 开放平台 创建 bot,拿到 AppID 和 AppSecret assistant: 好了,信息够全了。以下是完整方案:
你要的东西:全新 Agent + QQ 渠道
这件事需要两个层面来完成
- 先搞定 QQ 渠道 — 安装 QQ Bot 插件,连上你的 bot
- 再创建独立 Agent — 全新人格、独立空间、绑定 QQ 渠道
先明确一个架构选择
你现有的 agent 模型是这样的——每个 agent 有独立的 agentDir 来存储模型配置和 session 数据,但没有独立的 MEMORY/SOUL。全系统共享 val 的那套。
要一个「全新人格、独立空间、独立记忆」的 Agent,有两种路线:
| 方案 A:自洽 Agent(推荐) | 方案 B:普通 Agent + 专用渠道 | |
|---|---|---|
| 人格 | 自己带 SOUL/MEMORY/bootstrap | 靠 channel prompt 和 model 决定 personality |
| 记忆 | 独立 memory 目录 | 无独立记忆,或少量的 system prompt 约定 |
| 空间 | 独立 workspace | 不创建 |
| 复杂程度 | 高点 | 低点,但有约束 |
| 灵活性 | 最高,想怎样就怎样 | 靠 system prompt 调风格 |
如果你想要「全新的、独立的、有自己记忆的」人格,方案 A 是正解。和 helix/oracle/sentinel 是同一层级的设计。
实际操作步骤
Step 1: 安装 QQ Bot 插件
openclaw plugins install @openclaw/qqbot
然后配置 AppID 和 AppSecret(需要去 QQ 开放平台 创建 bot 获取)。
Step 2: 创建新 Agent 的目录结构
参考现有 agent 的结构(以 helix 为例):
~/.openclaw/agents/<新Agent名>/agent/
├── models.json # 模型配置(可继承全局或独立)
└── plugins/ # 可选插件
~/.openclaw/workspace-<新Agent名>/
├── SOUL.md # ⬅ 自定义人格
├── MEMORY.md # ⬅ 独立记忆
├── IDENTITY.md # ⬅ 独立身份
└── ... # 其他 workspace 文件
Step 3: 在 openclaw.json 注册 Agent 和渠道绑定
{
agents: {
list: [
// ... 现有 ...
{
"id": "你的Agent名",
"name": "名字",
"channel": "qqbot", // ⬅ 绑定 QQ 渠道
"account": "default", // 如果有多个 QQ bot 账号可以指定
"workspace": "/Users/guchen/.openclaw/workspace-你的Agent名",
"agentDir": "/Users/guchen/.openclaw/agents/你的Agent名/agent",
"model": {
"primary": "deepseek/deepseek-v4-flash",
"fallbacks": ["lkeap/glm-5"]
}
}
]
},
channels: {
qqbot: {
enabled: true,
appId: "你的AppID",
clientSecret: "***",
// 或者配置只让某些人私聊
dmPolicy: "allowlist",
allowFrom: ["你的QQ_OpenID"]
}
}
}
Step 4: 写 SOUL.md 和 IDENTITY.md(人格定义)
全新人格的核心就在这里。你想要什么风格?随口说说我帮你写一个。
Step 5: 重启网关生效
openclaw gateway restart
几个需要你确认的点
- 名字叫什么? — 新 Agent 你想起什么名(如
iris、nova、echo、随你) - 人格风格? — 想要什么样的性格?更毒舌?更温柔?更技术向?更话痨?
- 用哪个模型? — 继承默认的 deepseek V4 Flash,还是用别的?
- QQ Bot 你有账号了吗? — 需要先到 QQ 开放平台 创建 bot,拿到 AppID 和 AppSecret