onebot-adapter
by gu-heping
Coding Agents & IDEsBrief
Connect OpenClaw to OneBot protocol for QQ bot integration.
Description
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
User asks: Send 'Meeting in 10 minutes' to QQ group 789012
- 1
Initialize OneBotClient with configured HTTP URL and token
- 2
Call send_group_msg with group_id=789012 and the message text
- 3
Check response for delivery confirmation
- 4
Return success status to user
Message delivered to QQ group 789012
Requirements
- NapCat or other OneBot-compatible server installed and running
- QQ account configured with the OneBot server
- ONEBOT_WS_URL environment variable
- ONEBOT_HTTP_URL environment variable
- ONEBOT_TOKEN environment variable (if authentication is enabled)
Installation
clawhub install gu-heping/onebot-adapterRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.