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

> 第一批 OpenClaw 技能应跟着任务选：Google 办公用 gog，GitHub 协作用 github，长资料提炼考虑 summarize。先检查实际运行环境的依赖与账户，再用可核对的小任务验收；网页搜索和浏览器操作则先确认已有能力。

- URL: https://blog.laozhang.ai/zh/posts/openclaw-best-skills-guide
- Published: 2026-10-09
- Updated: 2026-10-09
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: 开发工具与智能体
- Tags: OpenClaw, Skills, 技能推荐, ClawHub, 办公自动化

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

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

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

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

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

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

| 你要完成的工作 | 优先看什么 | 选它之前先确认什么 |
|---|---|---|
| 汇总 Gmail 信息、查看 Google 日历、读取 Drive 或表格 | `gog` | 运行环境有 `gog`，所需 Google 服务已完成 OAuth 授权 |
| 看 PR 状态、Issue、CI 失败记录 | `github` | 有 `gh`，登录的 GitHub 账户能访问指定仓库 |
| 提炼长网页、PDF 或视频内容 | `summarize` | 有 `summarize` CLI；需要模型摘要时，所选服务的密钥与计费条件已确认 |
| 处理普通 IMAP/SMTP 邮箱 | `himalaya` | 有 `himalaya`，邮箱账号和 IMAP/SMTP 配置可用 |
| 搜索、读取和整理 Obsidian 笔记 | `obsidian` | 官方 `obsidian` CLI 可用，应用版本与运行状态满足要求 |
| 持续跟踪几个博客或 RSS/Atom 订阅 | `blogwatcher` | 有 `blogwatcher`，订阅源能访问；需要安装其 CLI 时再确认 Go 安装路径 |
| 查询某座城市当前天气或预报 | `weather` | `web_fetch` 能访问天气端点；仅在它不可用时考虑 `curl` 后备路径 |

这些依赖分别来自官方公开的 [gog](https://github.com/openclaw/openclaw/blob/main/skills/gog/SKILL.md)、[github](https://github.com/openclaw/openclaw/blob/main/skills/github/SKILL.md)、[summarize](https://github.com/openclaw/openclaw/blob/main/skills/summarize/SKILL.md)、[himalaya](https://github.com/openclaw/openclaw/blob/main/skills/himalaya/SKILL.md)、[obsidian](https://github.com/openclaw/openclaw/blob/main/skills/obsidian/SKILL.md)、[blogwatcher](https://github.com/openclaw/openclaw/blob/main/skills/blogwatcher/SKILL.md) 和 [weather](https://github.com/openclaw/openclaw/blob/main/skills/weather/SKILL.md) 说明。表格里的“有 CLI”只覆盖工具依赖，不能证明 token 有效、账户权限充足或目标服务畅通。

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

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

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

用 `gog` 做邮件统计时，还要分清线程和单封邮件：`gog gmail search` 每行对应一个线程；需要逐封结果应使用 `gog gmail messages search`。这会直接影响“找到了几封”是否准确。[gog 的公开说明](https://github.com/openclaw/openclaw/blob/main/skills/gog/SKILL.md)列明了两种搜索的差别与 OAuth 要求。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

![从技能来源、Gateway 运行环境、账户访问到可核对结果的检查示意](https://blog.laozhang.ai/posts/zh/openclaw-best-skills-guide/img/dependency-check.webp)

根据结果继续：

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

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

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

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

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

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

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

遇到扫描等待、安装拒绝或权限错误，先读具体原因，不把强制安装当作常规步骤。遇到 `429`，暂停重复下载，按这次响应的等待信息恢复，具体可看 [OpenClaw 429 与 ClawHub 下载限流排查](https://blog.laozhang.ai/zh/posts/openclaw-rate-limit-exceeded-429)。安装恢复后，再回到清单和依赖检查，不必重装已就绪的全部技能。

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

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

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

在控制界面的输入框键入 `$`，选择当前代理可用的 `gog` 技能，再写任务。官方支持这种显式技能引用；技能未向代理开放时，应先解决可见性，而不是靠自然语言要求它忽略限制。[技能引用说明](https://docs.openclaw.ai/tools/skills#reference-a-skill-in-a-prompt)给出了入口。

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

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

![假设的会议时间轴及空档，用于说明只读日历任务怎样核对账号、时区和事件](https://blog.laozhang.ai/posts/zh/openclaw-best-skills-guide/img/calendar-check.webp)

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

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

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

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

## 常见问题

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

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

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

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

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

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

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

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

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-09。

- [官方 Skills CLI](https://docs.openclaw.ai/cli/skills) (docs.openclaw.ai)
- [官方技能机制](https://docs.openclaw.ai/tools/skills) (docs.openclaw.ai)
- [gog](https://github.com/openclaw/openclaw/blob/main/skills/gog/SKILL.md) (github.com)
- [github](https://github.com/openclaw/openclaw/blob/main/skills/github/SKILL.md) (github.com)
- [summarize](https://github.com/openclaw/openclaw/blob/main/skills/summarize/SKILL.md) (github.com)
- [himalaya](https://github.com/openclaw/openclaw/blob/main/skills/himalaya/SKILL.md) (github.com)
- [obsidian](https://github.com/openclaw/openclaw/blob/main/skills/obsidian/SKILL.md) (github.com)
- [blogwatcher](https://github.com/openclaw/openclaw/blob/main/skills/blogwatcher/SKILL.md) (github.com)
- [weather](https://github.com/openclaw/openclaw/blob/main/skills/weather/SKILL.md) (github.com)
- [当前搜索文档](https://docs.openclaw.ai/tools/web) (docs.openclaw.ai)
- [浏览器官方文档](https://docs.openclaw.ai/tools/browser) (docs.openclaw.ai)
