OpenClaw Skills 安装指南

OpenClaw Skills 完整安装与管理指南

???? 适用对象：所有技能水平用户 | 提供详尽中文步骤说明

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

???? 理解 OpenClaw Skills 核心概念

Skills 是 OpenClaw 的模块化功能扩展，其作用类似于智能手机的应用程序。通过集成不同的技能，你可以系统化地拓展 AI 助手的原生能力边界。典型的技能模块通常涵盖以下领域：

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

???? Skills 的来源与获取途径

根据你的具体使用场景和需求，可以通过以下三种主要渠道获取 Skills：

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

完成 OpenClaw 初始部署后，系统已预置一组核心技能。通过命令行工具可以快速盘点与验证其状态。

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

# 仅列出当前满足运行条件的 Skills
openclaw skills list --eligible

# 查看某个 Skills 的详细信息
openclaw skills info 

# 检查 Skills 的依赖项（如环境变量、工具等）
openclaw skills check

???? 方法二：通过 ClawHub 安装新 Skills

ClawHub 是扩展 OpenClaw 功能的核心资源库。遵循以下步骤即可安全地搜索与安装社区技能。

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

首先需要配置访问 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 

# 示例：安装天气技能
clawhub install weather-skill

第 4 步：重启 OpenClaw 会话

安装完成后，必须启动一个新的 OpenClaw 会话才能使新技能加载生效。

# 在 OpenClaw 界面中输入 /new 或 /reset 重启会话

???? 更新已安装的 Skills

定期更新 Skills 可以确保你获得最新的功能增强和安全补丁。更新操作可通过以下命令完成。

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

# 更新单个指定的 Skills
clawhub update 

????️ 方法三：手动安装本地 Skills（高级）

对于尚未发布至 ClawHub 的本地 Skills 文件（如自行开发或从其他来源获取），可采用手动部署方式。

步骤：

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 命令
# 在 Mac 上可以使用 Homebrew
brew install gemini-cli

# 或者使用 npm 全局安装（通用）
npm i -g gemini-cli

Q3: 提示缺少环境变量？

A: 这通常意味着需要配置 API 密钥。请参考上面的“Skills 配置”部分，在配置文件中添加相应的密钥。

Q4: 如何禁用某个 Skills？

A: 无需卸载，在配置文件中将其设置为禁用状态即可：

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

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

A: 运行一个专门的检查命令，它会列出所有 Skills 的状态和缺失项：

openclaw skills check

???? 相关资源

???? 快速命令参考

# ====== 查看 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 生效）

???? 排查 Skills 相关问题的一个高效习惯：首先运行 openclaw skills check。该命令能系统性地诊断依赖缺失、配置错误或环境异常等常见问题。

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