napcat-qq
为 openclaw 发送 QQ 消息时，强制使用 napcat 插件 API，并按照私聊/群聊规则生成与校验 sessionKey。适用于“发送QQ消息”“发群消息”“发QQ私聊”等请求。
Why use this skill?
Seamlessly send QQ private and group messages via OpenClaw using the NapCatQQ API. Ensures reliable routing and secure session management for AI agents.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/propersama/napcat-qqWhat This Skill Does
The napcat-qq skill is a specialized communication adapter designed for the OpenClaw AI agent to interface reliably with the NapCatQQ plugin. It serves as a middleware layer that enforces strict session management and routing protocols for QQ messaging. By standardizing the construction of sessionKeys and channel identifiers, this skill prevents common routing errors and ensures that messages are delivered accurately to either private contacts or specific QQ groups. It acts as an abstraction layer that abstracts the complexity of NapCat's API requirements away from the end-user, ensuring consistent message delivery regardless of the underlying infrastructure state.
Installation
To install this skill, run the following command in your terminal:
clawhub install openclaw/skills/skills/propersama/napcat-qq
Ensure you have the NapCatQQ plugin configured and running on your local QQ instance before initiating the installation process to prevent connectivity issues.
Use Cases
This skill is essential for users managing automated notifications, personal AI assistants, or community management bots. Typical scenarios include:
- Automated Daily Reporting: Sending scheduled summaries to a specific QQ group.
- Personal Task Notifications: Pushing urgent reminders or alerts directly to a personal QQ account via the AI.
- Intelligent Agent Interaction: Allowing users to communicate with external APIs or services that trigger messages back to the user via QQ.
Example Prompts
- "Send a message to group 123456789 saying 'The morning server check is complete.'"
- "Please message my friend 987654321 and tell them I will be home by 7 PM."
- "Hey, send a summary of today's meeting to the internal team group."
Tips & Limitations
To ensure optimal performance, always explicitly define the target type (group or private) when interacting with the agent. The system prioritizes explicit channel: "napcat" routing; failing to use this may result in routing conflicts if multiple messaging channels are enabled. Be aware that the skill strictly follows the session:napcat:<type>:<id> format. If the agent fails to identify the correct target, providing the raw group or contact ID alongside the type will force the agent to re-validate the sessionKey. Note that this skill does not handle non-textual message media uploads directly unless supported by the underlying NapCat instance; it is optimized primarily for text-based communication flows.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-propersama-napcat-qq": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api