OpenClaw 常用 Skills 全指南：安装、介绍、使用方法与排障

很多同学在用 OpenClaw 时，最常问的一句是：“我该装哪些 Skills，怎么装，装完怎么用？” 这篇文章把这三个问题一次讲清楚：Skills 是什么、怎么安装、怎么在实际开发里用起来，并附带常见问题排查清单。

1. Skills 是什么？为什么重要？

在 OpenClaw 里，Skill 可以理解为“能力插件”。OpenClaw 本体提供通用对话和执行框架，Skill 则提供某个场景的专业流程，比如：

• 文档总结与信息提炼
• 代码分析与生成
• 浏览器自动化
• 外部 API / MCP 工具编排

如果把 OpenClaw 比作操作系统，那 Skills 就像应用生态。你装的技能越贴近自己的工作流，效率提升越明显。

2. 安装前准备

• 已安装并可运行 OpenClaw
• Node.js 环境可用（建议较新 LTS）
• 终端可联网，且具备安装 npm 包权限

node -v
npm -v
openclaw --version

3. Skills 的安装方式

3.1 方式一：通过 ClawHub 安装（推荐）

先安装 ClawHub CLI：

npm i -g clawhub

常用命令：

# 搜索可用技能
clawhub search "summarize"

# 安装技能
clawhub install summarize

# 查看已安装技能
clawhub list

# 升级全部技能
clawhub update --all

3.2 方式二：本地手工安装（自定义技能）

如果你要做团队内部私有 Skill，直接放到本地 skills 目录即可。

mkdir -p ~/.openclaw/workspace/skills/hello-world
cat > ~/.openclaw/workspace/skills/hello-world/SKILL.md <<'MD'
---
name: hello_world
description: A simple custom skill
---

# Hello Skill
当用户请求打招呼时，返回一句固定欢迎词。
MD

保存后开启新会话（或重启相关服务）让 Skill 被重新加载。

4. 常用 Skills 介绍（新手建议先装这 4 类）

4.1 summarize（总结提炼）

适用场景：日志归纳、会议纪要、文档压缩、日报生成。

安装：

clawhub install summarize

使用示例：

/skill summarize 把下面 2000 行日志提炼成 5 条结论和 3 个风险点

4.2 开发辅助类 Skill（如 gemini 等）

适用场景：报错定位、代码解释、重构建议、方案对比。

安装（先查 slug 再安装）：

clawhub search "gemini"
clawhub install gemini

使用示例：

/skill gemini 分析这个函数可能的边界条件和性能瓶颈

4.3 图像/多模态类 Skill（如 nano-banana-pro）

适用场景：封面图生成、流程图素材、视觉草图。

安装：

clawhub search "nano-banana-pro"
clawhub install nano-banana-pro

使用示例：

/skill nano_banana_pro 生成一张“OpenClaw Skills 工作流”技术封面图

4.4 浏览器自动化类 Skill（如 agent-browser）

适用场景：自动登录、表单填写、后台运营、重复网页操作。

安装：

npm install -g agent-browser --prefix "$HOME/.local"
export PATH="$HOME/.local/bin:$PATH"
agent-browser install

使用示例：

agent-browser open https://blog.csdn.net/
agent-browser snapshot -i
agent-browser click @e1
agent-browser fill @e2 "文本内容"

5. Skills 的正确使用方法（实战重点）

5.1 触发方式

• 自然语言触发：在对话中明确“使用某技能完成某任务”
• 命令触发：/skill <name> <input>

5.2 配置启用/禁用与环境变量

可在 ~/.openclaw/openclaw.json 中集中管理：

{
  "skills": {
    "entries": {
      "summarize": { "enabled": true },
      "gemini": {
        "enabled": true,
        "apiKey": "YOUR_KEY",
        "env": { "GEMINI_API_KEY": "YOUR_KEY" }
      },
      "nano-banana-pro": { "enabled": false }
    },
    "load": {
      "watch": true,
      "watchDebounceMs": 250
    }
  }
}

5.3 一个可落地的工作流模板

1. 先用 summarize 压缩需求文档
2. 再用开发辅助 Skill 输出代码方案
3. 最后用浏览器自动化 Skill 做发布或运营动作

这样组合的优势是：信息压缩、代码执行、外部操作三段式闭环。

6. 常见问题与排查

6.1 安装后技能不生效

• 新开一个 OpenClaw 会话重试
• 检查 skills 目录优先级是否被同名覆盖
• 确认 SKILL.md frontmatter 语法正确

6.2 报权限错误（EACCES）

建议安装到用户目录，避免写系统目录：

npm install -g <package> --prefix "$HOME/.local"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

6.3 依赖缺失导致运行失败

检查 Skill 是否要求额外二进制、系统依赖或 API Key；缺一项都可能无法触发。

7. 安全建议

• 优先安装可信来源 Skill
• 阅读 SKILL.md 再执行
• 敏感环境建议最小权限与隔离运行

8. 结语

对 OpenClaw 而言，Skills 不是“可选项”，而是让智能体从“会回答”进化到“会干活”的关键。建议你先安装 2~3 个高频 Skill，跑通一个完整业务流程，再逐步扩展技能库。

如果你希望，我可以下一篇继续写：“如何从 0 到 1 自定义一个团队专属 OpenClaw Skill（含模板与最佳实践）”。

参考资料（官方）

• Skills（中文）
• Skills 配置（中文）
• 创建 Skills（中文）
• Slash Commands
• ClawHub