skills.rest
AmirulAndalib
AmirulAndalibCOMMUNITY
Explore all skills by this author →
GitHub

qqbot-channel

Manages QQ guilds, channels, members, announcements, forum posts, and schedules via the QQ Open Platform HTTP API.

Updated Jun 19, 2026
Search Tags:#announcements#schedules#channel management#qq bot#forum posts#qq open platform#guild api
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill qqbot-channel-amirulandalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qqbot-channel
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/extensions/qqbot/skills/qqbot-channel
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill qqbot-channel-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing QQ guilds (channels) programmatically requires handling token authentication, pagination, permission scopes, and dozens of distinct API endpoints. This Skill wraps the QQ Open Platform HTTP API behind a single authenticated proxy tool so you can list guilds, manage sub-channels, inspect members, publish announcements and forum posts, and maintain schedules without manually handling credentials. ## Core Features & Use Cases - Guild & Channel Management: List guilds, create/modify/delete sub-channels (text, voice, forum, live), and query API permissions. - Member & Announcement Operations: Paginate member lists, inspect member details and roles, check online counts, and publish or remove announcements including recommended-channel announcements. - Forum & Schedule Workflows: Publish and comment on forum threads (Markdown/HTML formats) and create, update, or delete channel schedules with reminder settings. - Use Case: A community manager asks the assistant to create a new text sub-channel, post a Markdown announcement in the forum channel, and schedule a weekly meeting reminder — all executed through authenticated API calls with built-in error-code guidance. ## Quick Start Ask the assistant to list all my QQ guilds and their sub-channels using the qqbot channel API.

Frequently Asked Questions about qqbot-channel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list QQ guilds and channels with a bot?▼

Call GET /users/@me/guilds to retrieve the guild list with pagination via before/after/limit parameters, then call GET /guilds/{guild_id}/channels for each guild's sub-channels. The qqbot_channel_api tool fills the Authorization header automatically.

How do I publish a forum post on QQ Open Platform?▼

Send PUT /channels/{channel_id}/threads with title, content, and format (1=text, 2=HTML, 3=Markdown, 4=JSON). The channel must be a forum sub-channel (type 10007) and the bot must operate in private-domain mode.

Does the QQ channel API require special bot permissions?▼

Yes. Forum operations, member lists, and channel creation require a private-domain bot, and schedule or channel management needs admin permissions. Query GET /guilds/{guild_id}/api_permission to check which endpoints are authorized.

Why does the QQ API return error code 11241 or 11242?▼

Error 11241 means the bot lacks API permission for that guild endpoint; apply for permission on the QQ Open Platform. Error 11242 means the endpoint is restricted to private-domain bots, so switch the bot mode in the platform settings.

How do I paginate the QQ guild member list?▼

Call GET /guilds/{guild_id}/members with after=0 and limit up to 400, then pass the last returned user.id as after for the next page until an empty array returns. Deduplicate results by user.id since duplicates may appear.

What are the rate limits for QQ channel schedules?▼

Schedule creation is limited to 10 operations per administrator per day and 100 per channel per day, returning error 11281 when exceeded. Timestamps must be millisecond strings and deletions are irreversible.

Related Skills

Explore More Software Engineering Skills→
JEROME-PRAKASH-LJEROME-PRAKASH-L
1

qqbot-channel

Manages QQ guilds, channels, members, announcements, forum posts, and schedules via the QQ Open Platform HTTP API.

Community
Intermediate
brikkoAIbrikkoAI
1

qqbot-channel

Automate QQ guild, sub-channel, member, announcement, forum, and event administration via the HTTP API.

Official
Intermediate
tencent-connecttencent-connect
1.5k

qqbot-channel

Manages QQ Guild channels, members, forum posts, announcements, and schedules via QQ Open Platform API.

Official
Intermediate
NebulaMaoNebulaMao
13

add-qq

Integrate QQ bot communication into NanoClaw via the QQ Open Platform WebSocket.

Community
Intermediate