OpenClaw Skills 实战篇

OpenClaw 小白教程：什么是 Skills，怎么让它帮你控制本地电脑

很多人第一次接触 OpenClaw，会把它理解成“一个能聊天的龙虾助手”。
但真正让 OpenClaw 变强的，不只是会聊天，而是它会“做事”。

而让它“做事”的关键，主要有两部分：

第一部分叫 Skills。
第二部分叫 Tools / 本地执行能力。
OpenClaw 官方把 Skills 定义成一种“教会助手如何使用工具和完成特定任务”的扩展方式。一个 Skill 本质上就是一个文件夹，里面至少有一个 SKILL.md，OpenClaw 会从内置目录、本地目录和工作区目录加载这些技能。

一、先用一句人话理解 Skills

你可以把 OpenClaw 想成一个新来的助理。

它本身已经会一些基础能力，但如果你希望它：

帮你整理某类工作

按你的流程执行命令

识别你项目里的常见任务

调用你写过的脚本

帮你固定格式生成代码

那你就要“教会它”。

这个“教学内容”，就是 Skills。

官方文档里写得很清楚：Skill 是一个目录，至少包含 SKILL.md，里面既可以写说明，也可以写规则，还可以搭配脚本和资源文件一起使用。

二、Skills 不是插件市场那种“点一下就神奇变强”

这一点小白特别容易误会。

Skills 不是“装一个图标”，也不是“加一个按钮”。
更准确地说，它像是：

给 OpenClaw 一份工作说明书

告诉它什么时候该怎么做

告诉它该调用哪些工具

告诉它某类任务要遵守什么流程

所以，Skills 的核心不是“炫”，而是“把常做的事情教给它”。

三、OpenClaw 会从哪里读取 Skills

官方说明，OpenClaw 会从 3 个位置加载 Skills：

安装时自带的 bundled skills

本地共享目录 ~/.openclaw/skills

当前工作区的 <workspace>/skills
如果名字冲突，工作区里的 Skill 优先

这一点非常重要。

你可以这样理解：

~/.openclaw/skills：全局技能，所有项目都能用

项目目录/skills：只给当前项目用

工作区优先：项目里想“覆盖”全局同名技能时很方便

四、怎么查看自己现在有哪些 Skills

如果你是写给小白，这里一定要先教他们“看”，再教“写”。

最常用的几个命令是：

openclaw skills list
openclaw skills info <技能名>
openclaw skills check

官方 CLI 文档里有单独的 skills 命令页，而 skills list / info / check 这些命令就是用来查看技能、看详情、检查依赖的。

对于新手来说，可以先这样解释：

skills list：看现在都有哪些技能

skills info xxx：看某个技能是干什么的

skills check：看技能有没有缺依赖、能不能正常用

五、Skills 到底能帮你做什么

帮你记住项目规则

比如你做 PHP 项目，想让 OpenClaw 一直按你的方式写代码：

控制器怎么写

Service 怎么拆

查询要不要加锁

日志放哪里

返回格式统一成什么样

这些都可以写进 Skill 里。

帮你执行固定流程

比如你每次发版都要做下面几件事：

拉代码

运行测试

重启服务

检查日志

你可以写一个 Skill，告诉 OpenClaw：
以后遇到“发版”“重启”“检查服务”这类请求时，按这个流程做。

帮你调用你以前写过的脚本

比如你之前已经写过：

generate_beijing_video.sh

check_video_status_and_download.sh

download_video.sh

你完全可以把这些脚本放进工作区，然后写一个 Skill 告诉 OpenClaw：

什么时候调用它们

先运行哪一个

成功后看哪个文件

失败时怎么提示

这就是 Skill 最实用的地方。

六、OpenClaw 怎么控制本地电脑

这部分你要写得特别谨慎，因为小白会把“控制本地电脑”理解成无所不能。

更准确的说法应该是：
OpenClaw 可以在本地工作区里读文件、写文件、运行命令，甚至调用本地工具，但具体能做到多少，取决于你启用了哪些工具和环境权限。

官方文档里对 Agent Workspace 的说明很关键：
workspace 是代理默认工作的目录，文件工具和工作区上下文都会围绕这里展开；它是默认工作目录，但不是绝对沙箱，如果没额外开沙箱，绝对路径仍然可能访问主机上的其他位置。

这句话翻成小白能懂的话就是：

OpenClaw 默认“站在你的工作区里做事”

它最熟悉的是当前项目目录

但它不是天然百分百隔离的

所以不要随便让它在你不清楚的目录里乱执行命令

💡

启动网关:

openclaw gateway start

关闭网关:

openclaw gateway stop

打开控制台:

openclaw dashboard

重启网关:

openclaw gateway restart

把openClaw的工具权限切换成完整版

openclaw config set tools.profile full

在执行重启网关

openclaw gateway restart

搞定以后你就可以让openclaw做各种文件读取和修改操作了，比如批量重命名文件、整理桌面、分析磁盘空间占用等等

openclaw有个官方技能市场ClawHub ,复制此官方链接就能看到

https://clawhub.ai

您可以看到好多别人做的skill，可以直接拿来安装使用

定时任务：
openclaw直接支持通过cron创建定时任务，不需要额外安装skill

例如视频模型生成，并且设置定时任务

复制下面的脚本，内容需要自行改
路径:.openclaw/workspace

#!/usr/bin/env bash
set -euo pipefail

API_KEY="sk-f1JNAu5fx"
API_URL="https://api.apiqik.online/v1/videos"

if [ -z "$API_KEY" ]; then
  echo "错误：请先 export API_KEY='sk-你的新key'" >&2
  exit 1
fi

MODEL="wan2.5-i2v-preview"
PROMPT="A fast-paced travel vlog in Beijing, shot in vertical format, energetic and cinematic."
IMG_URL="https://sxbrlk.com/uploads/20260317/bird.png"

METADATA_JSON=$(printf '{ "input": { "img_url": "%s" } }' "$IMG_URL")

SECONDS="10"
SIZE="720P"

curl -X POST "$API_URL" \
  -H "Authorization: $API_KEY" \
  -F "model=$MODEL" \
  -F "prompt=$PROMPT" \
  -F "seconds=$SECONDS" \
  -F "size=$SIZE" \
  -F "metadata=$METADATA_JSON" \
  | tee response.json

echo "OK"%

路径:.openclaw/workspace

set -euo pipefail

API_KEY="sk-f1JNAu5fxNX0"
BASE_URL="https://api.apiqik.online/v1/videos"

if [ -z "$API_KEY" ]; then
  echo "错误：请先 export API_KEY='sk-你的新key'" >&2
  exit 1
fi

if [ ! -f response.json ]; then
  echo "response.json not found in current directory" >&2
  exit 1
fi

ID=$(jq -r '.id' response.json)

if [ -z "$ID" ] || [ "$ID" = "null" ]; then
  echo "Cannot read .id from response.json" >&2
  exit 1
fi

echo "Got task ID from response.json: $ID"

while true; do
  RESP=$(curl -s -H "Authorization: $API_KEY" "${BASE_URL}/${ID}")
  ERROR_CODE=$(echo "$RESP" | jq -r '.code // empty')
  ERROR_MSG=$(echo "$RESP" | jq -r '.message // empty')

  if [ -n "$ERROR_CODE" ]; then
    echo "接口报错：code=$ERROR_CODE, message=$ERROR_MSG" >&2
    echo "完整返回：$RESP" >&2
    exit 1
  fi

  STATUS=$(echo "$RESP" | jq -r '.status // empty')
  PROGRESS=$(echo "$RESP" | jq -r '.progress // 0')

  echo "status=$STATUS, progress=$PROGRESS%"

  if [ "$STATUS" = "completed" ]; then
    VIDEO_URL=$(echo "$RESP" | jq -r '.metadata.url // empty')

    if [ -z "$VIDEO_URL" ]; then
      echo "任务已完成，但没有拿到 metadata.url，完整返回：$RESP" >&2
      exit 1
    fi

    echo "$RESP" > response.json
    echo "Video generation completed."
    echo "VIDEO_URL=$VIDEO_URL"
    echo "OK"
    break
  elif [ "$STATUS" = "failed" ] || [ "$STATUS" = "canceled" ]; then
    echo "Video generation failed or was canceled. Response: $RESP" >&2
    exit 1
  fi

  sleep 10
done%

路径:.openclaw/workspace/

#!/usr/bin/env bash
set -euo pipefail

API_KEY="sk-f1JNAu5fxN"
BASE_URL="https://api.apiqik.online/v1/videos"
OUTPUT_FILE="video.mp4"

if [ -z "$API_KEY" ]; then
  echo "错误：请先 export API_KEY='sk-你的新key'" >&2
  exit 1
fi

if [ ! -f response.json ]; then
  echo "错误：当前目录没有 response.json" >&2
  exit 1
fi

VIDEO_ID=$(jq -r '.id // empty' response.json)

if [ -z "$VIDEO_ID" ] || [ "$VIDEO_ID" = "null" ]; then
  echo "错误：无法从 response.json 读取 .id" >&2
  exit 1
fi

API_URL="${BASE_URL}/${VIDEO_ID}/content"

echo "读取到 VIDEO_ID: $VIDEO_ID"
echo "开始下载到: $OUTPUT_FILE"

curl -fL \
  -H "Authorization: $API_KEY" \
  "$API_URL" \
  -o "$OUTPUT_FILE"

echo "Video saved to: $OUTPUT_FILE"
echo "OK"%

直接让ai帮忙自动执行代码就可以完成所有的工作了

七、控制本地电脑最常见的方式：执行命令

官方有一个 Exec tool，作用就是在工作区里运行 shell 命令。它支持前台执行，也支持后台执行；如果 process 没开，就按同步方式执行。

OpenClaw 控制本地电脑，最常见的方式就是代你在终端里执行命令。

比如这些事，本质上都属于“控制本地”：

新建文件夹

创建文件

执行脚本

跑测试

查日志

重启本地服务

调用 git 命令

八、但“控制本地”不等于“随便乱来”

OpenClaw 的安全文档提到，本地 shell、远程节点控制、自动化执行，本质上都属于高信任能力，必须当成真实的操作权限来看待。尤其本地 shell 这种，本身就等于给了命令执行能力。

所以你可以用一句最容易懂的话提醒用户：

让 OpenClaw 控制本地电脑，不是“它更聪明了”，而是“你把部分操作权限交给它了”。

九、如果我想让 OpenClaw 帮我写以前那种代码，怎么做

OpenClaw 写代码，不只是靠模型“临场发挥”。
更稳的方法是，把你自己的代码习惯、项目规则、常用脚本、目录结构，写成 Skill。

比如你以前常写：

FastAdmin 控制器

PHP Service 层

MySQL 事务加锁代码

支付回调逻辑

轮询任务脚本

Shell 下载脚本

你就可以把这些经验做成一个 Skill。

Skill 里告诉 OpenClaw：

当前项目是 PHP/FastAdmin 风格

数据库操作优先考虑事务

订单、课程、班级相关代码要按既有表结构来写

新增脚本默认输出清晰日志

Shell 脚本结束输出 OK

response.json 这类中间文件优先保存在工作区根目录

这样以后你让它“帮我写一个类似之前的视频任务轮询脚本”，它就更容易按你的习惯来。

十、一个 Skill 最基础长什么样

官方的 Creating Skills 文档给出的最基础做法是：

先创建一个目录，再创建 SKILL.md。技能通常放在工作区的 skills/ 目录里，例如：

mkdir -p ~/.openclaw/workspace/skills/hello-world

然后在目录里写 SKILL.md。


---
name: php_project_rules
description: 用于 PHP 项目的代码生成和脚本执行规则
---

# PHP 项目规则

当用户要求写 PHP 接口、Shell 脚本或排查业务逻辑时：

1. 先尽量沿用现有项目目录结构
2. 涉及订单、课程、班级时，优先按现有表结构命名
3. Shell 脚本执行成功时，最后输出 OK
4. 如果脚本依赖 response.json，默认在当前工作区读取
5. 如果需要执行本地命令，优先在工作区内执行，不要随意写绝对路径

这类 Skill 的价值，不是复杂，而是“把你的习惯固定下来”。

十一、想让 OpenClaw 调用自己写过的脚本，最简单的做法是什么

最适合小白的做法，不是上来就讲插件系统，而是直接教他们：

第一步

把脚本放进当前工作区，比如：

workspace/
  skills/
  scripts/
    generate_beijing_video.sh
    check_video_status_and_download.sh
    download_video.sh

第二步

例如：

generate_beijing_video.sh：创建视频任务

check_video_status_and_download.sh：轮询状态并更新 response.json

download_video.sh：从 response.json 下载最终视频

第三步

Tool：真正干活的工具

Skill：告诉 OpenClaw 什么时候、如何用这些工具

也就是说：

Tool 像手脚

Skill 像操作说明书

十二、小白最容易踩的几个坑

以为 Skill 是“装了就自动会”

不是。
Skill 更像规则和说明书，写得越清楚，效果越稳定。
2. 以为 OpenClaw 控制本地电脑是“无限权限”

不是。
它依赖工作区、工具开关、系统权限和你的配置。
3. 把所有规则都写进聊天里

这样很快就乱了。
更好的方式是把常用规则沉淀成 Skill。
4. 不区分全局 Skill 和项目 Skill

官方明确说了，Skills 有全局目录和工作区目录，而且工作区优先。

十三、结尾

OpenClaw 真正厉害的地方，不只是能聊天，而是你可以一步步把自己的工作方法教给它。

当你只是跟它聊天时，它只是一个助手。
当你开始写 Skills、让它理解你的项目规则、让它调用你写过的脚本、帮你操作本地工作区时，它才真正开始变成“你的助手”。

OpenClaw Skills 实战篇

OpenClaw 小白教程：什么是 Skills，怎么让它帮你控制本地电脑#

一、先用一句人话理解 Skills#

二、Skills 不是插件市场那种“点一下就神奇变强”#

三、OpenClaw 会从哪里读取 Skills#

四、怎么查看自己现在有哪些 Skills#

五、Skills 到底能帮你做什么#

六、OpenClaw 怎么控制本地电脑#

七、控制本地电脑最常见的方式：执行命令#

八、但“控制本地”不等于“随便乱来”#

九、如果我想让 OpenClaw 帮我写以前那种代码，怎么做#

十、一个 Skill 最基础长什么样#

十一、想让 OpenClaw 调用自己写过的脚本，最简单的做法是什么#

十二、小白最容易踩的几个坑#

十三、结尾#