skills$openclaw/napcat-qq
propersama381

by propersama

napcat-qq – OpenClaw Skill

napcat-qq is an OpenClaw Skills integration for coding workflows. 为 openclaw 发送 QQ 消息时,强制使用 napcat 插件 API,并按照私聊/群聊规则生成与校验 sessionKey。适用于“发送QQ消息”“发群消息”“发QQ私聊”等请求。

381 stars6.7k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

namenapcat-qq
description为 openclaw 发送 QQ 消息时,强制使用 napcat 插件 API,并按照私聊/群聊规则生成与校验 sessionKey。适用于“发送QQ消息”“发群消息”“发QQ私聊”等请求。 OpenClaw Skills integration.
ownerpropersama
repositorypropersama/napcat-qq
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @propersama/napcat-qq
last updatedFeb 7, 2026

Maintainer

propersama

propersama

Maintains napcat-qq in the OpenClaw Skills directory.

View GitHub profile
File Explorer
3 files
.
_meta.json
274 B
README.md
178 B
SKILL.md
1.2 KB
SKILL.md

name: napcat-qq description: "为 openclaw 发送 QQ 消息时,强制使用 napcat 插件 API,并按照私聊/群聊规则生成与校验 sessionKey。适用于“发送QQ消息”“发群消息”“发QQ私聊”等请求。"

目标

确保 openclaw 发送 QQ 消息时只使用本插件的 API,并让 sessionKey 满足 napcat 插件要求。

工作流

  1. 识别消息类型:私聊或群聊。
  2. 校验并构造 sessionKey:
    • 私聊:session:napcat:private:<QQ号>
    • 群聊:session:napcat:group:<群号>
  3. 目标写法说明(重要):
    • 群聊优先使用 target: group:<群号>target: session:napcat:group:<群号>
    • 纯数字 target 会被当作私聊用户 ID,容易导致“无法获取用户信息”。
  4. 调用 message 工具时必须显式指定 channel: "napcat",避免多通道场景下无法路由。
  5. 仅使用本插件的 API 完成发送,不要调用其他 QQ 发送途径。

交互规则

  • 若用户未提供 QQ 号或群号,先询问并明确补全后再发送。
  • 若用户提供了 sessionKey 但格式不符合规则,改写为正确格式并说明已规范化。
  • 若用户含糊描述(如“发消息给他”),优先确认私聊/群聊与目标 ID。
README.md

依赖 NapCatQQopenclaw-napcat-plugin 运行,请事先部署这 2 个项目

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install napcat-qq?

Run openclaw add @propersama/napcat-qq in your terminal. This installs napcat-qq into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/propersama/napcat-qq. Review commits and README documentation before installing.