| name | wewe-rss-reader |
| description | 微信公众号文章阅读技能。当用户发来公众号文章链接、需要阅读理解文章内容时使用。通过本地部署的 WeWe RSS 服务获取文章全文并转为纯文本。Requires: 无（调用本地 REST API，首次部署见 references/deployment.md）。 |
| metadata | {"openclaw":{"emoji":"📖","requires":{"anyBins":"[Truncated]"}}} |
wewe-rss-reader
微信公众号文章阅读。当用户发来文章链接或需要查询已订阅公众号的文章时使用。
API 基础信息
- API 地址:
http://localhost:4001
- wewe-rss 容器:
http://localhost:4000（Web UI）
- AUTH_CODE:
wewe-rss-2026
核心 API
获取单篇文章内容（最常用）
GET /api/articles/:id
返回纯文本内容（最多前15000字）。:id 是文章 URL 中 mp.weixin.qq.com/s/ 后面的部分。
示例：用户发来链接 https://mp.weixin.qq.com/s/udSpp7eMqwiRo5yVShRzLw
→ 调用 GET /api/articles/udSpp7eMqwiRo5yVShRzLw
→ 直接获得文章纯文本内容
通过 URL 订阅公众号
POST /api/subscribe
Content-Type: application/json
body: {"url": "文章链接"}
从文章链接自动识别并订阅该公众号，返回订阅结果。
列出已订阅公众号
GET /api/feeds
列出某公众号文章
GET /api/articles?feedId=MP_ID&limit=10
手动刷新订阅
POST /api/refresh/:feedId
POST /api/refresh-all
使用流程
场景1：用户发来文章链接
- 从 URL 提取文章 ID（如
https://mp.weixin.qq.com/s/udSpp7eMqwiRo5yVShRzLw → ID 是 udSpp7eMqwiRo5yVShRzLw）
- 直接调用
GET /api/articles/:id 获取正文
- 即可对文章内容进行阅读理解
场景2：用户要求查询某公众号最新文章
GET /api/feeds 确认已订阅GET /api/articles?feedId=<MP_ID>&limit=5 获取文章列表- 如需正文，
GET /api/articles/:id
场景3：用户想订阅新公众号
- 用户需提供该公众号的任意文章链接（不是公众号主页链接）
POST /api/subscribe body: {"url": "文章链接"}- 返回订阅成功/已存在
登录流程（微信读书授权）
微信读书账号用于抓取公众号内容。若账号已登录且有效（参考 health 检查），无需每次操作。
账号失效后会收到 "暂无可用读书账号" 错误，此时需要重新登录。
完整登录流程
# Step 1: 发起登录
POST /api/login/start
→ 返回 {"uuid": "...", "confirmUrl": "https://..."}
# Step 2: 发送二维码图片到飞书
→ 把 confirmUrl 作为图片请求 URL（或生成二维码图片）发送到飞书群
→ 通知用户扫码
# Step 3: 轮询等待登录完成（自动）
GET /api/login/status/<uuid>
→ status=authorized 表示登录成功 → 继续执行
→ status=waiting 表示等待中 → 继续轮询
→ 超过 5 分钟视为过期，报错让用户重新发起
轮询间隔：每 5 秒一次，不要快发。
自动完成：用户扫完码后，status 会自动变成 authorized，全程无需用户额外确认。
发送图片到飞书：用 message 工具将登录 URL 对应的二维码图片发送到飞书群，通知用户扫码。图片发送由调用方 agent 负责（参考飞书发送图片规范）。
Agent Rules
- 收到文章链接时，优先直接调用
/api/articles/:id 获取内容，而非要求用户提供更多信息
- 获取到正文后，直接进行阅读理解，不需要额外确认
- 如调用失败（返回空/报错），先检查 wewe-rss 容器是否运行：
curl http://localhost:4001/api/health
- 如容器未运行：在
~/.openclaw/workspace/wewe-rss/ 目录下 docker compose up -d
