OpenClaw blogwatcher 技能详解用 blogwatcher CLI 为 Agent 接入博客与 RSS/Atom 订阅监控【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawOpenClaw 通过skills/blogwatcher/SKILL.md这个内置技能Skill教 Agent 使用blogwatcherCLI 来跟踪博客与 RSS/Atom 订阅源的更新。读完本文你能掌握该技能的完整命令用法、SKILL.md 前置元数据frontmatter中requires.bins门控与 Go 安装器声明的机制以及 OpenClaw 技能加载器如何依据源码判断该技能是否可用。技能定位一条 CLI 打通订阅 → 扫描 → 已读闭环blogwatcher 技能的目标很直接让 Agent 通过命令行工具完成博客/RSS/Atom 源的监控核心工作流为四步——添加博客add、扫描更新scan、查看文章articles、标记已读read/read-all。技能正文以 skills/blogwatcher/SKILL.md 为唯一载体其中 frontmatter 声明了name、description、homepage与metadata.openclaw门控块正文则给出安装方式、快速上手、常用命令与示例输出。与 OpenClaw 仓库中其他技能如weather、himalaya一样blogwatcher 属于文件型技能file-backed skill只要SKILL.md出现在技能根目录默认最深 6 层下加载器就会发现它。该技能的加载优先级遵循 OpenClaw 的技能层级体系bundled 技能随安装包发行位于第 5 级详见 Skills 文档。安装一条 go install 命令技能正文给出的唯一安装途径是 Gogo install github.com/Hyaxia/blogwatcher/cmd/blogwatcherlatest快速上手只需先运行帮助命令确认二进制可用blogwatcher --help需要注意的是OpenClaw 的requires.bins门控检查的是宿主机PATH上是否存在blogwatcher可执行文件见下文门控机制一节。如果你手动go install后技能仍未出现在 Agent 的技能列表中通常是GOBIN未加入PATH或者改用 OpenClaw 自带的安装器机制由 Gateway 代装到其管理的 bin 目录。安装器声明与 OpenClaw 的 Go 安装规则frontmatter 中的metadata.openclaw.install声明了一条 Go 安装器规格kind: go模块github.com/Hyaxia/blogwatcher/cmd/blogwatcherlatest供 macOS Skills UI 与 Gateway 使用。根据 Skills 文档中的 Go 安装器说明OpenClaw 对 Go 类安装有三条硬性规则理解它们能解释安装行为OpenClaw 要求 Go 1.21 或更新版本才支持自动安装技能依赖若宿主机缺少go且可用 Homebrew会先经 Homebrew 安装 GoLinux 无 Homebrew 时可走apt-get的golang-go通道需 root 或免密 sudo且版本满足最低要求。实际的go install始终指向 OpenClaw 管理的专用 bin 目录新安装时是 Homebrew 的bin否则为~/.local/bin而不是你配置的GOBIN。你自己的GOBIN、GOPATH、GOTOOLCHAIN环境变量只会被读取、绝不会被覆盖。多安装器场景下 Gateway 按 Homebrew → uv → 配置的 node 包管理器 → go → download 的偏好顺序选择blogwatcher 只声明了 go 一种因此直接走 Go 通道。常用命令与示例输出技能正文列出的完整命令集如下均可直接复制运行用途命令添加博客blogwatcher add My Blog https://example.com列出已跟踪博客blogwatcher blogs扫描更新blogwatcher scan列出文章blogwatcher articles标记某篇文章已读blogwatcher read 1全部标记已读blogwatcher read-all移除博客blogwatcher remove My Blog典型交互输出引自 SKILL.md 原文示例$ blogwatcher blogs Tracked blogs (1): xkcd URL: https://xkcd.com$ blogwatcher scan Scanning 1 blog(s)... xkcd Source: RSS | Found: 4 | New: 4 Found 4 new article(s) total!从scan的输出结构可以看出blogwatcher 会为每个源报告解析到的源类型如Source: RSS、本次发现的文章数与新文章数New 计数说明它内部维护了已见文章状态与read/read-all的已读标记共同构成增量阅读体验。发现更多参数时SKILL.md 给出的通用建议是对任意子命令追加--help即用blogwatcher command --help探索 flag 与选项。门控机制requires.bins 如何让技能按需可见blogwatcher 的 frontmatter 完整结构如下摘自 skills/blogwatcher/SKILL.md--- name: blogwatcher description: Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI. homepage: https://github.com/Hyaxia/blogwatcher metadata: { openclaw: { emoji: , requires: { bins: [blogwatcher] }, install: [ { id: go, kind: go, module: github.com/Hyaxia/blogwatcher/cmd/blogwatcherlatest, bins: [blogwatcher], label: Install blogwatcher (go), }, ], }, } ---这段元数据在 OpenClaw 加载时承担三个职责requires.bins: [blogwatcher]是硬性依赖门控。加载器在加载技能时检查宿主机PATH上是否存在该二进制未安装则技能整体不可用不会进入 Agent 提示词。这意味着 blogwatcher 技能是典型的工具型技能——它自身不含脚本只是教会模型如何驱动外部 CLI。install数组提供补救路径。当门控失败时macOS Skills UI / Gateway 可依据安装器规格代为安装安装成功后新依赖检查能发现已进入PATH的blogwatcher二进制从而让技能变为合格eligible。emoji与homepage属于展示性字段分别用于 macOS Skills UI 的图标与网站入口。从源码结构看门控与安装声明的汇聚点在 collectSkillBins它遍历一组技能条目把metadata.requires.bins、metadata.requires.anyBins与每条install规格的bins字段合并去重并按序排序供二进制探测与状态展示复用。blogwatcher 的requires.bins与install[0].bins都指向同一个blogwatcher二者合并后即为一个条目探测命中即门控通过。frontmatter 的解析入口在 src/skills/loading/frontmatter.ts其嵌套metadata块会被扁平化为 JSON 字符串后按 JSON5 重新解析这正是 blogwatcher frontmatter 采用 JSON5 对象字面量写法的原因。会话生命周期快照、刷新与配置开关结合 Skills 文档 的运行时说明blogwatcher 技能的实际生效还受以下机制约束会话级快照OpenClaw 在会话开始时对合格技能做快照会话内各轮次复用同一份列表。因此安装blogwatcher后若当前会话的快照仍不含它新会话才会稳定纳入技能文件变化或新节点连接触发的刷新则会在下一轮生效。沙箱注意requires.bins在宿主机检查但若 Agent 运行在沙箱中二进制还必须存在于容器内——可通过agents.defaults.sandbox.docker.setupCommand或自定义镜像安装blogwatcher否则 Agent 看到技能、执行却找不到命令。配置开关可以在~/.openclaw/openclaw.json的skills.entries下按技能名控制{ skills: { entries: { blogwatcher: { enabled: false }, // 显式禁用该内置技能 }, }, }enabled: false会直接让技能不可用blogwatcher 未声明primaryEnv因此不需要apiKey/env注入这是它与gemini等需要凭据技能的重要区别。提示词成本每个合格技能在系统提示词中约增加 97 个字符约 24 token加name/description长度blogwatcher 的 description 很短开销可控。适用前提与小结本技能适用于已安装 Node 版 OpenClaw 且能在宿主机或沙箱PATH上提供blogwatcher二进制的任何操作系统环境依赖 Go 1.21 仅在使用 OpenClaw 自动安装通道时才是前提。整体来看skills/blogwatcher/SKILL.md 是一份紧凑的CLI 驱动型技能范本frontmatter 用requires.bins Go 安装器规格解决依赖正文用 7 条命令 2 段示例输出覆盖订阅监控全生命周期而门控、安装器偏好与快照刷新的底层行为则由 src/skills 目录下的发现discovery与加载loading模块保证读者可沿 collectSkillBins 与 Skills 文档 继续深入。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考