如何使用小光鸟 Skill

小光鸟 Skill 是面向开发者与高阶用户的对接工具，用于让 OpenClaw、Hermes、workbuddy、Codex 等支持 Skill 的 AI 工具，快速连接小光鸟公众号助手能力。通过本地脚本命令，可实现文档自动排版、配图、主题生成文章并推送至微信公众号草稿箱，打通自动化内容生产链路。

本文将完整讲解下载安装、环境依赖、账号授权、API 配置、日常发文命令、异常处理、额度规则与发布边界，新手可按步骤完整落地。

一、小光鸟 Skill 能力介绍

小光鸟 Skill 聚焦 AI 工具与公众号内容链路的衔接，提供两类核心自动化能力：

  • 存量文档整编发文：本地 Markdown 文档自动排版、适配公众号样式、可选绑定封面图，推送至公众号草稿箱。
  • 主题智能生成发文：输入创作主题与需求，自动生成完整公众号文章、配图并推送草稿。

所有操作仅完成草稿箱推送，不支持自动群发、一键发布、定时发布，最终发布需用户在微信公众号后台自主校验、预览并发送。AI 仅作为辅助创作工具，无法替代创作者内容审核与发布决策。

二、工具下载与文件说明

官方下载入口

https://www.aitools.yun/products/xiaoguangniao-wechat-official/downloads/xiaoguangniao-skill

压缩包内置文件

下载解压后，目录包含核心配置与运行文件：

  • SKILL.md：技能说明文档
  • references/api.md：接口参考文档
  • scripts/xiaoguangniao_wechat.py：核心运行脚本

三、环境依赖安装

小光鸟 Skill 基于 Python 运行，需提前安装依赖库，执行以下命令：

pip install requests

四、账号授权与 API Key 获取

使用 Skill 前需完成账号绑定与密钥配置，无需填写 AppID、AppSecret、IP 白名单。

操作步骤

  1. 进入小光鸟官方工作台：https://mp.aitools.yun/，完成注册或登录。
  2. 进入账号管理页面，微信扫码授权对应公众号，完成账号绑定。
  3. 进入「API 管理」模块，创建并获取专属 API Key。

API Key 读取优先级

脚本会自动按顺序读取密钥，无需重复配置：

  1. 优先读取系统环境变量 WXAI_API_KEY
  2. 其次读取本地配置文件 ~/.xiaoguangniao-wechat/config.json 内的 api_key 字段

五、本地密钥配置命令

获取 API Key 后，在项目根目录执行配置命令，完成密钥绑定：

python scripts/xiaoguangniao_wechat.py setup-key --api-key "你的 API Key"

默认接口地址

脚本默认对接官方外部接口，无需手动修改：

https://mp.aitools.yun/api/external/v1

六、存量文档排版并推送草稿箱

适用于已有 Markdown 文稿，快速完成公众号排版、整编、推送。

基础排版推送（仅正文）

python scripts/xiaoguangniao_wechat.py typeset-and-publish --content-file article.md

带封面图排版推送

支持自定义封面配图，适配正式推文发布场景：

python scripts/xiaoguangniao_wechat.py typeset-and-publish --content-file article.md --cover-image-file cover.png

七、主题生成文章并推送草稿箱

无需本地文稿，输入主题与创作要求，自动生成完整文章、结构与配图并推送草稿。

生成发文命令示例

python scripts/xiaoguangniao_wechat.py generate-and-publish --topic "AI Agent 如何提升企业内容运营效率" --requirements "结构清晰，少套话，结尾给出行动建议"

八、超时任务续跑处理

任务执行超时、网络波动时，禁止重复发起新命令，避免重复消耗额度。

需记录任务返回的 jobId，通过以下命令续跑、查询进度：

python scripts/xiaoguangniao_wechat.py typeset-and-publish --job-id "之前记录的jobId"

九、模板与额度消耗规则

  • 默认模板：所有自动生成、排版内容默认使用 guardian-nature 模板。
  • 额度消耗规则
    • 已有文章排版：消耗文本改写额度（rewrites）
    • 自动配图、AI 生图：消耗图片额度（images）
    • 主题从零生成全文：消耗文章生成额度（articles）

十、授权失效处理

若执行命令提示授权失效、权限异常，无需修改本地配置，返回小光鸟 SaaS 账号管理页面，重新扫码授权公众号即可恢复使用。

十一、重要发布边界说明

  • 小光鸟 Skill 仅支持将内容推送至当前已授权的微信公众号草稿箱，无自动群发、一键发布、定时发布能力。
  • 所有推送的草稿内容，必须由用户登录微信公众号官方后台，完成最终预览、内容检查、合规校验后，手动发布。
  • 工具仅用于内容生产与排版提效，不实现全自动运营、无人值守发布、流量增长等效果。

十二、快速入口