@tencent-connect/openclaw-qqbot 1.5.5 → 1.5.7

package/README.md

@@ -40,6 +40,7 @@ Scan to join the QQ group chat
 | 🔄 **Hot Reload** | Install via npm with seamless hot updates |
 | 📝 **Markdown** | Full Markdown formatting support |
 | 🛠️ **Commands** | Native OpenClaw command integration |
+| 💬 **Quoted Context** | Resolve QQ `REFIDX_*` quoted messages and inject quote body into AI context |
 
 ---
 
@@ -47,6 +48,14 @@ Scan to join the QQ group chat
 
 > **Note:** This plugin serves as a **message channel** only — it relays messages between QQ and OpenClaw. Capabilities like image understanding, voice transcription, drawing, etc. depend on the **AI model** you configure and the **skills** installed in OpenClaw, not on this plugin itself.
 
+### 💬 Quoted Message Context (REFIDX)
+
+QQ quote events carry index keys (e.g. `REFIDX_xxx`) instead of full original message body. The plugin now resolves these indices from a local persistent store and injects quote context into AI input, so replies better understand “which message is being quoted”.
+
+- Inbound and outbound messages with `ref_idx` are automatically indexed.
+- Store path: `~/.openclaw/qqbot/data/ref-index.jsonl` (survives gateway restart).
+- Quote body may include text + media summary (image/voice/video/file).
+
 ### 🎙️ Voice Messages (STT)
 
 With STT configured, the plugin automatically transcribes voice messages to text before passing them to AI. The whole process is transparent to the user — sending voice feels as natural as sending text.
@@ -97,6 +106,16 @@ AI sends voice via `<qqvoice>path</qqvoice>`. Formats: mp3/wav/silk/ogg. No ffmp
 
 <img width="360" src="docs/images/21dce8bfc553ce23d1bd1b270e9c516c.jpg" alt="TTS Voice Demo" />
 
+### ⏰ Scheduled Reminder (Proactive Message)
+
+> **You**: Remind me to eat in 5 minutes
+>
+> **QQBot**: confirms the reminder first, then proactively sends a voice + text reminder when time is up
+
+This capability depends on OpenClaw cron scheduling and proactive messaging. If no reminder arrives, a common reason is QQ-side interception of bot proactive messages.
+
+<img width="360" src="docs/images/reminder.jpg" alt="Scheduled Reminder Demo" />
+
 ### 📎 File Sending
 
 > **You**: Extract chapter 1 of War and Peace and send it as a file
@@ -142,72 +161,73 @@ AI sends videos via `<qqvideo>path</qqvideo>`. Supports local files and URLs. La
 2. After scanning, tap **Agree** on your phone — you'll land on the bot configuration page.
 3. Click **Create Bot** to create a new QQ bot.
 
-<img width="1982" height="1316" alt="Clipboard_Screenshot_1772980440" src="https://github.com/user-attachments/assets/3ccb494d-6e4d-462c-9218-b4dfd43a254f" />
+<img width="720" alt="Create Bot" src="docs/images/create_robot.png" />
+
+> ⚠️ The bot will automatically appear in your QQ message list and send a first message. However, it will reply "The bot has gone to Mars" until you complete the configuration steps below.
+
+<img width="400" alt="Bot Say Hello" src="docs/images/bot_say_hello.jpg" />
 
 4. Find **AppID** and **AppSecret** on the bot's page, click **Copy** for each, and save them somewhere safe (e.g., a notepad). **AppSecret is not stored in plaintext — if you leave the page without saving it, you'll have to regenerate a new one.**
 
-<img width="1670" height="1036" alt="Clipboard_Screenshot_1772980413" src="https://github.com/user-attachments/assets/b898d171-5711-4d42-bc07-2de967b119ec" />
+<img width="720" alt="Find AppID and AppSecret" src="docs/images/find_appid_secret.png" />
 
 > For a step-by-step walkthrough with screenshots, see the [official guide](https://cloud.tencent.com/developer/article/2626045).
 
-> ⚠️ The bot will automatically appear in your QQ message list and send a first message. However, it will reply "The bot has gone to Mars" until you complete the configuration steps below.
-
-### Step 2 — Install the Plugin
+### Step 2 — Install / Upgrade the Plugin
 
-**Option A: Install via npm (Recommended)**
+**Option A: Remote One-Liner (Easiest, no clone required)**
 
 ```bash
-openclaw plugins install @tencent-connect/openclaw-qqbot@alpha
+curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh \
+  | bash -s -- --appid YOUR_APPID --secret YOUR_SECRET
 ```
 
-> After the stable release, replace `@alpha` with `@latest`.
+One command does it all: download script → cleanup old plugins → install → configure channel → restart service. Once done, open QQ and start chatting!
 
-**Option B: One-Click Install & Run**
+> `--appid` and `--secret` are **required for first-time install**. For subsequent upgrades:
+> ```bash
+> curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash
+> ```
+
+**Option B: Local Script (if you've cloned the repo)**
 
 ```bash
-git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot
-bash ./scripts/upgrade-and-run.sh --appid YOUR_APPID --secret YOUR_SECRET
-```
+# Via npm
+bash ./scripts/upgrade-via-npm.sh --appid YOUR_APPID --secret YOUR_SECRET
 
-The script handles everything: cleanup old plugins → install deps → register plugin → configure channel → start service. Once done, skip to [Step 4](#step-4--start--test).
+# Or via source
+bash ./scripts/upgrade-via-source.sh --appid YOUR_APPID --secret YOUR_SECRET
+```
 
-**Option C: Manual Step-by-Step**
+**Common flags:**
 
-```bash
-git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot
-npm install --omit=dev
-openclaw plugins install .
-```
+| Flag | Description |
+|------|-------------|
+| `--appid <id> --secret <secret>` | Configure channel (required for first install, or to change credentials) |
+| `--version <version>` | Install a specific version (npm script only) |
+| `--self-version` | Install the version from local `package.json` (npm script only) |
+| `-h` / `--help` | Show full usage |
 
-### Step 3 — Configure OpenClaw
+> Environment variables `QQBOT_APPID` / `QQBOT_SECRET` are also supported.
 
-**Option 1: CLI Wizard (Recommended)**
+**Option C: Manual Install / Upgrade**
 
 ```bash
-openclaw channels add --channel qqbot --token "AppID:AppSecret"
-```
+# Uninstall old plugins (skip if first install)
+openclaw plugins uninstall qqbot
+openclaw plugins uninstall openclaw-qqbot
 
-**Option 2: Edit Config File**
+# Install latest
+openclaw plugins install @tencent-connect/openclaw-qqbot@latest
 
-Edit `~/.openclaw/openclaw.json`:
+# Configure channel (first install only)
+openclaw channels add --channel qqbot --token "AppID:AppSecret"
 
-```json
-{
-  "channels": {
-    "qqbot": {
-      "enabled": true,
-      "appId": "Your AppID",
-      "clientSecret": "Your AppSecret"
-    }
-  }
-}
+# Start / restart
+openclaw gateway restart
 ```
 
-### Step 4 — Start & Test
-
-```bash
-openclaw gateway
-```
+### Step 3 — Test
 
 Open QQ, find your bot, and send a message!
 
@@ -356,120 +376,9 @@ STT supports two-level configuration with priority fallback:
 
 ---
 
-## 🔄 Upgrade
-
-### Option 1: Upgrade via npm (Recommended)
-
-```bash
-bash ./scripts/npm-upgrade.sh
-```
-
-The script automatically backs up channel config → uninstalls old plugins → installs new version → restores config → restarts gateway.
-
-```bash
-# Specify tag
-bash ./scripts/npm-upgrade.sh --tag alpha
-
-# Specify exact version
-bash ./scripts/npm-upgrade.sh --version 1.0.0-alpha.0
-```
-
-### Option 2: Upgrade via Source
-
-Run the one-click script to upgrade and restart:
-
-```bash
-bash ./scripts/upgrade-and-run.sh
-```
-
-When no `--appid` / `--secret` is provided, the script reads existing config from `~/.openclaw/openclaw.json` automatically.
-
-```bash
-# First-time or override credentials
-bash ./scripts/upgrade-and-run.sh --appid YOUR_APPID --secret YOUR_SECRET
-```
-
-<details>
-<summary>Full Options</summary>
-
-| Option | Description |
-|--------|-------------|
-| `--appid <id>` | QQ Bot AppID |
-| `--secret <secret>` | QQ Bot AppSecret |
-| `--markdown <yes\|no>` | Enable Markdown format (default: no) |
-| `-h, --help` | Show help |
-
-Environment variables `QQBOT_APPID`, `QQBOT_SECRET`, `QQBOT_TOKEN` (AppID:Secret) are also supported.
-
-</details>
-
----
-
-## 🔀 Migrating from Legacy Plugins
-
-If you previously installed `qqbot`, `@sliverp/qqbot`, `@tencent-connect/qqbot`, or other related legacy plugins, you need to uninstall the old plugin before installing the new version.
-
-### Recommended: Use npm-upgrade Script (Automatic)
-
-```bash
-bash ./scripts/npm-upgrade.sh
-```
-
-The script automatically uninstalls all legacy plugin variants (`qqbot`, `@sliverp/qqbot`, `openclaw-qq`, etc.), cleans up residual directories, and backs up/restores channel config.
-
-### Manual Migration
-
-**1. Back up your channel config**
-
-Save the `channels.qqbot` section from `~/.openclaw/openclaw.json` (including `appId`, `clientSecret`, `allowFrom`, etc.) — you'll need to restore it later.
-
-**2. Uninstall old plugins**
-
-Run the appropriate uninstall command(s) based on what you had installed:
-
-```bash
-# Uninstall legacy plugin variants (pick the ones that apply)
-openclaw plugins uninstall qqbot
-openclaw plugins uninstall @sliverp/qqbot
-openclaw plugins uninstall @tencent-connect/qqbot
-openclaw plugins uninstall openclaw-qqbot
-openclaw plugins uninstall openclaw-qq
-```
-
-If `plugins uninstall` doesn't fully clean up, manually remove residual directories:
-
-```bash
-rm -rf ~/.openclaw/extensions/qqbot
-rm -rf ~/.openclaw/extensions/openclaw-qqbot
-rm -rf ~/.openclaw/extensions/openclaw-qq
-```
-
-**3. Temporarily remove channel config**
-
-> ⚠️ Important: `openclaw plugins install` validates the config file. If `channels.qqbot` exists but no plugin provides that channel, it will fail with `unknown channel id: qqbot`.
-
-Before installing, temporarily remove the `channels.qqbot` section from `~/.openclaw/openclaw.json`.
-
-**4. Install the new version**
-
-```bash
-openclaw plugins install @tencent-connect/openclaw-qqbot@alpha
-```
-
-**5. Restore channel config**
-
-Write back the previously saved `channels.qqbot` config to `~/.openclaw/openclaw.json`.
-
-**6. Restart the gateway**
-
-```bash
-openclaw gateway restart
-```
-
----
-
 ## 📚 Documentation & Links
 
+- [Upgrade Guide](docs/UPGRADE_GUIDE.md) — full upgrade paths and migration notes
 - [Command Reference](docs/commands.md) — OpenClaw CLI commands
 - [Changelog](CHANGELOG.md) — release notes
 

package/README.zh.md

@@ -37,6 +37,7 @@
 | 🔄 **热更新** | 支持 npm 方式安装和无缝热更新 |
 | 📝 **Markdown** | 完整支持 Markdown 格式消息 |
 | 🛠️ **原生命令** | 支持 OpenClaw 原生命令 |
+| 💬 **引用上下文** | 解析 QQ `REFIDX_*` 引用消息，并将引用内容注入 AI 上下文 |
 
 ---
 
@@ -44,6 +45,14 @@
 
 > **说明：** 本插件仅作为**消息通道**，负责在 QQ 和 OpenClaw 之间传递消息。图片理解、语音转录、AI 画图等能力取决于你配置的 **AI 模型**以及在 OpenClaw 中安装的 **skill**，而非插件本身提供。
 
+### 💬 引用消息上下文（REFIDX）
+
+QQ 的引用事件通常只携带索引键（如 `REFIDX_xxx`），不直接返回原始消息全文。插件已支持从本地持久化索引中解析引用内容，并注入 AI 上下文，帮助模型更准确理解“用户引用的是哪条消息”。
+
+- 入站/出站消息中的 `ref_idx` 会自动建立索引。
+- 存储位置：`~/.openclaw/qqbot/data/ref-index.jsonl`（网关重启后仍可恢复）。
+- 引用内容支持文本 + 媒体摘要（图片/语音/视频/文件）。
+
 ### 🎙️ 语音消息（STT）
 
 配置 STT 后，插件会自动将语音转录为文字再交给 AI 处理。整个过程对用户完全透明——发语音就像发文字一样自然，AI 听得懂你在说什么。
@@ -94,6 +103,16 @@ AI 通过 `<qqvoice>路径</qqvoice>` 发送语音消息。格式：mp3/wav/silk
 
 <img width="360" src="docs/images/21dce8bfc553ce23d1bd1b270e9c516c.jpg" alt="发语音演示" />
 
+### ⏰ 定时提醒（主动消息）
+
+> **你**：5分钟后提醒我吃饭
+>
+> **QQBot**：先确认已创建提醒，到点后再主动推送语音 + 文本提醒
+
+该能力依赖 OpenClaw cron 调度与主动消息能力。若未收到提醒，常见原因是 QQ 侧拦截了机器人主动消息。
+
+<img width="360" src="docs/images/reminder.jpg" alt="定时提醒演示" />
+
 ### 📎 文件发送
 
 > **你**：战争与和平的第一章截取一下发文件给我
@@ -139,72 +158,73 @@ AI 通过 `<qqvideo>路径</qqvideo>` 发送视频，支持本地文件和公网
 2. 手机 QQ 扫码后选择**同意**，即完成注册，进入 QQ 机器人配置页。
 3. 点击**创建机器人**，即可直接新建一个 QQ 机器人。
 
-<img width="1982" height="1316" alt="Clipboard_Screenshot_1772980440" src="https://github.com/user-attachments/assets/3ccb494d-6e4d-462c-9218-b4dfd43a254f" />
+<img width="720" alt="创建机器人" src="docs/images/create_robot.png" />
+
+> ⚠️ 机器人创建后会自动出现在你的 QQ 消息列表中，并发送第一条消息。但在完成下面的配置之前，发消息会提示"该机器人去火星了"，属于正常现象。
+
+<img width="400" alt="机器人打招呼" src="docs/images/bot_say_hello.jpg" />
 
 4. 在机器人页面中找到 **AppID** 和 **AppSecret**，分别点击右侧**复制**按钮，保存到记事本或备忘录中。**AppSecret 不支持明文保存，离开页面后再查看会强制重置，请务必妥善保存。**
 
-<img width="1670" height="1036" alt="Clipboard_Screenshot_1772980413" src="https://github.com/user-attachments/assets/b898d171-5711-4d42-bc07-2de967b119ec" />
+<img width="720" alt="找到 AppID 和 AppSecret" src="docs/images/find_appid_secret.png" />
 
 > 详细图文教程请参阅 [官方指南](https://cloud.tencent.com/developer/article/2626045)。
 
-> ⚠️ 机器人创建后会自动出现在你的 QQ 消息列表中，并发送第一条消息。但在完成下面的配置之前，发消息会提示"该机器人去火星了"，属于正常现象。
-
-### 第二步 — 安装插件
+### 第二步 — 安装 / 升级插件
 
-**方式一：通过 npm 安装（推荐）**
+**方式一：远程一键执行（最简单，无需 clone 仓库）**
 
 ```bash
-openclaw plugins install @tencent-connect/openclaw-qqbot@alpha
+curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh \
+  | bash -s -- --appid YOUR_APPID --secret YOUR_SECRET
 ```
 
-> 正式版发布后可使用 `@latest` 替代 `@alpha`。
+一行命令搞定：下载脚本 → 清理旧插件 → 安装 → 配置通道 → 启动服务。完成后打开 QQ 即可开始聊天！
 
-**方式二：一键安装并启动**
+> 首次安装**必须**传 `--appid` 和 `--secret`。后续升级如已有配置：
+> ```bash
+> curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash
+> ```
+
+**方式二：本地脚本（已 clone 仓库时使用）**
 
 ```bash
-git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot
-bash ./scripts/upgrade-and-run.sh --appid YOUR_APPID --secret YOUR_SECRET
-```
+# 通过 npm 安装
+bash ./scripts/upgrade-via-npm.sh --appid YOUR_APPID --secret YOUR_SECRET
 
-脚本会自动完成：清理旧插件 → 安装依赖 → 注册插件 → 配置通道 → 启动服务。完成后可直接跳到[第四步](#第四步--启动并测试)。
+# 或通过源码安装
+bash ./scripts/upgrade-via-source.sh --appid YOUR_APPID --secret YOUR_SECRET
+```
 
-**方式三：手动分步安装**
+**常用参数：**
 
-```bash
-git clone https://github.com/tencent-connect/openclaw-qqbot.git && cd openclaw-qqbot
-npm install --omit=dev
-openclaw plugins install .
-```
+| 参数 | 说明 |
+|------|------|
+| `--appid <id> --secret <secret>` | 配置通道（首次安装必填，或更换凭证时使用） |
+| `--version <版本号>` | 安装指定版本（仅 npm 脚本） |
+| `--self-version` | 安装本地 `package.json` 中的版本（仅 npm 脚本） |
+| `-h` / `--help` | 查看完整用法 |
 
-### 第三步 — 配置 OpenClaw
+> 也可通过环境变量 `QQBOT_APPID` / `QQBOT_SECRET` 设置。
 
-**方式一：通过 Wizard 配置（推荐）**
+**方式三：手动安装 / 升级**
 
 ```bash
-openclaw channels add --channel qqbot --token "AppID:AppSecret"
-```
+# 卸载旧插件（首次安装可跳过）
+openclaw plugins uninstall qqbot
+openclaw plugins uninstall openclaw-qqbot
 
-**方式二：编辑配置文件**
+# 安装最新版本
+openclaw plugins install @tencent-connect/openclaw-qqbot@latest
 
-编辑 `~/.openclaw/openclaw.json`：
+# 配置通道（首次安装必做）
+openclaw channels add --channel qqbot --token "AppID:AppSecret"
 
-```json
-{
-  "channels": {
-    "qqbot": {
-      "enabled": true,
-      "appId": "你的 AppID",
-      "clientSecret": "你的 AppSecret"
-    }
-  }
-}
+# 启动 / 重启
+openclaw gateway restart
 ```
 
-### 第四步 — 启动与测试
-
-```bash
-openclaw gateway
-```
+### 第三步 — 测试
 
 打开 QQ，找到你的机器人，发条消息试试！
 
@@ -353,120 +373,9 @@ STT 支持两级配置，按优先级查找：
 
 ---
 
-## 🔄 升级
-
-### 方式一：通过 npm 升级（推荐）
-
-```bash
-bash ./scripts/npm-upgrade.sh
-```
-
-脚本会自动备份通道配置 → 卸载旧插件 → 安装新版本 → 恢复配置 → 重启网关。
-
-```bash
-# 指定 tag
-bash ./scripts/npm-upgrade.sh --tag alpha
-
-# 指定版本号
-bash ./scripts/npm-upgrade.sh --version 1.0.0-alpha.0
-```
-
-### 方式二：通过源码升级
-
-运行一键脚本即可升级并重启：
-
-```bash
-bash ./scripts/upgrade-and-run.sh
-```
-
-不传 `--appid` / `--secret` 参数时，脚本会自动读取 `~/.openclaw/openclaw.json` 中已有的配置。
-
-```bash
-# 首次配置或需要覆盖时
-bash ./scripts/upgrade-and-run.sh --appid YOUR_APPID --secret YOUR_SECRET
-```
-
-<details>
-<summary>完整选项</summary>
-
-| 选项 | 说明 |
-|------|------|
-| `--appid <id>` | QQ 机器人 AppID |
-| `--secret <secret>` | QQ 机器人 AppSecret |
-| `--markdown <yes\|no>` | 是否启用 Markdown 消息格式（默认: no） |
-| `-h, --help` | 显示帮助 |
-
-也支持环境变量：`QQBOT_APPID`、`QQBOT_SECRET`、`QQBOT_TOKEN`（AppID:Secret）。
-
-</details>
-
----
-
-## 🔀 从旧版插件迁移
-
-如果你之前安装的是 `qqbot`、`@sliverp/qqbot`、`@tencent-connect/qqbot` 等关联插件，需要先卸载旧插件再安装新版本。
-
-### 推荐：使用 npm-upgrade 脚本（自动处理）
-
-```bash
-bash ./scripts/npm-upgrade.sh
-```
-
-脚本会自动卸载所有历史版本的插件（`qqbot`、`@sliverp/qqbot`、`openclaw-qq` 等）、清理残留目录、备份恢复通道配置。
-
-### 手动迁移
-
-**1. 备份你的通道配置**
-
-先记录 `~/.openclaw/openclaw.json` 中 `channels.qqbot` 的内容（`appId`、`clientSecret`、`allowFrom` 等），后续需要恢复。
-
-**2. 卸载旧插件**
-
-根据你之前安装的插件名，执行对应的卸载命令：
-
-```bash
-# 卸载可能存在的旧版插件（按实际情况选择）
-openclaw plugins uninstall qqbot
-openclaw plugins uninstall @sliverp/qqbot
-openclaw plugins uninstall @tencent-connect/qqbot
-openclaw plugins uninstall openclaw-qqbot
-openclaw plugins uninstall openclaw-qq
-```
-
-如果 `plugins uninstall` 未能完全清理，手动删除残留目录：
-
-```bash
-rm -rf ~/.openclaw/extensions/qqbot
-rm -rf ~/.openclaw/extensions/openclaw-qqbot
-rm -rf ~/.openclaw/extensions/openclaw-qq
-```
-
-**3. 临时移除通道配置**
-
-> ⚠️ 重要：`openclaw plugins install` 会校验配置文件。如果配置中存在 `channels.qqbot` 但对应插件尚未安装，会报 `unknown channel id: qqbot` 错误并拒绝安装。
-
-安装前需要临时从 `~/.openclaw/openclaw.json` 中移除 `channels.qqbot` 配置段。
-
-**4. 安装新版本**
-
-```bash
-openclaw plugins install @tencent-connect/openclaw-qqbot@alpha
-```
-
-**5. 恢复通道配置**
-
-将之前备份的 `channels.qqbot` 配置写回 `~/.openclaw/openclaw.json`。
-
-**6. 重启网关**
-
-```bash
-openclaw gateway restart
-```
-
----
-
 ## 📚 文档与链接
 
+- [升级指南](docs/UPGRADE_GUIDE.zh.md) — 完整升级路径与迁移说明
 - [命令参考](docs/commands.md) — OpenClaw CLI 常用命令
 - [更新日志](CHANGELOG.md) — 各版本变更记录
 

package/bin/qqbot-cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * QQBot CLI - 用于升级和管理 QQBot 插件
+ * qqbot CLI - 用于升级和管理 qqbot 插件
  * 
  * 用法:
  *   npx openclaw-qqbot upgrade    # 升级插件
@@ -131,7 +131,7 @@ function runCommand(cmd, args = []) {
 
 // 升级命令
 function upgrade() {
-  console.log('=== QQBot 插件升级脚本 ===');
+  console.log('=== qqbot 插件升级脚本 ===');
 
   let foundInstallation = null;
   let savedConfig = null;
@@ -175,7 +175,7 @@ function upgrade() {
     }
   } else {
     console.log('未找到已保存的 qqbot 配置，请手动配置:');
-    console.log(`  ${foundInstallation} channels add --channel qqbot --token "AppID:AppSecret"`);
+    console.log(`  ${foundInstallation} channels add --channel qqbot --token "appid:appsecret"`);
     return;
   }
 
@@ -186,7 +186,7 @@ function upgrade() {
 
 // 安装命令
 function install() {
-  console.log('=== QQBot 插件安装 ===');
+  console.log('=== qqbot 插件安装 ===');
 
   const cmd = detectInstallation();
   if (!cmd) {
@@ -200,13 +200,13 @@ function install() {
 
   console.log('\n=== 安装完成 ===');
   console.log('\n请配置机器人通道:');
-  console.log(`  ${cmd} channels add --channel qqbot --token "AppID:AppSecret"`);
+  console.log(`  ${cmd} channels add --channel qqbot --token "appid:appsecret"`);
 }
 
 // 显示帮助
 function showHelp() {
   console.log(`
-QQBot CLI - QQ机器人插件管理工具
+qqbot CLI - QQ机器人插件管理工具
 
 用法:
   npx openclaw-qqbot <命令>