Skills 决定了 OpenClaw 的能力边界。
这一页讲三件事:如何看、如何装、如何安全地用。

1. Skills 是什么

Skills 是包含 SKILL.md 的独立能力包,用于告诉 Agent:

  • 何时调用这个能力
  • 用哪些工具或脚本执行
  • 输出应该是什么格式

2. Skills 加载优先级

同名 Skill 会按优先级覆盖,常见顺序:

  1. <workspace>/skills(项目专属,优先级最高)
  2. ~/.openclaw/skills(本机通用)
  3. 内置技能(随安装包提供)

3. 先看当前可用技能

openclaw skills list

通常会看到两种状态:

  • eligible:环境满足,可用
  • blocked:依赖或环境变量缺失

4. 用 ClawHub 管理 Skills

官网:

https://clawhub.ai/

安装与登录:

npx clawhub@latest --version
clawhub login

搜索与安装:

clawhub search tavily-search
clawhub install tavily-search

批量更新:

clawhub update --all

5. 示例:安装 Tavily 搜索技能

安装后常见“不能立即使用”的原因:缺少 TAVILY_API_KEY

处理步骤:

  1. 在 Tavily 平台申请 API Key
  2. 在 OpenClaw 环境变量里写入 TAVILY_API_KEY
  3. 重启网关
openclaw gateway restart

验证:

  • 在聊天中触发联网搜索任务
  • 观察日志是否调用 Tavily Skill

6. 插件与技能的区别

  • Skills:偏“任务策略和工具编排”
  • 插件:偏“新增底层能力/命令/RPC”

插件常用命令:

openclaw plugins list
openclaw plugins install @openclaw/voice-call
openclaw gateway restart

7. 安全管理建议

  • 安装前先审查 Skill 来源与内容
  • 新 Skill 先在最小权限环境验证
  • 不要执行来路不明的手工命令
  • 团队场景统一审批和版本管理

8. 常用命令速查

openclaw skills list
clawhub search "keyword"
clawhub install <skill-slug>
clawhub update --all
openclaw plugins list
openclaw gateway restart

进阶配置完成后,建议回到 使用案例 挑一个场景做落地验证。