Skill

hermes-qq

Patches Hermes Agent main branch repository to add QQ Bot support, including text/images/audio/video/file sending, platform config, and tool integration. Runs tests post-install.

Python

automation

backend

npx claudepluginhub chujianyun/skills --plugin hermes-qq

Tool Access

This skill uses the workspace's default tool permissions.

Preview

这个技能用于把 **Hermes Agent 的 `main` 正式代码** 补成支持 QQ platform 的版本。

Supporting Assets

assets/qq.pyreferences/verification.mdscripts/install_hermes_qq.py

SKILL.md

Similar Skills

Awesome Hermes Agent

Guides Hermes Agent installation and configuration: clone Python repo, pip/uv install, set OpenAI/Anthropic/OpenRouter keys, enable Telegram/Discord bots.

aradotso-trending-skills-37

hermes-ops

538

Troubleshoots Hermes Agent ops issues like gateway failures, platform drops, cron non-execution, profile config chaos, and inactive skills/tools via hermes CLI commands in check-locate-fix-verify steps.

1 file

hermes-qq

add-telegram

145

Adds Telegram as a channel to ClaudeClaw by merging code changes from git remote, installing grammy, setting up bot token, and configuring env for control or passive use.

claudeclaw

Stats

Stars538

Forks77

Last CommitApr 13, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Hermes QQ Installer

这个技能用于把 Hermes Agent 的 main 正式代码 补成支持 QQ platform 的版本。

适用场景：

当前仓库是 hermes-agent

用户希望在正式 main 代码上增加 QQ 渠道

需要同时支持 QQ 文本、图片、音频、视频、普通文件发送

不适用场景：

当前仓库不是 hermes-agent

用户只是想分析 QQ adapter 原理，不想改代码

仓库已经是自带 QQ 支持的分支，且不需要再次打补丁

工作流程

先确认目标仓库是 hermes-agent，并且工作树里没有会冲突的本地改动。

运行 scripts/install_hermes_qq.py，默认对当前工作目录打补丁。

如仓库有 venv，优先执行：

source venv/bin/activate && python -m pytest tests/gateway/test_platform_base.py tests/gateway/test_extract_local_files.py tests/gateway/test_send_image_file.py tests/cron/test_scheduler.py tests/gateway/test_background_command.py tests/gateway/test_internal_event_bypass_pairing.py -q -n 0

如果没有现成环境，再按仓库约定补测试环境后执行同一组定向测试。

运行方式

当前目录就是目标 hermes-agent 仓库时：

python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py

指定目标仓库时：

python /Users/liuwangyang/Documents/coding/our/skills-wuming/skills/hermes-qq/scripts/install_hermes_qq.py /path/to/hermes-agent

资源

assets/qq.py QQ adapter 完整实现，会被复制到 gateway/platforms/qq.py

references/verification.md 安装后建议执行的验证命令

如果脚本提示某个补丁锚点不存在，说明目标仓库已经偏离官方 main 太多。这种情况下不要盲写，先读 references/verification.md，再手动审查差异后补丁。