oepnclaw之skills开启以及配置Skills registry (ClawHub)

作者：西京刀客
文章目录

oepnclaw之skills开启以及配置Skills registry (ClawHub)

配置项说明三种安装方式Skills 管理命令新手必装推荐将自定义 Skill 部署到 OpenClaw 的方法

1. 理解 Skill 的本质2. 编写 Skill

目录结构SKILL.md 格式

3. 部署 Skill 到 Docker 环境的 OpenClaw

方式 A：放到用户技能目录方式 B：放到工作区技能目录（推荐）

4. 使 Skill 生效5. 验证 Skill 是否加载

oepnclaw之skills开启以及配置Skills registry (ClawHub)

Skills 来自社区公共注册表（3000+ 个），安装前建议查看源码
不要安装来路不明的 Skill
优先选择 ClawHub 官方市场中的高星技能
配置项说明

在 openclaw.json 的 commands 字段中：

1. "commands":{"native":"auto",// 原生命令执行能力"nativeSkills":"auto"// Skills 功能开关}

复制代码

“auto” 自动启用（推荐），检测到已安装的 Skill 时自动加载
“on” 强制开启
“off” 关闭 Skills 功能
三种安装方式

方式 1：ClawHub CLI（推荐）

1. # 进入容器dockerexec -it openclaw-docker-openclaw-gateway-1 sh# 安装指定技能
2. npx clawhub@latest install<skill-slug># 示例
3. npx clawhub@latest install frontend-design
4. npx clawhub@latest install remind-me

复制代码

方式 2：手动安装
将 Skill 文件夹放到以下目录：

1. 位置        路径        优先级
2. 全局        ~/.openclaw/skills/        低
3. 工作空间        <项目目录>/skills/        高

复制代码

对应你的服务器：
全局路径 → /root/openclaw-docker/data/.openclaw/skills/
工作空间 → /root/openclaw-docker/data/openclaw/skills/
方式 3：聊天安装（最简单）
直接在企业微信对话中发送 Skill 的 GitHub 链接给 OpenClaw，它会自动安装：

1. 帮我安装这个skill: https://github.com/xxx/remind-me

复制代码

Skills 管理命令

1. # 查看已安装
2. npx clawhub@latest list
4. # 更新技能
5. npx clawhub@latest update <skill-slug># 卸载技能
6. npx clawhub@latest uninstall <skill-slug># 在 OpenClaw CLI 中查看node dist/index.js skills list

复制代码

在你的服务器上快速开始

1. # SSH 到服务器# 1. 创建 skills 目录mkdir -p /root/openclaw-docker/data/.openclaw/skills
3. # 2. 进入容器安装 skilldockerexec -it openclaw-docker-openclaw-gateway-1 sh -c "npx clawhub@latest install remind-me"# 3. 验证安装dockerexec openclaw-docker-openclaw-gateway-1 node dist/index.js skills list
5. # 4. 重启 gateway 使其生效（通常不需要）cd /root/openclaw-docker &&docker compose restart openclaw-gateway

复制代码

新手必装推荐

Agent Browser：控制无头浏览器，自动浏览网页、填表、截图
Remindme: 自然语言设置定时提醒，支持一次性和循环‘
你说的话 效果
/remindme 10分钟后喝水 10 分钟后提醒你喝水
/remindme 明天早上9点站会 明天 9:00 提醒
/remindme 下周一下午6点打电话给妈妈 下周一 18:00 提醒
/remindme every day at 9am 日报 每天 9:00 提醒写日报
/remindme every friday at 5pm 周总结 每周五 17:00 提醒
/remindme list 查看所有已设置的提醒
/remindme cancel 取消某个提醒
Todo-tracker: 跨会话持久化 TODO 清单管理
Web-search : 用 DuckDuckGo 搜索网页、新闻、图片、视频
邮件管理：gog
用来连接 Gmail。
只需要通过 Google Cloud Console 生成一个 OAuth token 给它就行，不会操作的话可以让 AI 一步步教你。
装完之后，我现在完全让它帮我看邮件、筛选重要信息、处理回复：

将自定义 Skill 部署到 OpenClaw 的方法

1. 理解 Skill 的本质

OpenClaw Skill 是以文件夹为单位的"能力描述 + 执行逻辑"组合包，核心是一个 SKILL.md 文件，AI 通过阅读它来理解技能。
Skill 加载路径由 openclaw.json 中的 workspace 配置决定。
关键配置在 /home/node/.openclaw/openclaw.json 中：

1. "workspace":"/home/node/openclaw"

复制代码

这个 workspace 字段定义了 OpenClaw 的工作区根目录。OpenClaw 会在工作区根目录下寻找 skills/ 子目录来加载技能，所以最终路径就是：

1. {workspace}/skills/ → /home/node/openclaw/skills/

复制代码

加载优先级（从高到低）：

优先级	位置	说明
1	<workspace>/skills/	工作区技能（团队共享）
2	~/.openclaw/skills/	用户技能（个人专属）
3	内置技能	系统自带，可被覆盖

2. 编写 Skill

目录结构

基础版（纯文本，零代码）：

1. my-skill/
2. └── SKILL.md          # 唯一必需文件

复制代码

进阶版（带代码）：

1. my-skill/
2. ├── SKILL.md          # 核心描述文件
3. ├── agent.py          # Python 执行逻辑
4. └── references/       # 辅助资源（可选）
5.     └── example.png

复制代码

SKILL.md 格式

1. ---
2. name: my-custom-skill
3. description: 简短描述你的技能功能
4. version: 1.0.0
5. author: your-name
6. permissions: 文件读写权限、网络访问权限
7. ---
9. # Description
10. 详细描述技能的功能和作用。
12. # When to use
13. - 用户说："帮我查一下 httpcat 上有哪些文件"
14. - 用户说："上传这个文件到 httpcat"
16. # How to use
17. 1. 从用户指令中提取参数
18. 2. 执行对应的操作
19. 3. 返回结果
21. # Edge cases
22. - 如果文件不存在，提示用户
23. - 如果网络不可用，给出错误信息

复制代码

3. 部署 Skill 到 Docker 环境的 OpenClaw

根据你的 docker-compose.yml 架构，OpenClaw 容器挂载了两个目录：

1. ./data/.openclaw → /home/node/.openclaw（配置目录）
2. ./data/openclaw  → /home/node/openclaw（工作区目录）

复制代码

因此有两种部署方式：
方式 A：放到用户技能目录

1. cd ~/openclaw-docker
3. # 创建 skills 目录mkdir -p ./data/.openclaw/skills/my-custom-skill
5. # 将 SKILL.md 放进去cp /path/to/my-custom-skill/SKILL.md ./data/.openclaw/skills/my-custom-skill/
7. # 如果有代码文件也一起复制cp /path/to/my-custom-skill/agent.py ./data/.openclaw/skills/my-custom-skill/
9. # 修复权限（容器以 node:node uid=1000 运行）chown -R 1000:1000 ./data/.openclaw/skills/

复制代码

对应容器内路径：/home/node/.openclaw/skills/my-custom-skill/
方式 B：放到工作区技能目录（推荐）

1. cd ~/openclaw-docker
3. # 创建工作区 skills 目录mkdir -p ./data/openclaw/skills/my-custom-skill
5. # 复制文件cp /path/to/my-custom-skill/SKILL.md ./data/openclaw/skills/my-custom-skill/
7. # 如果有代码文件也一起复制cp /path/to/my-custom-skill/agent.py ./data/openclaw/skills/my-custom-skill/
9. # 修复权限chown -R 1000:1000 ./data/openclaw/skills/

复制代码

对应容器内路径：/home/node/openclaw/skills/my-custom-skill/

工作区技能优先级更高，会覆盖同名的用户技能和内置技能。

4. 使 Skill 生效

改了 SKILL.md 或代码文件（如 agent.py）：系统会在约 30 秒内自动刷新，无需重启。因为 SKILL.md 由 Gateway 动态加载，agent.py 等脚本是 AI 在运行时通过 bash 调用的，每次执行都读取最新文件。改了 docker-compose.yml（环境变量、挂载路径等）或 openclaw.json（核心配置）：需要重启 Gateway：

1. cd ~/openclaw-docker
2. docker compose restart openclaw-gateway

复制代码

5. 验证 Skill 是否加载

在 OpenClaw Dashboard 对话框中输入：

1. 你现在有哪些 skills？列出所有可用技能

复制代码

或者查看日志确认加载：

1. docker compose logs openclaw-gateway |grep -i skill

复制代码

原文地址：https://blog.csdn.net/inthat/article/details/158098147