back
loading skill details...
Agent2RSS 客户端,管理 RSS 频道并推送内容。触发:用户提到 Agent2RSS/RSS 频道/推送文章/上传文章/创建频道/设置默认频道/幂等性。
--- name: agent2rss-client description: Agent2RSS 客户端,管理 RSS 频道并推送内容。触发:用户提到 Agent2RSS/RSS 频道/推送文章/上传文章/创建频道/设置默认频道/幂等性。 --- # Agent2RSS Client(OpenClaw) 管理 Agent2RSS 频道并推送内容到 RSS。 ## Requirements - `bash` - `curl` - `jq` ## 重要安全说明 - 本技能会向 `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` ## 初始化(默认官方服务,不会自动建频道) ```bash # 推荐:直接使用官方托管服务(默认) 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`。 ## 常用命令 ```bash # 健康检查 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 /health` - `POST /api/channels` - `PUT /api/channels/:id` - `POST /api/channels/:id/posts` - `POST /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`
don't have the plugin yet? install it then click "run inline in claude" again.