OpenClaw 技能开发从 0 到 1:手把手教你发布第一个 ClawHub 技能

# 全局安装 clawhub

npm i -g clawhub

# 浏览器登录

clawhub login

# 验证登录状态

clawhub whoami

⚠️ 注意：首次登录会打开浏览器授权，确保使用与 GitHub 关联的账号。

my-openclaw-workspace/

├── skills/ # 技能存放目录

├── .clawhub/ # CLI 配置

└── .openclaw/ # OpenClaw 配置

mkdir -p my-openclaw-workspace/skills

cd my-openclaw-workspace

--- name: weather-check version: 1.0.0 description: 查询任意城市当前天气和空气质量 tags: [weather, api, utility, daily] requirements:   - node >= 18   - npm packages: axios ---  # Weather Check Skill  ## 功能描述 调用 wttr.in API 返回指定城市的当前天气，包括： - 温度、湿度、风速 - 天气状况（晴/雨/雪等） - 空气质量指数（可选）  ## 使用方法 /weather 北京 /weather Shanghai  ## 配置变量 - WTTR_LANG: 选填，语言设置（默认 zh-cn） - INCLUDE_AQI: 选填，是否包含空气质量（默认 false）  ## 示例 用户：/weather 北京 助手：北京当前天气：晴，温度 25°C，湿度 45%...

天气查询技能（入门级）

🎯 功能

调用 wttr.in API 返回指定城市的当前天气

📚 学习点

• 基础 SKILL.md 结构

• API 调用方法

• 环境变量使用

# 创建技能目录

mkdir -p skills/weather-check

# 编写 SKILL.md（内容见上方示例）

cd skills/weather-check

# 测试技能

openclaw --workdir .

💡 提示：wttr.in 是免费 API，无需密钥。测试命令：curl wttr.in/北京

待办事项管理（进阶级）

🎯 功能

本地文件存储待办，支持增删改查

📚 学习点

• 文件操作（读写 JSON）

• 状态管理

• 命令解析

📋 支持命令

/todo add "买牛奶"

/todo list

/todo complete 1

/todo delete 1

💡 提示：数据存储在用户工作区的 .openclaw/todos.json，注意路径权限。

GitHub 仓库监控（高级）

🎯 功能

监控 repo star 变化，超阈值自动通知

📚 学习点

• 定时任务（Heartbeat）

• API 认证（GitHub Token）

• 条件触发与通知

--- name: github-watcher version: 1.0.0 description: 监控 GitHub 仓库 Star 变化，超阈值通知 tags: [github, monitoring, notification, developer] requirements:   - GITHUB_TOKEN 环境变量   - node >= 18 ---  # GitHub Watcher  ## 配置 - REPO: 必填，仓库地址（如：openclaw/openclaw） - THRESHOLD: 必填，通知阈值（如：100） - GITHUB_TOKEN: 必填，GitHub Personal Access Token  ## 使用 /github-watch start /github-watch status /github-watch stop

⚠️ 安全提示：GITHUB_TOKEN 不要硬编码在 SKILL.md 中，使用环境变量或 OpenClaw 的 secrets 管理。

clawhub publish ./skills/weather-check \

--slug weather-check \

--name "Weather Check" \

--version 1.0.0 \

--changelog "Initial release" \

--tags latest,weather,utility

✅ 发布成功输出：✓ Skill published successfully!✓ Slug: weather-check✓ Version: 1.0.0✓ URL: https://claw-hub.net/skills/weather-check

# 查看已发布版本

clawhub list

# 更新版本

clawhub publish ./skills/weather-check \

--version 1.1.0 \

--changelog "Added humidity display"

# 批量同步（多技能场景）

clawhub sync --all --bump patch \

--changelog "Bug fixes"

1. 技能开发门槛低

只需 Markdown + 基础脚本，无需复杂框架

2. 生态价值大

每个技能都可能帮助成千上万用户

3. 成长路径清晰

从模仿模板 → 修改优化 → 原创技能

📝 今天就开始：

1. Fork 本文提供的 3 个模板

2. 修改一个满足自己需求

3. 发布到 ClawHub