技能系统入门

写在前面

这一步的重点不是收集很多技能,而是先让 OpenClaw 多出一项你马上会用到的执行能力。

第一次装技能时,控制变量比追求覆盖面更重要。

第一步:先看系统现在能识别哪些技能

先不要装新技能,先看当前环境里已经有哪些技能可用:

openclaw skills list

如果你只想看已经满足依赖、可以直接使用的技能:

openclaw skills list --eligible

如果你怀疑某些技能缺少依赖或权限,直接看详细信息:

openclaw skills list -v

第二步:第一次只选一项高频、低依赖的技能

更适合起步的第一项技能,通常满足两个条件:

  • 你最近马上会用到;
  • 安装和验证路径比较短。

不要第一次就装很多技能。一次只装一个,你才能判断问题到底出在:

  • 技能本身;
  • 缺失的环境变量或依赖;
  • 还是底层 OpenClaw 配置。

第三步:安装后先检查,不要直接假设可用

装完一个技能后,至少先跑这两个检查:

openclaw skills check
openclaw skills info <skill-name>

如果你需要更具体地看配置项,也可以查:

openclaw config get skills.entries.<skill-name>

你要确认的是:

  • 技能是否已经被系统识别;
  • 是否缺少 env、系统命令或配置;
  • 当前是否已被标记为可用。

第四步:做一次最小实际调用

不要把“技能显示在列表里”当成结束。真正有用的标准是,它能完成一次最小任务。

验证时同时看日志:

openclaw logs --follow

你要重点看的是:

  • 技能有没有被成功调用;
  • 调用时是否报缺少 API Key、路径或权限;
  • 返回结果是否真的符合你要解决的任务。

第五步:出问题时按这个顺序排查

1. 先检查技能状态

openclaw skills check

2. 再看技能详情

openclaw skills info <skill-name> -v

3. 再看总日志

openclaw logs --limit 100

4. 最后验证配置

openclaw config validate

如果问题和技能配置本身有关,再去查对应的配置路径,而不是一上来就重装很多次。

常见错误或风险

  • 不要一次装很多技能;
  • 不要只看安装完成,不做实际调用验证;
  • 不要把技能当成功能清单,要看它能不能进入真实工作流;
  • 如果日志已经指出是缺少依赖或环境变量,就先修这一层,不要继续堆别的改动。

下一步

这条起步链路走完后,你就可以按需去 /config 回看配置细节和版本差异判断,再继续扩展自己的部署和工作流。