OpenClaw Skill 指南：从零开始打造专属 AI 助手

3. 验证 Skill 创建完成后，重启 OpenClaw 会话，技能会自动加载！

第二步：配置 Skill

Skill 的配置在 ~/.openclaw/openclaw.json 文件中。

基本配置结构

{
  "skills": {
    "load": {
      "watch": true,
      "watchDebounceMs": 250,
      "extraDirs": []
    },
    "entries": {
      "my-skill": {
        "enabled": true,
        "apiKey": {
          "source": "env",
          "provider": "default",
          "id": "MY_API_KEY"
        },
        "env": {
          "MY_API_KEY": "your-key-here"
        },
        "config": {
          "endpoint": "https://api.example.com"
        }
      }
    },
    "allowBundled": null
  }
}

常用配置选项

第三步：Skill 元数据与过滤

通过 metadata 字段，你可以控制 Skill 的加载条件和行为。

基本元数据

---
name: my-skill
description: 示例技能
metadata:
  openclaw:
    emoji: 🚀
    homepage: https://example.com
    requires:
      bins: [python, node]
      env: [MY_API_KEY]
      config: [browser.enabled]
    primaryEnv: MY_API_KEY
    install:
      - id: npm
        kind: node
        package: my-package
        bins: [my-cli]
        label: Install via npm
---

元数据字段说明

第四步：使用 ClawHub 安装技能

ClawHub 是 OpenClaw 的公共技能仓库，可以轻松发现和安装社区技能。

安装 ClawHub CLI

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

搜索技能

clawhub search "calendar"

安装技能

# 安装到当前目录
clawhub install skill-name
# 安装指定版本
clawhub install skill-name --version 1.0.0
# 强制覆盖
clawhub install skill-name --force

更新技能

# 更新所有已安装的技能
clawhub update --all
# 更新单个技能
clawhub update skill-name

查看已安装技能

clawhub list

第五步：实战案例

案例 1：创建一个代码生成技能

# 创建技能目录
mkdir ~/.openclaw/workspace/skills/code-generator
cd ~/.openclaw/workspace/skills/code-generator
# 编写 SKILL.md
cat > SKILL.md <<'EOF'
---
name: code-generator
description: 生成各种编程语言的代码模板和示例
metadata:
  openclaw:
    emoji: 💻
    requires:
      env: [OPENAI_API_KEY]
    primaryEnv: OPENAI_API_KEY
---
# 代码生成器
## 功能
根据用户需求生成不同编程语言的代码模板和示例。
## 支持的语言
- Python
- JavaScript
- Java
- Go
- Rust
- C++
## 使用方法
1. 确认用户需要的编程语言
2. 生成对应的代码模板
3. 提供详细注释和使用说明
EOF

案例 2：配置 API 密钥 编辑 ~/.openclaw/openclaw.json：

{
  "skills": {
    "entries": {
      "code-generator": {
        "enabled": true,
        "apiKey": "sk-your-api-key-here"
      }
    }
  }
}

第六步：高级技巧

1. 技能热重载 启用文件监听后，修改 Skill 文件会自动重载：

{
  "skills": {
    "load": {
      "watch": true,
      "watchDebounceMs": 250
    }
  }
}

2. 插件技能 插件可以自带 Skill，在 openclaw.plugin.json 中声明：

{"skills": ["./skills/my-skill"]}

3. 技能 Token 影响 每个 Skill 会消耗约 24 tokens（基础开销 + 字段长度）。优化方法：

• 保持 name 和 description 简洁
• 使用 disable-model-invocation 减少不必要的技能加载

最佳实践

推荐做法

1. 清晰的命名：使用描述性的 skill 名称
2. 完整的文档：在 SKILL.md 中提供详细说明
3. 合理过滤：使用 metadata.requires 避免不必要的加载
4. 安全第一：不在 Skill 中硬编码密钥
5. 版本管理：使用语义化版本号

避免做法

1. 硬编码密钥：使用 apiKey 或 env 配置
2. 过度复杂：保持 Skill 简单专注
3. 忽略错误：提供清晰的错误提示
4. 重复造轮子：先搜索 ClawHub 是否有现成技能

技能管理命令速查表