UPGRADE_GUIDE.md

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):

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:

# 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 .).

# 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

# 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

cd /path/to/openclaw-qqbot
npm install --omit=dev
openclaw plugins install .

C. Configure channel (required for first install)

openclaw channels add --channel qqbot --token "appid:appsecret"

D. Restart gateway

openclaw gateway restart

E. Verify

openclaw plugins list
openclaw channels list
openclaw logs --follow