234 lines
7.5 KiB
Markdown
234 lines
7.5 KiB
Markdown
# 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 渠道
|
|
|
|
### 这件事需要两个层面来完成
|
|
|
|
1. **先搞定 QQ 渠道** — 安装 QQ Bot 插件，连上你的 bot
|
|
2. **再创建独立 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 插件
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/qqbot
|
|
```
|
|
|
|
然后配置 AppID 和 AppSecret（需要去 [QQ 开放平台](https://q.qq.com/) 创建 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 和渠道绑定
|
|
|
|
```json5
|
|
{
|
|
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: 重启网关生效
|
|
|
|
```bash
|
|
openclaw gateway restart
|
|
```
|
|
|
|
---
|
|
|
|
### 几个需要你确认的点
|
|
|
|
1. **名字叫什么？** — 新 Agent 你想起什么名（如 `iris`、`nova`、`echo`、随你）
|
|
2. **人格风格？** — 想要什么样的性格？更毒舌？更温柔？更技术向？更话痨？
|
|
3. **用哪个模型？** — 继承默认的 deepseek V4 Flash，还是用别的？
|
|
4. **QQ Bot 你有账号了吗？** — 需要先到 [QQ 开放平台](https://q.qq.com/) 创建 bot，拿到 AppID 和 AppSecret
|
|
assistant: 好了，信息够全了。以下是完整方案：
|
|
|
|
---
|
|
|
|
## 你要的东西：全新 Agent + QQ 渠道
|
|
|
|
### 这件事需要两个层面来完成
|
|
|
|
1. **先搞定 QQ 渠道** — 安装 QQ Bot 插件，连上你的 bot
|
|
2. **再创建独立 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 插件
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/qqbot
|
|
```
|
|
|
|
然后配置 AppID 和 AppSecret（需要去 [QQ 开放平台](https://q.qq.com/) 创建 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 和渠道绑定
|
|
|
|
```json5
|
|
{
|
|
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: 重启网关生效
|
|
|
|
```bash
|
|
openclaw gateway restart
|
|
```
|
|
|
|
---
|
|
|
|
### 几个需要你确认的点
|
|
|
|
1. **名字叫什么？** — 新 Agent 你想起什么名（如 `iris`、`nova`、`echo`、随你）
|
|
2. **人格风格？** — 想要什么样的性格？更毒舌？更温柔？更技术向？更话痨？
|
|
3. **用哪个模型？** — 继承默认的 deepseek V4 Flash，还是用别的？
|
|
4. **QQ Bot 你有账号了吗？** — 需要先到 [QQ 开放平台](https://q.qq.com/) 创建 bot，拿到 AppID 和 AppSecret
|