OpenClaw QQBot CLI

QQ 机器人管理命令行工具，用于管理 OpenClaw 平台上的 QQBot 插件安装与机器人配置。

系统要求

• Node.js >= 18.0.0
• 已安装 OpenClaw CLI（openclaw / clawdbot / moltbot 之一须在 PATH 中可用）
• 已存在 OpenClaw 配置文件（通常位于 ~/.openclaw/openclaw.json）

使用

推荐通过 npx 直接运行，无需全局安装，每次自动使用最新版本：

npx -y @tencent-connect/openclaw-qqbot-cli@latest

快速开始

# 进入交互向导（检测环境 → 安装/升级插件 → 管理机器人）
npx -y @tencent-connect/openclaw-qqbot-cli@latest

向导会引导你完成完整的配置流程：环境检测 → 插件安装/升级 → 扫码或手动添加机器人。

命令一览

以下示例中 openclaw-qqbot-cli 均可替换为 npx -y @tencent-connect/openclaw-qqbot-cli@latest。

| 命令 | 说明 | |------|------| | openclaw-qqbot-cli | 进入交互向导 | | openclaw-qqbot-cli update [VER] | 升级 QQBot 插件（可指定版本） | | openclaw-qqbot-cli uninstall | 卸载 QQBot 插件 | | openclaw-qqbot-cli version | 显示 CLI 版本 | | openclaw-qqbot-cli help | 显示帮助信息 |

常用选项

| 选项 | 说明 | |------|------| | -y, --yes | 跳过交互确认（用于 update 和 uninstall） | | --json | JSON 格式输出（仅 update） |

示例

# 升级插件到最新版本
npx -y @tencent-connect/openclaw-qqbot-cli@latest update

# 升级到指定版本并跳过确认
npx -y @tencent-connect/openclaw-qqbot-cli@latest update 1.7.0 -y

# 以 JSON 格式输出升级结果（适合 CI/CD）
npx -y @tencent-connect/openclaw-qqbot-cli@latest update --json

# 卸载插件（跳过确认）
npx -y @tencent-connect/openclaw-qqbot-cli@latest uninstall -y

详细文档

完整的使用指南（包括向导流程详解、升级策略、环境变量参考等）请参阅 USAGE.md。

协助与反馈

如在配置或使用过程中遇到问题，欢迎前往以下地址查阅既有议题或提交新问题：

https://github.com/tencent-connect/openclaw-qqbot/issues