Agent2RSS Client(OpenClaw)
管理 Agent2RSS 频道并推送内容到 RSS。
Requirements
bashcurljq
重要安全说明
- 本技能会向
config.json中的serverUrl发起网络请求(创建频道、上传内容、推送文章)。 - 默认 serverUrl 是
https://agent2rss.yaotutu.top:8765(官方托管服务)。 - 如果改为远程地址,请只使用你信任的服务;远程
http://会有明文传输风险。 - 频道 token 存储在:
$HOME/.openclaw/workspace/.skill-data/agent2rss-client/config.json
- 脚本会将该文件权限收敛为
600。不要把该文件提交到仓库。
路径约定
- 脚本:
scripts/agent2rss.sh - 配置目录:
$HOME/.openclaw/workspace/.skill-data/agent2rss-client/ - 配置文件:
$CONFIG_DIR/config.json - 模板:
assets/config-template.json
初始化(默认官方服务,不会自动建频道)
# 推荐:直接使用官方托管服务(默认)
scripts/agent2rss.sh init
# 如果你有自建实例,再显式指定 server-url
scripts/agent2rss.sh init --server-url https://your-agent2rss.example.com
init只初始化配置,不会自动创建默认频道。请显式执行create-channel。 Agent2RSS 是开源项目,可自部署:https://github.com/yaotutu/agent2rss。
常用命令
# 健康检查
scripts/agent2rss.sh health
# 创建频道(并设为默认)
scripts/agent2rss.sh create-channel "技术博客" "分享技术文章"
# 列出频道
scripts/agent2rss.sh list
# 设置默认频道
scripts/agent2rss.sh set-default <channelId>
# 上传文件推送(推荐)
scripts/agent2rss.sh push-file article.md
# JSON 推送
scripts/agent2rss.sh push-json post.json
# 仅预览请求,不实际发送
DRY_RUN=1 scripts/agent2rss.sh push-file article.md
网络操作范围(透明说明)
脚本会调用以下接口(基于 serverUrl):
GET /healthPOST /api/channelsPUT /api/channels/:idPOST /api/channels/:id/postsPOST /api/channels/:id/posts/upload
幂等建议
idempotencyKey建议使用:文章URL、文件名+哈希或业务唯一 ID。- 重复推送同一 key 时应返回已存在(
isNew: false)。
常见错误
401:token 无效或缺失。404:频道 ID 不存在。400:缺少 content/file 等必填字段。5xx:服务异常,稍后重试。
参考
- API 示例:
references/api-examples.md - 发布前回归清单:
references/e2e-test.md