OpenClaw Docs CN

基础使用 / 第一个扩展实验

入门级 Skill 尝鲜

如果你已经装好了 OpenClaw,也能正常发第一条本地消息,那最合适的下一步不是立刻装一堆第三方扩展,而是做一个 低风险、看得懂、5 分钟内能见效 的小 Skill 实验。这样你能先理解 Skill 在实际使用里到底是什么,而不是只记概念。

这页最适合什么时候做

当你已经完成本地消息测试,系统状态也基本正常,但还没真正体验过 OpenClaw 的“扩展层”时,这页就是最合适的第一站。

先确定这次实验的目标

这页的目标不是“做最厉害的自动化”,而是确认下面这条链路已经通了:

  1. 你知道 Skill 是什么。
  2. 你能找到合适的 Skill。
  3. 你能装进去。
  4. 你知道为什么有时要开新会话。
  5. 你能实际看到它开始生效。

先用一句话理解 Skill

Skill 更像一套可被 OpenClaw 调用的“任务说明书和辅助能力包”,它通常会定义什么时候该用它、怎么做、需要哪些工具、可能还会附带脚本或资源。

所以它既不是“单纯插件按钮”,也不是“模型自己突然变聪明”。它更像一层可安装的任务能力。

为什么第一次要选“小而清楚”的 Skill

  • 更容易看出它到底有没有被触发。
  • 出问题时更容易排查,不会一上来就遇到权限、依赖、长链路工具调用。
  • 更适合理解 Skills 和 web 工具是怎么配合工作的。

所以第一次实验,更建议你选“网页搜索 / 页面总结 / 日历整理 / 简单信息提取”这类用途清楚的 Skill,而不是超重的自动化工作流。

开始之前,先把 web 工具配好

如果你准备体验的是“搜索网页然后总结”这种类型,先跑:

openclaw configure --section web

官方文档里明确提到:web_fetch 这类能力不一定需要搜索 API,但 web_search 通常需要你配置对应的搜索能力。你至少要先确认 web 这一块不是空的。

最推荐的新手实验:搜一个轻量 Skill,再装进去

clawhub search "calendar"

这是官方文档里直接给出的示例关键词之一。你可以不一定非装日历类,但用它作为第一次搜索演示非常合适,因为输出结果通常比较清楚。

找到你觉得合适的条目后,再执行:

clawhub install <skill-slug>

装完以后,可以先看一下当前有哪些 Skill:

openclaw skills list
openclaw skills list --eligible

其中 --eligible 特别有用,它能帮助你判断:当前上下文里到底有哪些 Skill 有机会被触发。

为什么很多时候装完 Skill 还要开新会话

这是新手最容易困惑的地方之一。原因很简单:当前会话已经有一段上下文,模型和路由可能还沿用旧状态;当你新装了 Skill,再开一个新会话,系统更容易重新判断当前有哪些 Skill 可用、该不该触发。

所以更稳的顺序通常是:

  1. 装 Skill。
  2. 确认它已经列出来。
  3. 新建一个会话。
  4. 用明显会触发它的任务去试。

一个 5 分钟内能看到效果的尝试方式

  1. 先配置 web 工具。
  2. clawhub search "calendar" 或类似关键词找一个轻量 Skill。
  3. 安装后开新会话。
  4. 发一个明确的任务,比如:请先搜索 OpenClaw 最近的更新动态,再用 5 条要点总结。

这里你要看的不是“它回答得多漂亮”,而是:

  • 日志里有没有相关工具或 Skill 触发迹象。
  • 结果是否比纯裸聊更像“做过额外动作”。
  • 它是否用了更合适的结构化输出。

Skill 装在哪里,也会影响你观察结果

官方文档里提到,workspace-local skills 的优先级通常高于共享 skills。所以如果你在某个 workspace 里已经放过本地 Skill,再装共享 Skill 时,结果不一定完全按你想象来。

这也是为什么第一次实验最好用一个干净一些的 workspace,不要和大量历史本地 Skill 混在一起。

不建议第一次就做的 4 件事

  1. 一口气装很多第三方 Skill。
  2. 一上来就装带复杂脚本和外部依赖的 Skill。
  3. 没看清来源就直接信任第三方 Skill。
  4. 在已经很乱的旧会话里判断“Skill 到底有没有生效”。

如果实验没效果,先这样排

openclaw skills list --eligible
openclaw logs --follow
openclaw hooks check

再配合这几个问题一起看:

  • 是不是根本没装成功。
  • 是不是当前会话上下文不适合触发它。
  • 是不是 web 工具没配好。
  • 是不是某个本地 Skill 抢了优先级。

建议搭配阅读

官方参考