add-qq

name	add-qq
description	Add QQ Channel to NanoClaw. Enables QQ bot communication through QQ Open Platform (https://bot.q.qq.com). Set to 'true' to enable, 'false` to disable. Triggers on "setup qq", "add qq bot", "configure qq channel".

---

Add QQ Channel

description: Add QQ 机器人渠道到 NanoClaw。 使用 QQ 开放平台 WebSocket 模式进行通信。 需要在 QQ 开放平台创建机器人并获取凭证。

---

Setup Steps

1. Add to .env file:

QQ_APP_ID=your_appid
QQ_CLIENT_SECRET=your_secret
QQ_SANDBOX=true
QQ_AUTO_REGISTER=true
ENABLE_WHATSAPP=false

2 Run npx tsx setup/index.ts --step qq-auth -- --appid $APPID --secret $SECRET --sandbox true --auto-register true

2 Check `.env` for these settings and show log output for confirmation.
4. Build and image (if needed): `npx tsx setup/index.ts --step container` --runtime docker`

4. Verify the connection works by sending a test message

5. Provide troubleshooting guidance

Usage

1. 用户请求 /setup-qq， providing setup guidance and including environment variables and2. creating .env template if missing
2. Run the setup steps to sequence to3. Monitor the logs with tail -f logs/nanoclaw.log

Troubleshooting

No response to QQ messages:

1. Check trigger pattern in main channel (no prefix needed)

2. Check logs: tail -f logs/nanoclaw.log 3 For group messages, ensure bot is @mentioned Check DB: with npx tsx setup/index.ts --step verify

   • QQ_CREDENTIALS=missing -> re-run setup (step 5)
   • MOUNT_ALLOWLIST=missing -> npx tsx setup/index.ts --step mounts -- --empty
   7. Build and image (if needed): npx tsx setup/index.ts --step container --runtime docker` --retry
   8. Tail logs for reconnection errors
   • Verify the connection works by sending a test message to the groups/main folder
   8. Restart service if needed
   • launchctl kickstart -k gui/$(id -u)/com.nanoclaw (macOS) or systemctl --user restart nanoclaw (Linux) or bash start-nanoclaw.sh (WSL nohup)
   9. Verify: Run npx tsx setup/index.ts --step verify and show status output