Botpy

前文 WorkBuddy 自动化任务打通 QQ 消息推送 详细记录了从企微失败到 QQ Bot 群推送打通的完整踩坑过程。本文在此基础上，讲解如何把这个折腾了两小时的方案封装成一个标准 WorkBuddy Skill，让后续任何人（或 AI）加载后即插即用。 为什么需要封装成 Skill 打通 QQ 推送后我们手里有的东西： 资产 形态 问题 qq_get_group_openid.py Python 脚本 散落文件，凭据写死在代码里 qq_send_group_msg.py Python 脚本 同上，用法靠人记 踩坑经验 大脑记忆 下次重装系统全忘光 集成到自动化任务 Prompt 中写死路径 换个环境就要改 这些资产的共同问题：不可复制、不可分发、不可维护。 Skill 解决的就是这个——把代码、文档、踩坑经验打成一个包，放在 ~/.workbuddy/skills/ 目录下，WorkBuddy 的 AI 在合适的时机自动加载它。对人和 AI 都友好。 Skill 的文件结构 一个标准 Skill 的目录结构如下： ~/.workbuddy/skills/<skill-name>/ ├── SKILL.md # 核心文件：AI 的行为指南 + 使用文档 ├── scripts/ # 可执行脚本（Python、Shell 等） │ ├── qq_get_group_openid.py │ └── qq_send_group_msg.py ├── references/ # 参考资料（故障排查表、API 文档等） │ └── troubleshooting.md └── assets/ # 静态资源（模板文件、配置示例等） └── (按需使用) 最关键的只有一个文件：SKILL.md。它是 AI 加载 Skill 后读取的第一份文档，决定 AI 如何理解和使用这个 Skill。其余目录按需存在。 ...

✅ 本文方案已于 2026-06-28 实际验证通过 — 两个 WorkBuddy 定时自动化任务（凌晨 2:00 工作纪要、3:00 早间新闻）均已成功通过 QQ 群推送。 背景：自动化任务需要"最后一公里" 前面几篇文章分别解决了 Gitea 代码仓库、禅道项目管理、微信/企微数据读取 的 AI 接入问题。但这些解决的都是数据输入——让 AI 能读数据、查信息。 一个真正有用自动化助手还需要输出通道。具体需求： 「悟空的早间新闻推送」：每天凌晨 3:00 自动采集 AI 动态、天气、财经行情、ETF 监控，推送到手机 「温陵布衣昨日工作纪要」：每天凌晨 2:00 整理前一天的企微消息、邮件、项目日志，推送摘要 两个任务都跑得挺好，但消息一直只能写本地文件——你需要主动打开电脑去看，手机端完全收不到。这和"主动通知"的目标背道而驰。 路线一：企业微信（失败） 最自然的思路是企业微信——公司全员在用，WorkBuddy 也有企微连接器（wecom connector）。 尝试过程 企微连接器发消息：WorkBuddy 企微连接器已绑定成功，但发消息时报错 当前企业暂不支持授权机器人「消息」使用权限 管理员确认：咨询企业微信管理员，回复只有「文档」授权，没有「消息」授权 wecom-cli skill：这个 skill 本质是解密本地 SQLite 数据库，只读不写，无法发送消息 结论 企微消息推送的前提是企业管理员在企微后台开通「消息」权限。如果你的企业没有开通（多数企业内部出于安全管控不开放），企微推送这条路就彻底堵死了。无绕路方案。 📎 如果你所在企业的企微已开通消息权限，WorkBuddy 企微连接器可以直接发消息，本文后续的 QQ Bot 方案不必看。 路线二：QQ 机器人（成功） 受 OpenClaw 接入 QQ 机器人 的思路启发——OpenClaw 可以通过 QQ Bot 定时推送消息，WorkBuddy 的自动化任务同样可以。 核心技术栈： WorkBuddy 自动化任务（凌晨执行） → 采集数据、生成消息文本 → 调用 Python 脚本 → botpy SDK 连接 QQ WebSocket 认证 → 发送群消息 → 手机 QQ 收到推送 完整实施步骤 第一步：在 QQ 开放平台注册机器人 打开 QQ 开放平台，用手机 QQ 扫码登录 点击「创建机器人」，填写名称（如 YourBot-WorkBuddy） 进入机器人详情 → 开发设置 → 获取以下两个凭据： 凭据 说明 AppID 纯数字，如 YOUR_APPID AppSecret 点击「生成」获取，只显示一次，立即保存 在「开发设置 → 权限配置」中开启 「群聊消息」 权限 确认机器人状态为 「已上线」（开发中的机器人无法调用 API） ⚠️ AppSecret 只显示一次。错过了只能「重置」，旧密钥立即失效。 ...