OpenClaw Skill安装配置指南

# 案例 03：安装 OpenClaw-Skill

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

## 什么是 Skill？

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

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

---

## 安装方式对比

| 方式 | 触发入口 | 适用场景 | 推荐度 | 推荐原因 |
|------|----------|----------|--------|----------|
| ClawHub CLI | 终端命令 | 安装官方/公开 skill | ★★★★★ | 版本管理、搜索、更新、卸载一站式完成 |
| AI 聊天框 | 对话消息 | 自然语言安装 skill | ★★★★☆ | 自然语言交互，AI 自动执行安装命令 |
| TUI 界面 | 斜杠命令 | 交互式管理 | ★★★☆☆ | 终端内可视化操作，适合命令行用户 |
| Control UI | 浏览器界面 | 图形化管理 | ★★★☆☆ | Web 界面直观，适合图形化偏好用户 |
| 手动复制 | 文件操作 | 私有/本地 skill | ★★★★☆ | 简单直接，离线可用，适合私有 skill |

---

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

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

### 1. 安装 ClawHub CLI

```bash
npm i -g clawhub
# 或
pnpm add -g clawhub
```

### 2. 认证登录

```bash
clawhub 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

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

---

## 方式二：AI 聊天框安装

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

### 使用方法

**安装 ClawHub 上的 skill：**

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

**从 GitHub 仓库安装：**

```
请帮我安装这个 skill：https://github.com/user/skill-repo
```

**让 AI 学习参考文档：**

```
请学习这个 OpenClaw 参考文档：https://github.com/kingdoooo/openclaw-setup-guides
```

### 工作原理

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

### 优点

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

---

## 方式三：TUI 界面管理

### 启动 TUI

```bash
openclaw gateway    # 先启动 Gateway
openclaw tui        # 打开 TUI
```

### 安装 Skill

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

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

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

| 命令 | 说明 |
|------|------|
| `/skill install <name>` | 安装 ClawHub 上的 skill |
| `/skill install <url>` | 从 Git 仓库 URL 安装 |
| `/skill list` | 列出已安装的 skills |
| `/skill update <name>` | 更新指定 skill |
| `/skill remove <name>` | 删除指定 skill |

### 其他可用命令

| 命令 | 说明 |
|------|------|
| `/help` | 帮助信息 |
| `/status` | 查看状态 |

### 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+G` | Agent 选择器 |
| `Ctrl+P` | Session 选择器 |
| `Ctrl+L` | Model 选择器 |

---

## 方式四：Control UI（Web 界面）

### 启动 Dashboard

```bash
openclaw dashboard
```

浏览器打开 http://127.0.0.1:18789/，在 Agents/Tools 面板中管理 skills。

---

## 方式五：手动复制安装

适合私有 skill 或离线环境。

### 从 Git 仓库安装

```bash
# 克隆仓库
git clone https://github.com/user/skill-repo.git

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

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

### 运行安装脚本（如有）

```bash
cd ~/.openclaw/skills/skill-name
bash setup.sh
```

---

## Skill 存储位置

| 位置 | 说明 | 优先级 |
|------|------|--------|
| Bundled skills | 随 OpenClaw 安装包自带 | 最高 |
| `~/.openclaw/skills/` | 托管 skills（所有 Agent 共享） | 中 |
| `<workspace>/skills/` | 工作区 skills（仅该 Agent 可用） | 低 |

---

## 配置 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: "https://api.example.com"
        }
      }
    }
  }
}
```

---

## 验证安装

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

---

## 安全提示

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

---

## 相关链接

- [ClawHub Skill 市场](https://clawhub.ai)
- [OpenClaw 官方文档](https://docs.openclaw.ai)

---

[返回目录](../openclaw-enterprise-hands-on-guide.md)

*最后更新：2026-03-18*