A comprehensive administrative toolkit for QQ groups using the OneBot 11 API protocol.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install onebot-group-admin
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install onebot-group-admin using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OneBot Group Admin?
The OneBot Group Admin skill provides a robust interface for AI agents to manage QQ groups through the OneBot 11 API. By utilizing the Openclaw Skills framework, this tool enables programmatic control over group settings, member permissions, and moderation tasks. It is designed to work seamlessly with implementations like NapCat or go-cqhttp, bridging the gap between AI logic and real-time community management.
This skill allows developers to integrate complex moderation workflows into their AI agents. Whether you need to update group metadata or enforce community guidelines, this Openclaw Skills extension handles the technical overhead of WebSocket communication and API parameter mapping, providing a clean CLI-based interface for all group administrative actions.
OneBot Group Admin Use Cases
- Automating group moderation by banning or kicking users based on AI-detected policy violations.
- Scheduling group announcements and updating group names or portraits dynamically.
- Managing community hierarchy by programmatically assigning or removing administrator roles.
- Cleaning up group chats by revoking messages or muting members for specific durations.
- Syncing group member lists and metadata with external databases for community analytics.
How OneBot Group Admin Works
- The AI agent identifies a group management task and selects the appropriate administrative action.
- The agent invokes the
onebot-action.jsscript found within the Openclaw Skills workspace. - Parameters such as group IDs and user IDs are passed to the script, which automatically handles type conversion to integers.
- The script establishes a WebSocket connection to the configured OneBot server (defaulting to port 13001).
- The OneBot server processes the request via the QQ protocol and returns a success or failure status back to the agent.
OneBot Group Admin Setup
To integrate this into your Openclaw Skills environment, ensure you have a running OneBot 11 provider like NapCat. The script is located at ~/.openclaw/workspace/skills/onebot-group-admin/scripts/onebot-action.js.
You can configure the connection via environment variables:
export ONEBOT_WS_URL="ws://127.0.0.1:13001"
export ONEBOT_WS_TOKEN="your_token_here"
Basic usage syntax:
node onebot-action.js <action> [key=value ...]
OneBot Group Admin Data Schema & Taxonomy
The skill interacts with the OneBot 11 API schema. Key parameters used across various actions include:
| Parameter | Type | Description |
|---|---|---|
| group_id | Integer | The unique ID of the QQ group |
| user_id | Integer | The unique ID of the QQ user |
| duration | Integer | Time in seconds (used for bans) |
| enable | Boolean | 1 to activate, 0 to deactivate |
| content | String | Message or announcement text |
Actions like get_group_member_list return JSON arrays containing detailed member profiles including nicknames, roles, and join dates.
OneBot Group Admin Advanced Features
- Supports NapCat and go-cqhttp specific extensions like
_send_group_noticeandset_group_portrait. - Automatic handling of group IDs larger than 100,000,000 to prevent ID misclassification.
- Flexible file support for group portraits including local paths, base64 strings, and HTTP URLs.
- Comprehensive member management including special titles, custom cards, and invitation rejection.
- Environment-based configuration allowing for multi-instance or remote OneBot server deployments within the Openclaw Skills ecosystem.
SKILL.md
Loading
Related Openclaw Skills
1688 Product Data Scraper
A specialized automation tool to scrape 1688.com product details, including high-resolution images, full SKU lists, and technical attributes.
Xiamen Tide Calculator
A professional-grade tidal forecasting tool for the Xiamen sea area, featuring lunar conversion, beachcombing scoring, and safety recommendations.
Playwright Automation & Scraper
A powerful browser automation skill for navigating websites, interacting with UI elements, and extracting data from dynamic, JavaScript-rendered pages.
MBTI Personality for AI Agents
A dynamic personality layer for AI coding agents that adapts communication, problem-solving, and work rhythms based on MBTI types and curated presets.
Fund Investment Research Report Generator
An automated AI skill that generates professional, in-depth fund investment research reports in Markdown format using real-time financial data.
JY Financial News Interpretation
An AI-driven financial intelligence skill that transforms Juyuan MCP database records into comprehensive 24-hour news reports and market impact analyses.
Featured*
