test-mirror-qqbot 1.5.5

package/clawdbot.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "openclaw-qqbot",
+  "name": "OpenClaw QQ Bot",
+  "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
+  "channels": ["qqbot"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media"],
+  "capabilities": {
+    "proactiveMessaging": true,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/docs/UPGRADE_GUIDE.md

@@ -0,0 +1,93 @@
+# qqbot Plugin Upgrade Guide
+
+If you previously installed qqbot but are not familiar with `openclaw plugins` commands or npm operations, use the built-in scripts first.
+
+## Option 1: Recommended (Script-based upgrade)
+
+### 1) Upgrade via npm package (easiest, choose either way)
+
+**Way A — direct download and run (no clone required):**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh -o /tmp/upgrade-via-npm.sh
+bash /tmp/upgrade-via-npm.sh
+# or: bash /tmp/upgrade-via-npm.sh --version <version>
+```
+
+**Way B — run from local repository:**
+
+```bash
+# Upgrade to latest
+bash ./scripts/upgrade-via-npm.sh
+
+# Upgrade to a specific version
+bash ./scripts/upgrade-via-npm.sh --version <version>
+```
+
+> If `--version` is omitted, `latest` is used by default.
+
+### 2) One-click upgrade from local source and restart
+
+> Note: this script must be run inside this repository (it installs via `openclaw plugins install .`).
+
+```bash
+# Run directly if you already have config
+bash ./scripts/upgrade-via-source.sh
+
+# First install / first-time config (appid and secret are required)
+bash ./scripts/upgrade-via-source.sh --appid your_appid --secret your_secret
+```
+
+> Note: For first-time installation, you must provide `appid` and `secret` (or set `QQBOT_APPID` / `QQBOT_SECRET`); for subsequent upgrades with existing config, run `bash ./scripts/upgrade-via-source.sh` directly.
+
+---
+
+## Option 2: Manual upgrade (for users familiar with openclaw / npm)
+
+### A. Install latest from npm directly
+
+```bash
+# Optional: uninstall old plugins first (based on your actual installation)
+# Run `openclaw plugins list` to check installed plugin IDs
+# Common legacy plugin IDs: qqbot / openclaw-qqbot
+# Corresponding npm packages: @sliverp/qqbot / @tencent-connect/openclaw-qqbot
+openclaw plugins uninstall qqbot
+openclaw plugins uninstall openclaw-qqbot
+
+# If you installed other qqbot-related plugins, uninstall them as well
+# openclaw plugins uninstall <other-plugin-id>
+
+# Install latest
+openclaw plugins install @tencent-connect/openclaw-qqbot@latest
+
+# Or install a specific version
+openclaw plugins install @tencent-connect/openclaw-qqbot@<version>
+```
+
+### B. Install from source directory
+
+```bash
+cd /path/to/openclaw-qqbot
+npm install --omit=dev
+openclaw plugins install .
+```
+
+### C. Configure channel (required for first install)
+
+```bash
+openclaw channels add --channel qqbot --token "appid:appsecret"
+```
+
+### D. Restart gateway
+
+```bash
+openclaw gateway restart
+```
+
+### E. Verify
+
+```bash
+openclaw plugins list
+openclaw channels list
+openclaw logs --follow
+```

package/docs/UPGRADE_GUIDE.zh.md

@@ -0,0 +1,93 @@
+# qqbot 插件升级指南
+
+如果你之前安装过 qqbot 插件，但不熟悉 `openclaw plugins` 升级命令或 `npm` 操作，建议优先使用项目内置脚本。
+
+## 方式一：推荐（脚本升级）
+
+### 1) 通过 npm 包升级（最省事，二选一）
+
+**方式 A：直连下载后执行（无需 clone 仓库）**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh -o /tmp/upgrade-via-npm.sh
+bash /tmp/upgrade-via-npm.sh
+# 或：bash /tmp/upgrade-via-npm.sh --version <version>
+```
+
+**方式 B：在本地仓库内执行脚本**
+
+```bash
+# 升级到 latest
+bash ./scripts/upgrade-via-npm.sh
+
+# 指定版本
+bash ./scripts/upgrade-via-npm.sh --version <version>
+```
+
+> 不传 `--version` 时，默认使用 `latest`。
+
+### 2) 通过源码一键升级并重启
+
+> 注意：该脚本必须在当前仓库内执行（通过 `openclaw plugins install .` 安装本地源码）。
+
+```bash
+# 已有配置时可直接执行
+bash ./scripts/upgrade-via-source.sh
+
+# 首次安装/首次配置（必须提供 appid 和 secret）
+bash ./scripts/upgrade-via-source.sh --appid your_appid --secret your_secret
+```
+
+> 注意：首次安装必须设置 `appid` 和 `secret`（或设置环境变量 `QQBOT_APPID` / `QQBOT_SECRET`）；后续升级如已有配置可直接执行 `bash ./scripts/upgrade-via-source.sh`。
+
+---
+
+## 方式二：手动升级（适合熟悉 openclaw / npm 的用户）
+
+### A. 直接从 npm 安装最新版本
+
+```bash
+# 可选：先卸载旧插件（按实际安装情况执行）
+# 可先执行 `openclaw plugins list` 查看已安装插件 ID
+# 常见历史插件 ID：qqbot / openclaw-qqbot
+# 对应 npm 包：@sliverp/qqbot / @tencent-connect/openclaw-qqbot
+openclaw plugins uninstall qqbot
+openclaw plugins uninstall openclaw-qqbot
+
+# 如果你还安装过其它 qqbot 相关插件，也请一并 uninstall
+# openclaw plugins uninstall <其它插件ID>
+
+# 安装最新版本
+openclaw plugins install @tencent-connect/openclaw-qqbot@latest
+
+# 或安装指定版本
+openclaw plugins install @tencent-connect/openclaw-qqbot@<version>
+```
+
+### B. 从源码目录安装
+
+```bash
+cd /path/to/openclaw-qqbot
+npm install --omit=dev
+openclaw plugins install .
+```
+
+### C. 配置通道（首次安装必做）
+
+```bash
+openclaw channels add --channel qqbot --token "appid:appsecret"
+```
+
+### D. 重启网关
+
+```bash
+openclaw gateway restart
+```
+
+### E. 验证
+
+```bash
+openclaw plugins list
+openclaw channels list
+openclaw logs --follow
+```

package/docs/commands.md

@@ -0,0 +1,247 @@
+# openclaw 常用指令手册
+
+本文档整理了 `openclaw` 的常用命令，方便日常使用和维护。
+
+---
+
+## 📦 插件管理
+
+### 安装插件
+```bash
+# 从当前目录安装插件
+openclaw plugins install .
+
+# 从指定路径安装
+openclaw plugins install /path/to/plugin
+```
+
+### 禁用/启用插件
+```bash
+# 禁用指定插件
+openclaw plugins disable qqbot
+
+# 启用指定插件
+openclaw plugins enable qqbot
+```
+
+### 查看已安装插件
+```bash
+openclaw plugins list
+```
+
+---
+
+## 📺 通道管理
+
+### 配置 qqbot 通道
+```bash
+# qqbot 是自定义插件，通过 config set 配置（不是 channels add）
+openclaw config set channels.qqbot.appId "你的appid"
+openclaw config set channels.qqbot.clientSecret "你的appsecret"
+openclaw config set channels.qqbot.enabled true
+```
+
+> **注意**：`openclaw channels add --channel` 仅支持内置通道（telegram、discord 等）。
+> qqbot 作为自定义插件，需通过 `config set` 或直接编辑 `~/.openclaw/openclaw.json` 配置。
+
+### 禁用通道
+```bash
+openclaw config set channels.qqbot.enabled false
+```
+
+### 查看通道列表
+```bash
+openclaw channels list
+```
+
+---
+
+## 🚀 网关控制
+
+### 启动网关
+```bash
+# 普通启动
+openclaw gateway
+
+# 详细模式启动（显示更多日志）
+openclaw gateway --verbose
+```
+
+### 重启网关
+```bash
+openclaw gateway restart
+```
+
+### 停止网关
+```bash
+openclaw gateway stop
+```
+
+---
+
+## 📋 日志查看
+
+### 查看实时日志
+```bash
+# 跟踪模式（实时刷新）
+openclaw logs --follow
+
+# 普通查看
+openclaw logs
+```
+
+### 查看指定行数
+```bash
+# 查看最近 100 行日志
+openclaw logs --limit 100
+```
+
+### 其他日志选项
+```bash
+# JSON 格式输出
+openclaw logs --json
+
+# 纯文本输出（无颜色）
+openclaw logs --plain
+```
+
+---
+
+## ⚙️ 配置管理
+
+### 设置配置项
+```bash
+# 启用 markdown 消息格式
+openclaw config set channels.qqbot.markdownSupport true
+
+# 禁用 markdown 消息格式
+openclaw config set channels.qqbot.markdownSupport false
+```
+
+### 获取配置项
+```bash
+# 查看某个配置项的值
+openclaw config get channels.qqbot.markdownSupport
+```
+
+### 查看所有配置
+```bash
+openclaw config
+```
+
+---
+
+## 🛠️ 项目脚本
+
+项目中提供了一些便捷脚本，简化日常操作：
+
+### 一键升级并启动
+```bash
+# 基本用法
+./scripts/upgrade-via-source.sh
+
+# 指定 appid 和 secret
+./scripts/upgrade-via-source.sh --appid 123456789 --secret your_secret
+
+# 同时启用 markdown
+./scripts/upgrade-via-source.sh --appid 123456789 --secret your_secret --markdown yes
+
+# 查看帮助
+./scripts/upgrade-via-source.sh --help
+```
+
+**环境变量方式：**
+```bash
+export QQBOT_APPID="123456789"
+export QQBOT_SECRET="your_secret"
+export QQBOT_MARKDOWN="no"
+./scripts/upgrade-via-source.sh
+```
+
+### markdown 设置脚本
+```bash
+# 启用 markdown
+./scripts/set-markdown.sh enable
+
+# 禁用 markdown
+./scripts/set-markdown.sh disable
+
+# 查看当前状态
+./scripts/set-markdown.sh status
+
+# 交互式选择
+./scripts/set-markdown.sh
+```
+
+### 升级脚本（清理旧版本）
+```bash
+# 清理旧版本插件和配置
+bash ./scripts/cleanup-legacy-plugins.sh
+```
+
+---
+
+## 📁 常用路径
+
+| 路径 | 说明 |
+|------|------|
+| `~/.openclaw/` | openclaw 主目录 |
+| `~/.openclaw/openclaw.json` | 全局配置文件 |
+| `~/.openclaw/extensions/` | 插件安装目录 |
+| `~/.openclaw/extensions/qqbot/` | qqbot 插件目录 |
+
+---
+
+## 🔧 故障排查
+
+### 查看详细日志
+```bash
+openclaw logs --follow
+```
+
+### 检查插件状态
+```bash
+openclaw plugins list
+```
+
+### 检查通道配置
+```bash
+openclaw channels list
+```
+
+### 重新安装插件
+```bash
+# 1. 清理旧版本
+bash ./scripts/cleanup-legacy-plugins.sh
+
+# 2. 重新安装
+openclaw plugins install .
+
+# 3. 重新配置通道
+openclaw config set channels.qqbot.appId "你的appid"
+openclaw config set channels.qqbot.clientSecret "你的appsecret"
+openclaw config set channels.qqbot.enabled true
+```
+
+---
+
+## ⚠️ 注意事项
+
+1. **不要使用 sudo 运行脚本**：会导致配置文件权限问题
+2. **markdown 功能需要权限**：启用前需在 QQ 开放平台申请 markdown 消息权限
+
+---
+
+## 📚 更多帮助
+
+```bash
+# 查看 openclaw 帮助
+openclaw --help
+
+# 查看子命令帮助
+openclaw plugins --help
+openclaw channels --help
+openclaw gateway --help
+openclaw config --help
+openclaw logs --help
+```

package/index.ts

@@ -0,0 +1,31 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
+import { qqbotPlugin } from "./src/channel.js";
+import { setQQBotRuntime } from "./src/runtime.js";
+import { registerChannelTool } from "./src/tools/channel.js";
+import { registerRemindTool } from "./src/tools/remind.js";
+
+const plugin = {
+  id: "openclaw-qqbot",
+  name: "QQ Bot",
+  description: "QQ Bot channel plugin",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setQQBotRuntime(api.runtime);
+    api.registerChannel({ plugin: qqbotPlugin });
+    registerChannelTool(api);
+    registerRemindTool(api);
+  },
+};
+
+export default plugin;
+
+export { qqbotPlugin } from "./src/channel.js";
+export { setQQBotRuntime, getQQBotRuntime } from "./src/runtime.js";
+export { qqbotOnboardingAdapter } from "./src/onboarding.js";
+export * from "./src/types.js";
+export * from "./src/api.js";
+export * from "./src/config.js";
+export * from "./src/gateway.js";
+export * from "./src/outbound.js";

package/moltbot.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "openclaw-qqbot",
+  "name": "OpenClaw QQ Bot",
+  "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
+  "channels": ["qqbot"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media"],
+  "capabilities": {
+    "proactiveMessaging": true,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "openclaw-qqbot",
+  "name": "OpenClaw QQ Bot",
+  "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
+  "channels": ["qqbot"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-media"],
+  "capabilities": {
+    "proactiveMessaging": true,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "test-mirror-qqbot",
+  "version": "1.5.5",
+  "description": "<div align=\"center\">",
+  "main": "index.js",
+  "bin": {
+    "test-qqbot": "bin/qqbot-cli.js"
+  },
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hangout7461/openclaw-qqbot.git"
+  },
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/Hangout7461/openclaw-qqbot/issues"
+  },
+  "homepage": "https://github.com/Hangout7461/openclaw-qqbot#readme"
+}