写在前面
这一步的重点不是收集很多技能,而是先让 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 check2. 再看技能详情
openclaw skills info <skill-name> -v3. 再看总日志
openclaw logs --limit 1004. 最后验证配置
openclaw config validate如果问题和技能配置本身有关,再去查对应的配置路径,而不是一上来就重装很多次。
常见错误或风险
- 不要一次装很多技能;
- 不要只看安装完成,不做实际调用验证;
- 不要把技能当成功能清单,要看它能不能进入真实工作流;
- 如果日志已经指出是缺少依赖或环境变量,就先修这一层,不要继续堆别的改动。
下一步
这条起步链路走完后,你就可以按需去 /config 回看配置细节和版本差异判断,再继续扩展自己的部署和工作流。