Setup & Installation
openclaw skills install @gu-heping/onebot-adapter
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install onebot-adapter
What This Skill Does
Bridges OpenClaw to OneBot protocol servers for QQ bot functionality. Supports WebSocket for real-time bidirectional messaging and HTTP for simple send operations. Handles both private and group QQ messages.
OneBot is a standardized protocol, so this adapter works with any compliant server without tying you to a proprietary QQ API.
When to use it
- Sending automated QQ notifications to individual users
- Routing QQ group messages to an AI agent for replies
- Polling friend and group lists for contact sync
- Triggering QQ messages from external workflows or scripts
- Monitoring QQ group events in real time via WebSocket
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Send 'Meeting in 10 minutes' to QQ group 789012
AGENT
- 1Initialize OneBotClient with configured HTTP URL and token
- 2Call send_group_msg with group_id=789012 and the message text
- 3Check response for delivery confirmation
- 4Return success status to user
OUTPUT
Message delivered to QQ group 789012
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
NapCat or other OneBot-compatible server installed and runningQQ account configured with the OneBot serverONEBOT_WS_URL environment variableONEBOT_HTTP_URL environment variableONEBOT_TOKEN environment variable (if authentication is enabled)