openakita/skills@qq-channel

Manage QQ channels, sub-channels, members, and messages via the QQ Bot REST API.

2.0k|274|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill openakita-skills-qq-channel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openakita/skills@qq-channel
Source: https://github.com/openakita/openakita/tree/main/skills/qq-channel
Command: npx skills add https://github.com/openakita/openakita --skill openakita-skills-qq-channel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Managing QQ (Tencent) channels manually through the client is slow and cannot be automated. This Skill lets you operate channels, sub-channels, members, messages, announcements, and schedules programmatically through the official QQ Bot API.

Core Features & Use Cases

  • Channel & Sub-channel Management: List guilds, view channel details, and create, modify, or delete sub-channels.
  • Messaging & Announcements: Send text, image, or Markdown messages to sub-channels and manage channel announcements and schedules.
  • Member Administration: Query member lists and role-based permissions within a guild.
  • Use Case: A community manager wants to broadcast a Markdown announcement to a specific sub-channel and audit the member list; the bot authenticates with QQ_BOT_APPID and QQ_BOT_TOKEN and executes the API calls directly.

Quick Start

Set the QQ_BOT_APPID and QQ_BOT_TOKEN environment variables, then ask the assistant to list your QQ channels and send a message to a specific sub-channel.

Frequently Asked Questions about openakita/skills@qq-channel

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

FAQPage Schema
How do I send a message to a QQ channel with a bot?

Register a bot at the QQ Bot open platform (bot.q.qq.com) to get an AppID and Token, set them as QQ_BOT_APPID and QQ_BOT_TOKEN environment variables, then run the send command with the target channel ID and message content.

How to list QQ guilds and sub-channels via the QQ Bot API?

Call the /users/@me/guilds endpoint to list guilds the bot has joined, then query /guilds/{guild_id}/channels for sub-channels. The included script exposes these as the guilds and channels commands.

What credentials does the QQ Bot API require?

The API requires an AppID and Token from a bot registered on the QQ Bot open platform. Requests authenticate with an Authorization: QQBot {token} header plus an X-Union-Appid header.

Can I test QQ bot API calls in a sandbox environment?

Yes, the script supports a --sandbox flag that switches the base URL from api.sgroup.qq.com to sandbox.api.sgroup.qq.com, letting you test API calls without affecting production channels.

Why does my QQ bot API request return an HTTP error?

Errors usually come from missing or invalid QQ_BOT_APPID/QQ_BOT_TOKEN environment variables, or the bot lacking permission in the target guild. The script prints the HTTP status code and response body to help diagnose the failure.