🦞 OpenClaw Skill 指南

国内用户安装与使用 OpenClaw Skills 的完整指南

📋 概述

OpenClaw 的 Skills 技能系统采用四级加载优先级,支持多种安装方式,适用于国内网络环境。

优先级 来源 路径
ClawHub 在线仓库 插件市场
Agent Workspace agents/workspace/skills/
本地目录(推荐) ~/.openclaw/skills/
系统内置 核心默认技能

🚀 快速开始

1. 创建本地 Skill 目录

mkdir -p ~/.openclaw/skills/my-skill

2. 创建 SKILL.md 定义文件

---
name: my-skill
description: 我的自定义技能
version: 1.0.0
author: your-name
---

# 技能说明
调用方式:@my-skill 参数

3. 编写实现脚本

// index.js
module.exports = async function(args, context) {
  return "执行结果";
};

4. 重启生效

sudo systemctl restart openclaw

💬 IM 工具调用

基本格式: @skill-name 参数

调用示例

场景 命令
文件搜索 @file-search keyword=report
天气查询 @weather city=北京
Git 状态 @git-helper status
系统信息 @system-info

支持的 IM 平台

飞书 钉钉 企业微信 Telegram Slack Discord

🛠️ 实践案例

文件搜索 Skill

@file-search keyword=pdf
@file-search 简历 path=/Users/jerry/Documents
@file-search keyword=meeting type=txt

Git 助手 Skill

@git-helper status
@git-helper commit message="修复登录bug"
@git-helper push
@git-helper branch name=feature/ai-integration

天气查询 Skill

@weather city=北京
@weather 上海 days=3

⚙️ 执行环境

会话类型 执行环境 权限
个人对话 主机环境 完整权限
群聊 Docker 沙箱 隔离执行

🔧 故障排查

问题 解决方案
Skill 未生效 检查 SKILL.md YAML 格式
脚本执行报错 使用 node -c index.js 检查语法
权限不足 切换到个人对话
找不到命令 使用 openclaw skills list 确认