AI创想

标题: oepnclaw之skills开启以及配置Skills registry (ClawHub) [打印本页]

作者: 米落枫 时间: 前天 21:02
标题: oepnclaw之skills开启以及配置Skills registry (ClawHub)
作者：西京刀客
文章目录

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

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

在 openclaw.json 的 commands 字段中：

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

复制代码

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

方式 1：ClawHub CLI（推荐）

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

复制代码

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

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

复制代码

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

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

复制代码

Skills 管理命令

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

复制代码

在你的服务器上快速开始

# SSH 到服务器# 1. 创建 skills 目录mkdir -p /root/openclaw-docker/data/.openclaw/skills
# 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
# 4. 重启 gateway 使其生效（通常不需要）cd /root/openclaw-docker &&docker compose restart openclaw-gateway

复制代码

新手必装推荐

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

1. 理解 Skill 的本质

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

"workspace":"/home/node/openclaw"

复制代码

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

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

复制代码

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

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

2. 编写 Skill

目录结构

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

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

复制代码

进阶版（带代码）：

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

复制代码

SKILL.md 格式

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

复制代码

3. 部署 Skill 到 Docker 环境的 OpenClaw

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

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

复制代码

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

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

复制代码

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

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

复制代码

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

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

4. 使 Skill 生效

改了 SKILL.md 或代码文件（如 agent.py）

无需重启

改了 docker-compose.yml（环境变量、挂载路径等）或 openclaw.json（核心配置）

cd ~/openclaw-docker
docker compose restart openclaw-gateway

复制代码

5. 验证 Skill 是否加载

在 OpenClaw Dashboard 对话框中输入：

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

复制代码

或者查看日志确认加载：

docker compose logs openclaw-gateway |grep -i skill

复制代码

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

欢迎光临 AI创想 (https://llms-ai.com/)