OpenClaw Skills 安装指南

📚 适用人群：新手友好 | 中文详细说明

---

📖 什么是 Skills？

Skills（技能） 是 OpenClaw 的"功能扩展包"。就像手机安装 APP 一样，Skills 可以为你的 AI 助手添加新能力，比如：

• 📅 管理日历和提醒事项
• 📧 收发邮件
• 🌤️ 查询天气
• 📷 处理图片
• 🔧 连接各种工具和服务

---

🎯 Skills 从哪里来？

Skills 有三个来源：

来源	位置	说明
内置 Skills	安装包自带	安装 OpenClaw 时自动包含，无需额外操作
ClawHub	在线注册中心	类似"应用商店"，可搜索、下载更多 Skills
自定义 Skills	本地创建	自己编写或从别处获取的 Skills

---

✅ 方法一：查看已安装的 Skills

安装 OpenClaw 后，已经有一些内置 Skills 可用。查看方法：

# 列出所有可用的 Skills
openclaw skills list

# 只列出当前可用的（已满足条件的）Skills
openclaw skills list --eligible

# 查看某个 Skills 的详细信息
openclaw skills info <skills 名称>

# 检查哪些 Skills 缺少依赖（如环境变量、工具等）
openclaw skills check

---

📥 方法二：从 ClawHub 安装新 Skills

ClawHub 是 OpenClaw 的官方 Skills 商店，里面有社区分享的各种 Skills。

第 1 步：安装 ClawHub 命令行工具

打开终端，运行以下命令（二选一）：

# 使用 npm 安装（推荐）
npm i -g clawhub

# 或使用 pnpm 安装
pnpm add -g clawhub

💡 如果提示权限不足，在命令前加 sudo（Mac/Linux）或以管理员身份运行终端（Windows）

第 2 步：搜索需要的 Skills

# 搜索关键词（用英文搜索，如 calendar、weather、email 等）
clawhub search "calendar"

# 限制结果数量
clawhub search "weather" --limit 5

第 3 步：安装 Skills

找到想要的 Skills 后，记下它的名称（slug），然后安装：

# 安装指定 Skills
clawhub install <skills 名称>

# 例如：
clawhub install weather-skill

第 4 步：重启 OpenClaw 会话

安装完成后，需要启动新的 OpenClaw 会话才能使用新 Skills：

# 在 OpenClaw 中输入 /new 或 /reset 启动新会话

---

🔄 更新已安装的 Skills

定期更新 Skills 以获取新功能：

# 更新所有已安装的 Skills
clawhub update --all

# 更新单个 Skills
clawhub update <skills 名称>

---

🛠️ 方法三：手动安装 Skills（高级）

如果 Skills 没有发布到 ClawHub，可以手动安装。

步骤：

1. 找到 Skills 文件夹（通常是一个包含 SKILL.md 文件的目录）

2. 复制到工作区：

   # 将 Skills 复制到工作区的 skills 目录
   cp -r /path/to/skill ~/.openclaw/workspace/skills/
   

3. 或复制到全局目录（所有会话可用）：

   cp -r /path/to/skill ~/.openclaw/skills/
   

4. 重启 OpenClaw 会话使新 Skills 生效

---

⚙️ Skills 配置（可选）

某些 Skills 需要配置 API 密钥或环境变量。

配置文件位置：

~/.openclaw/openclaw.json

配置示例：

{
  "skills": {
    "entries": {
      "weather-skill": {
        "enabled": true,
        "apiKey": "你的 API 密钥",
        "env": {
          "WEATHER_API_KEY": "你的 API 密钥"
        }
      }
    }
  }
}

---

❓ 常见问题

Q1: 安装后 Skills 不生效？

A: 需要启动新的 OpenClaw 会话。输入 /new 或 /reset 重启会话。

Q2: 提示缺少某个命令/工具？

A: 某些 Skills 需要额外安装依赖。查看提示信息，安装缺少的工具：

# 例如缺少 gemini 命令
brew install gemini-cli  # Mac
npm i -g gemini-cli      # 通用

Q3: 提示缺少环境变量？

A: 需要在配置文件中添加 API 密钥，参考上面的"Skills 配置"部分。

Q4: 如何禁用某个 Skills？

A: 在 ~/.openclaw/openclaw.json 中设置：

{
  "skills": {
    "entries": {
      "某个 skills": {
        "enabled": false
      }
    }
  }
}

Q5: 如何查看 Skills 是否满足运行条件？

A: 运行检查命令：

openclaw skills check

---

📚 相关资源

资源	链接
ClawHub 官网	https://clawhub.com
OpenClaw 官方文档	https://docs.openclaw.ai
中文文档	~/.npm-global/lib/node_modules/openclaw/docs/zh-CN/

---

🎯 快速命令参考

# ===== 查看 Skills =====
openclaw skills list           # 列出所有 Skills
openclaw skills list --eligible # 只列出可用的
openclaw skills info <名称>     # 查看详细信息
openclaw skills check          # 检查依赖

# ===== ClawHub 操作 =====
clawhub search "关键词"         # 搜索 Skills
clawhub install <名称>          # 安装 Skills
clawhub update --all           # 更新所有 Skills
clawhub list                   # 列出已安装的

# ===== 会话管理 =====
/new 或 /reset                 # 重启会话（使新 Skills 生效）

---

💡 提示：遇到问题时，先运行 openclaw skills check 查看缺少的依赖，然后根据提示安装即可。

---

文档版本：1.0 | 最后更新：2026-03-19