# 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