OpenClaw 技能系统完全指南：安装、配置与自定义

这个场景解决什么问题

默认的 OpenClaw 只能聊天。通过安装技能（Skills），AI 助手可以查天气、搜网页、读文件、控制智能家居——技能是 OpenClaw 的超能力扩展包。

直接复制这段：安装常用技能

clawhub install weather         # 天气查询（免费，无需配置）
clawhub install tavily-search   # 网页搜索（需要 Tavily API Key）
clawhub list                    # 查看已安装技能
openclaw gateway restart        # 重启生效

核心步骤

第一步：了解技能系统

技能 = 一个 SKILL.md 文件 + 可选的脚本/工具

SKILL.md 告诉 AI：

• 这个技能是做什么的
• 需要什么配置（API Key 等）
• 怎么用（示例命令）

第二步：搜索和安装技能

# 搜索技能
clawhub search weather
clawhub search search
clawhub search home-assistant

# 安装技能
clawhub install weather
clawhub install tavily-search
clawhub install homeassistant-assist

# 查看已安装的技能
clawhub list

# 更新所有技能
clawhub update

# 卸载技能
clawhub uninstall weather

安装后重启生效：

openclaw gateway restart

第三步：推荐入门技能清单

技能名	功能	需要配置
weather	天气查询	无（使用免费 API）
tavily-search	网页搜索	Tavily API Key
homeassistant-assist	智能家居控制	HA Token
reminder	提醒管理	无
note-taking	笔记记录	无
git-sync	代码自动同步	GitHub Token

第四步：配置技能参数

大多数技能需要在 ~/.openclaw/openclaw.json 配置 env：

{
  "env": {
    "TAVILY_API_KEY": "tvly-xxx",
    "WEATHER_API_KEY": "xxx",
    "HASS_SERVER": "http://homeassistant.local:8123",
    "HASS_TOKEN": "eyJ..."
  }
}

第五步：自定义技能（进阶）

创建自己的技能：

mkdir ~/.openclaw/workspace/skills/my-skill
cat > ~/.openclaw/workspace/skills/my-skill/SKILL.md << 'EOF'
# My Custom Skill

## 功能描述
这个技能用于...

## 配置要求
需要在 env 中配置 MY_API_KEY

## 使用示例
- "帮我..." → 调用相应工具

## 工具说明
### query_data
查询数据接口
EOF

关键配置

技能目录结构：

~/.openclaw/workspace/skills/
├── weather/
│   └── SKILL.md
├── tavily-search/
│   ├── SKILL.md
│   └── search.js
└── my-custom-skill/
    ├── SKILL.md
    └── scripts/
        └── my-tool.py

技能不生效的排查：

1. 检查 clawhub list 是否在列表里
2. 确认重启了 Gateway
3. 查看日志：openclaw logs
4. 确认 env 变量配置正确

预期结果

• AI 可以查询实时天气
• AI 可以搜索网页获取最新信息
• 智能家居可以通过聊天控制

注意事项

• 技能安装后必须重启 Gateway 才生效
• 技能之间可能有冲突，按需安装
• ClawHub 上的技能由社区维护，安装前查看 star 数和更新时间
• 自定义技能放在 workspace/skills/ 目录，不要放在 clawhub 管理的目录