napcat-qq

Route QQ messaging and NapCat structured interface calls through the napcat plugin API.

8|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/HappyLadySauce/openclaw-napcat-plugin-plus --skill napcat-qq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: napcat-qq
Source: https://github.com/HappyLadySauce/openclaw-napcat-plugin-plus/tree/main/skill/napcat-qq
Command: npx skills add https://github.com/HappyLadySauce/openclaw-napcat-plugin-plus --skill napcat-qq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

此技能在 OpenClaw 中强制使用 napcat 插件 API 来处理 QQ 消息和 NapCat 的结构化接口调用,并严格按照 target / action target 规则生成参数,从而避免路由错乱和参数不一致的问题。

Core Features & Use Cases

  • 强制使用 napcat 插件 API 的消息发送与接口调用,包括发送私聊/群聊消息、查看好友/陌生人信息、处理好友申请、群申请/邀请、查看群成员、以及 OCR、状态查询等扩展功能。
  • 支持通过结构化 action 调用执行群管理、文件上传/下载、流式传输等复杂任务,并且优先使用已有上下文中的媒体标识减少重复查询。
  • 提供严格的会话目标与参数校验,确保 session 基于 private/group 的正确目标,并在必要时提示用户确认关键操作以避免副作用。

Quick Start

向 NapCat 结构化接口发送请求时,将 target 设置为 action:<接口名>,在 text 中提供 JSON 参数,并将 channel 设置为 napcat。

Frequently Asked Questions about napcat-qq

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

FAQPage Schema
How do I send QQ messages through NapCat structured interfaces in OpenClaw?

To send QQ messages, set the target to action:<interface_name>, provide JSON parameters in the text field, and explicitly set channel to napcat. This routing ensures correct message delivery via the napcat plugin API.

What does forcing the napcat plugin API solve for QQ messaging routing?

Forcing the napcat plugin API solves QQ messaging routing errors and parameter inconsistencies by strictly validating session targets and structured action calls, ensuring safe execution and preventing misrouted requests within OpenClaw.

Can I manage QQ groups and handle friend requests using NapCat action targets?

Yes, you can manage QQ groups and handle friend or group requests by routing structured action calls through the napcat plugin API. It supports querying group members, processing invitations, and executing group management tasks safely.

Does the NapCat QQ bridge support file uploads and media streaming?

Yes, the NapCat QQ bridge supports file uploads, downloads, and media streaming through structured action calls. It prioritizes existing media identifiers in the context to reduce redundant queries during complex task execution.

What are the limitations when routing NapCat structured interface calls?

Limitations include strict requirements for validated session or target formats based on private or group contexts. Critical operations require explicit user confirmation to prevent unintended side effects, and incorrect channel settings will disrupt routing.