OpenClaw Skills 怎么选？按办公、开发和资料整理选好第一批技能

已经能正常运行 OpenClaw，第一批技能就从你每天重复做的一件事开始选。 用 Gmail 和 Google 日历办公，先看 gog；处理 GitHub 的 Issue、PR 和检查记录，先看 github；经常读长网页、PDF 或视频资料，再考虑 summarize。只想查公开网页或操作浏览器，应先确认现有搜索工具和浏览器插件是否可用，不必先装一整套“必装 Skills”。

选中以后，先查技能在当前 Gateway 上是否存在、缺什么依赖、是否向当前代理开放，再确认它依赖的账户能访问目标内容。最后给它一个范围小、结果能核对的任务。“装好了”和“替你完成了工作”之间，还隔着运行环境、认证和结果验收。 官方 Skills CLI把技能清单、依赖就绪与代理可见性明确分开。

下文依据 2026 年 10 月 8 日核对的官方文档及公开技能源码，给出选型与操作方法。示例用于说明怎样验收，不代表我们已登录你的账户或实际运行这些技能。

先看任务：你的第一项技能该选谁

技能是指导代理使用工具的说明，通常以 SKILL.md 保存；它可以附带脚本和其他资源。安装说明文件不会自动安装所有工具，也不会自动获得账户权限。插件还可以自带技能，但插件启用、技能加载和外部服务认证各有自己的条件。官方技能机制说明了这几层关系。

下面这些候选都能在 OpenClaw 官方仓库中找到。表格按要做的事分流，不是下载量榜单；你的安装版本是否附带、当前实际加载哪个来源，仍要以自己的清单为准。

这些依赖分别来自官方公开的 gog、github、summarize、himalaya、obsidian、blogwatcher 和 weather 说明。表格里的“有 CLI”只覆盖工具依赖，不能证明 token 有效、账户权限充足或目标服务畅通。

Google 办公选 gog，普通邮箱选 himalaya

如果待办信息同时分散在 Gmail、Google 日历和 Drive，gog 更贴近这类跨服务工作。当前技能使用的是 gog 命令行工具，不应把它与其他 Google CLI 混为一谈。首次连接需要 OAuth；已有授权时，先检查现有账号和所需服务，不要因为选了技能就重新授权全部服务。

如果只需要读取公司或个人的 IMAP 邮箱，himalaya 更直接。它还支持写信、回复、移动和删除，因此“能读邮件”不能被理解为“可以自动替你发送或清理邮件”。第一次先限定读取任务，确认邮箱与邮件范围；写操作应另行明确。

用 gog 做邮件统计时，还要分清线程和单封邮件：gog gmail search 每行对应一个线程；需要逐封结果应使用 gog gmail messages search。这会直接影响“找到了几封”是否准确。gog 的公开说明列明了两种搜索的差别与 OAuth 要求。

GitHub 协作选 github，深度改代码另看工具

github 适合“这个 PR 卡在哪个检查”“某个 Issue 目前是什么状态”等仓库协作问题。它通过 gh 读取 PR、Issue 和检查记录；本地提交、分支和推拉仍属于 git，深入理解源码还需要代码阅读工具。当前 github 技能没有把这些任务都合并成一个能力。

因此，日常只想收到 PR 状态摘要，可以先用 github，不必同时搭建一套自动编码、提交和合并流程。gh 在你终端里已登录，也不保证 Gateway 服务以同一个用户运行、读取同一个认证目录；检查应落在实际执行任务的环境。

长资料选 summarize，订阅跟踪选 blogwatcher

summarize 适合把长内容变成可阅读的摘要，支持 URL、本地文件和 YouTube 等输入。但 --extract 只抽取内容，不调用模型生成摘要；模型摘要还需要所选提供方的密钥。视频字幕是尽力提取，附加抓取或转写服务也可能有自己的认证与费用。当前 summarize 说明给出了这些区别。它也不是 OpenClaw 聊天历史的自动压缩器。

如果问题是“我关注的几个博客今天有没有更新”，先考虑 blogwatcher。它维护博客、订阅与本地已读状态，比每次从零搜索更贴近持续跟踪任务；它不因此成为任意新闻站、登录页面或付费墙的通用读取工具。把“发现新内容”和“总结新内容”分成两步，更容易知道失败发生在哪里。

短文已能被现有工具完整读取，直接让代理分析就可以。只有输入类型、长度或重复任务确实需要额外工具时，再增加 summarize。

Obsidian 先确认官方 CLI，天气先确认读取路径

当前 obsidian 技能要求 Obsidian 1.12.7 及以上、在设置中启用命令行接口、obsidian 已加入 PATH，并且 Obsidian 应用正在运行。它连接的是运行中的应用，不能把“服务器上有几个 Markdown 文件”当成已满足条件。若只是读写普通笔记文件，文件工具也可能够用；需要 Obsidian 的任务、链接、属性等功能时再用其 CLI。官方仓库的 obsidian 技能已明确使用官方 CLI。

weather 则优先通过 web_fetch 读取 wttr 的 JSON，在该工具不可用时才用 curl。当前说明没有把 curl 列为必须满足的二进制依赖，也不要求单独申请天气 API key；仍需要网络能够访问端点。查询时写清城市、区域和时间，强天气预警、航空航海及历史气候应转向对应的官方服务。weather 说明给出了适用范围。

网页搜索和浏览器操作，先查已有能力

只想“找最新网页”，先看 OpenClaw 的 web_search 和 web_fetch。前者使用当前配置的搜索提供方，后者用于轻量读取 URL；搜索提供方有的免 key，有的需要认证。控制界面的 Settings → Search 可查看所选代理与模型的实际搜索方式。显示已配置，只证明配置信息存在，不证明凭据有效或服务能访问；测试查询使用提供方正常的额度与计费。当前搜索文档说明了入口和状态区别。

需要 JavaScript、登录页面或点击操作时，再看浏览器插件。启用后，它自带 browser-automation 技能；托管的 openclaw 浏览器配置与接入已登录 Chrome 的 user 配置也不同。先确认现有插件与适合任务的浏览器配置，能少装一套重复依赖。浏览器官方文档是这条路径的直接入口。

搜索能力缺失时，判断缺的是提供方、认证、工具可用性还是浏览器操作，再选择组件。“联网必须先装某个 web-search 技能”并不是当前文档支持的统一前提。

怎样检查内置技能，并让选中的技能可用

先在你实际使用的 OpenClaw 环境查看清单。以下是官方当前的只读检查命令，用于读者自行检查；本文没有运行它们：

openclaw skills list
openclaw skills list --eligible
openclaw skills list --verbose
openclaw skills info gog
openclaw skills check

把 gog 换成你选中的技能名。第一条确认是否发现；--eligible 查看声明前提已满足的技能；--verbose 和 info 帮你核对来源及依赖；check 用来定位缺失条件和可见性。使用多个代理时，以自己的实际代理 ID 替换下面的占位符：

openclaw skills info gog --agent <你的代理ID>
openclaw skills check --agent <你的代理ID>

当前 list、info、check 获取的是所选 Gateway 的技能清单。显式选择远程 Gateway 后，连接或认证失败不会悄悄退回笔记本本地清单。因此，远程服务器跑代理，就需要确认那个运行环境的工具和认证，而不是只看桌面终端。Skills CLI 文档解释了目标选择规则。

根据结果继续：

1. 已有且就绪： 核对实际来源和账户，直接进入小任务验收，不必再从 ClawHub 安装同名技能。
2. 存在但缺依赖： 按当前 info 和该工具官方说明补齐缺项。技能文件、命令行工具和账户配置要分别处理；桌面安装提示不代表适用于所有服务器系统。
3. 被禁用： 查看 openclaw.json 中该技能的 skills.entries 项是否设为 enabled: false。确实要启用时，只合并修改该项，不用一整段示例覆盖已有配置。
4. 依赖就绪但代理看不到： 检查当前代理的技能过滤规则。allowBundled 只作用于内置技能，代理自己的技能名单则控制它能看到哪些技能；不要用放开所有权限来掩盖配置差异。
5. 刚补完工具，旧对话仍看不到： 开启新会话重新检查依赖。技能文件变化可触发刷新，但只安装了二进制工具不等于旧会话立即更新。

上述配置与刷新行为见 Skills 的启用、过滤和会话刷新说明。同名技能也会影响判断：工作区中的技能优先于随安装附带的技能。因此，看到 github 这个名字，还要确认读到的是哪个文件和来源，不能仅凭名字认定它就是表格中的官方版本。

确实缺少能力时，再从 ClawHub 安装

先搜索要解决的任务，打开候选的技能说明，确认发布者、版本、实际依赖和行为。当前命令使用复数 skills；下面是语法模板，尖括号里的内容要换成你核对后的真实值，不要原样执行：

openclaw skills search "rss"
openclaw skills install @<发布者>/<技能slug> --version <已核对的版本>
openclaw skills verify @<发布者>/<技能slug>

默认安装到当前代理工作区的 skills/；确实希望本地多个代理共享时才考虑 --global，其位置是共享的 ~/.openclaw/skills。--global 不能与 --agent 同时使用。安装目标和日后查看清单的 Gateway、代理要一致。当前安装文档还支持 Git 与本地目录来源，但要求根目录有可加载的 SKILL.md，技能安装命令不接受 npm 包规格或 zip 路径。

verify 读取 ClawHub 已保存的验证信息，不会启动一次新扫描；已安装的 ClawHub 技能会按记录的版本和来源验证。Git、本地目录或标记为 Not scanned by ClawHub 的来源，不能因为能加载就称为已扫描。下载量、徽章和官方收录也不能替代对行为与依赖的判断。Release trust说明了不同来源的检查边界。

遇到扫描等待、安装拒绝或权限错误，先读具体原因，不把强制安装当作常规步骤。遇到 429，暂停重复下载，按这次响应的等待信息恢复，具体可看 OpenClaw 429 与 ClawHub 下载限流排查。安装恢复后，再回到清单和依赖检查，不必重装已就绪的全部技能。

用一个小任务验收：查出明早的会议间隙

假设你主要用 Google 日历办公，已经选中 gog，目标是找出明早能安排沟通的空档。第一次不要让代理同时读邮箱、改日程、发邀请和更新表格；先验证它能读取正确的日历，并回答一个可核对的问题。

前提是 Gateway 环境中的 gog 可用、目标账号已授权 Calendar、你明确指定了日历。OAuth 的客户端资料和 token 留在工具的受信任授权流程中，不发送到聊天里。无显示器的远程 Gateway 有单独授权步骤，照 gog 当前说明处理；浏览器完成回调不等于 token 已成功保存。

在控制界面的输入框键入 $，选择当前代理可用的 gog 技能，再写任务。官方支持这种显式技能引用；技能未向代理开放时，应先解决可见性，而不是靠自然语言要求它忽略限制。技能引用说明给出了入口。

例如下面是一项假设任务，使用前替换日历标识与日期：

使用 $gog，只读取我指定的日历：<日历ID>。
检查 <YYYY-MM-DD> 北京时间 09:00–12:00 是否有至少 30 分钟的空档。
列出这个时间段内的事件标题、起止时间，以及你算出的空档。
说明是否计入全天事件；如果取不到完整事件列表，直接说明缺项。
不要创建或修改事件，也不要发送邀请。

验收时打开同一账号、同一日历和同一日期，对照以下结果：

• 对象正确： 没有读错账号或另一份日历；结果里的日期和时区确实是你指定的。
• 输入完整： 时间段内的事件可对应到日历，全天事件的处理有说明。只给“你有空”却没有依据，不足以确认读取成功。
• 推导正确： 空档由事件起止时间算出；重叠事件没有算出虚假的间隙，跨时区事件也没有错移。
• 动作符合要求： 日历没有新增或被修改，没有发送邀请。取不到数据时保留错误或缺项，不把空结果直接当成全天空闲。

这项任务同时检查工具、账号访问、数据范围和结果理解。只有这些都成立，才适合把下一步扩展为“草拟一个邀请”；是否真的创建和发送，再单独明确。它不证明所有 Google 服务都已授权，也不证明后续写操作一定成功。

其他技能沿用同样的验收方法即可：github 先解释你指定的一个 PR 为什么检查未通过，并给出对应检查链接；summarize 先处理一份你能打开的文件，要求结论附对应页码或原文位置；obsidian 先找一篇你知道存在的笔记，并核对实际路径。先有输入、有出处、有结果，再增加任务范围，比一次安装许多技能更容易判断哪项真正帮得上忙。

常见问题

内置 Skills 还要从 ClawHub 再装一次吗？

已经存在且满足依赖的技能，通常不需要重复安装。先用 openclaw skills info 核对实际来源，补齐缺失的工具或认证，再做任务验收。同名的工作区技能会覆盖内置版本，重复安装可能改变实际使用的说明。官方加载优先级明确了这一点。

为什么显示 eligible，任务还是失败？

因为 eligible 说明声明的前提满足，不证明外部账号有权读取目标资源，也不证明 token 有效、服务畅通或回答正确。先根据实际错误区分工具执行、账户认证、资源访问和结果理解，再处理对应问题；多个代理还要确认技能是否对当前代理可见。官方 CLI 的状态解释没有把就绪状态当作任务成功。

新手一定要先装自我改进或自动找技能工具吗？

不必把它们当作所有任务的前置条件。先用已有能力完成你明确需要的工作；确实需要额外行为时，再逐项核对具体技能的来源、依赖与权限。本页推荐按当前公开说明判断用途，没有依据把任何社区组件称为所有用户的必装项。

安装技能就能免费用它连接的服务吗？

不能。技能说明、依赖工具和它连接的外部服务是不同对象。summarize 的模型摘要需要相应服务密钥，搜索测试使用提供方正常额度与账单；有些读取路径免单独 key，也不等于模型调用或所有服务免费。费用应以实际工具与所选服务的规则为准。summarize 依赖说明和搜索设置说明分别说明了这些条件。