案例 03：安装 OpenClaw-Skill

掌握 Skill 的多种安装方式，扩展 OpenClaw 能力

什么是 Skill？

Skill 是可重用的指令集（SKILL.md 文件），在运行时加载到系统提示中，用于扩展 Agent 的能力。

Skill 文件结构：

skill-name/
├── SKILL.md              # 主文件（必需）
├── references/           # 参考文档（可选）
├── scripts/              # 脚本文件（可选）
└── setup.sh              # 安装脚本（可选）

安装方式对比

方式一：ClawHub CLI 安装（推荐）

ClawHub 是 OpenClaw 官方的 Skill 市场，支持版本管理、搜索、更新。

1. 安装 ClawHub CLI

bashnpm i -g clawhub
# 或
pnpm add -g clawhub

2. 认证登录

bashclawhub login                    # 浏览器登录
clawhub login --token <token>    # 使用 API token
clawhub whoami                   # 查看当前用户

3. 搜索和安装

bash# 搜索 skill
clawhub search "email"

# 安装 skill
clawhub install <skill-slug>                    # 安装最新版
clawhub install <skill-slug> --version 0.0.10   # 安装指定版本
clawhub install <skill-slug> --force            # 强制覆盖安装

4. 管理已安装的 Skill

bashclawhub list                    # 列出已安装
clawhub update <skill-slug>     # 更新指定 skill
clawhub update --all            # 更新全部
clawhub delete <skill-slug>     # 删除

方式二：AI 聊天框安装

通过自然语言对话让 AI 帮你安装 skill。

使用方法

安装 ClawHub 上的 skill：

请帮我安装 imap-smtp-email 这个 skill

从 GitHub 仓库安装：

请帮我安装这个 skill：

让 AI 学习参考文档：

请学习这个 OpenClaw 参考文档：

工作原理

AI 会自动：

1. 使用 web_fetch 获取 skill 内容
2. 使用 exec 执行 clawhub install 命令
3. 使用 fs 工具将 skill 写入 ~/.openclaw/skills/ 目录

优点

• 自然语言交互，无需记忆命令
• 安装结果持久化保存
• AI 可自动处理依赖和配置

方式三：TUI 界面管理

启动 TUI

bashopenclaw gateway    # 先启动 Gateway
openclaw tui        # 打开 TUI

安装 Skill

方法一：通过设置面板安装

1. 启动 TUI 后，输入 /settings 进入设置面板
2. 使用方向键选择 "Skills" 或 "Skill Manager" 选项
3. 在 Skill 管理界面中：
   • 按 i 或选择 "Install" 安装新 skill
   • 输入 skill 名称（从 ClawHub）或 Git 仓库 URL
   • 按 Enter 确认安装

方法二：使用斜杠命令安装

其他可用命令

快捷键

方式四：Control UI（Web 界面）

启动 Dashboard

bashopenclaw dashboard

浏览器打开 Agents/Tools 面板中管理 skills。

方式五：手动复制安装

适合私有 skill 或离线环境。

从 Git 仓库安装

bash# 克隆仓库
git clone 

# 复制到共享目录（所有 Agent 可用）
cp -r skill-repo ~/.openclaw/skills/skill-name

# 或复制到工作区（仅当前 Agent 可用）
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

运行安装脚本（如有）

bashcd ~/.openclaw/skills/skill-name
bash setup.sh

Skill 存储位置

配置 Skill

在 openclaw.json 中配置已安装的 skill：

json5{
  skills: {
    // 加载配置
    load: {
      watch: true,              // 自动监听文件变化
      extraDirs: [              // 额外的 skill 目录
        "/path/to/shared/skills"
      ]
    },
    
    // Skill 配置
    entries: {
      "my-skill": {
        enabled: true,          // 启用/禁用
        apiKey: {               // API Key
          source: "env",
          id: "MY_API_KEY"
        },
        config: {               // 自定义配置
          endpoint: ""
        }
      }
    }
  }
}

验证安装

bashopenclaw status              # 查看整体状态
openclaw doctor              # 诊断问题
clawhub list                 # 列出已安装的 skills

安全提示

1. 信任来源：第三方 skills 启用前先阅读 SKILL.md 内容
2. 密钥管理：skills.entries.*.env 和 .apiKey 会注入到进程环境
3. 避免泄露：不要在提示和日志中暴露密钥

相关链接

• ClawHub Skill 市场
• OpenClaw 官方文档

最后更新：2026-03-18