1. 客户端应用教程
apiqik
  • 必读
    • 欢迎来到 APIQIK - 您的 AI 模型聚合平台
    • API代理商招募&使用教程(无需技术)
    • 音频模型
  • 客户端应用教程
    • Cherry Studio使用指南
    • Chatbox 使用指南
    • Cherry Studio sora/veo视频生成教程
    • 令牌分组(Token Group)使用教程
    • Vscode claude code
    • vscode配置教程(Cline)
    • 沉浸式翻译配置教程
    • 💬 SillyTavern 配置
    • Codex 配置使用教程
    • Gemini CLI 新手 · 自定义配置完整教程
    • opencode配置使用教程
    • ClawDBot 新手配置文档
    • Claude Code 自定义 API(中转站)配置教程
    • Openclaw龙虾凭啥火,以及必知三大风险!
    • openClaw的部署教程(部署安装教程)
    • openClaw 配置飞书教程(小白版)
    • OpenClaw Skills 实战篇
  • 聊天模型
    • Chat-Completions API 使用指南
    • chat模型接口
      POST
    • 数据模型
      • 示例数据模型
        • Pet
        • Category
        • Tag
  • openai
    • 图像(Images)
      • 创建图像
      • 创建图片编辑
    • 音频(Audio)
      • 创建语音
      • 创建音频转文本
    • 自动补全(Completions)
      • 创建完成
    • 模型(Models)
      • 列出模型
      • 检索模型
  • gemini
    • 聊天(chat)
      • gemini格式聊天接口
      • 分析视频
      • 流式响应
      • 多轮对话
    • 绘画模型
      • gemini-3-pro-image-preview(文生图)
      • gemini-3-pro-image-preview(图生图)
  • 音乐模型
    • Suno 音乐生成 API
  • 绘画模型
    • Chat 格式生图 (gpt-4o)
    • 专用生图接口 (DALL-E 格式)
    • gemini-2.5-flash-image接口文档(chat)
    • gemini-2.5-flash-image图像生成接口(支持比例)
    • 即梦(seedream)
      • 创建图片
      • 编辑图片
    • nano banana
      • gemini-2.5-flash-image图像生成接口(gemini格式)
      • gemini-3-pro-image-preview(banana pro)图像生成接口(gemini格式)
      • gemini-3.1-flash-image-preview(nano banana 2) (文生图)模型接口
      • gemini-3.1-flash-image-preview(nano banana 2) (图生图)模型接口
      • gemini-3.1-flash-image-preview(nano banana 2) (多图生图)模型接口
    • Qwen千问
      • 生成图片(qwen-image)
      • 编辑图像(qwen-image-edit)
    • gpt-image-1.5
      • chat 格式
        • 生成图片 (传图)
        • 生成图片
      • image/generations 格式(dalle 格式)
        • 创建图像
        • 创建图片编辑
    • 豆包
      • doubao-seedream-5-0-260128 模型(文生图)
      • doubao-seedream-5-0-260128 模型(图生图)
      • doubao-seedream-5-0-260128 模型(多图生图)
    • gpt imag 图像编辑接口
  • 视频模型
    • veo
      • Veo3 视频生成 API
      • 查询视频详情
      • veo3(veo3.1)视频生成(异步)
    • sora-2
      • sora2 生成视频(chat格式)
      • sora2 异步文档
      • sora-2官方格式(异步,失败不扣分)
        • sora-2创建视频
        • 检索视频
        • 编辑视频接口(暂时不能使用)
        • 获取视频内容
        • 使用故事板创建视频
    • grok
      • 获取视频内容
      • grok 视频生成
    • wan
      • wan视频创建
      • 检索视频
      • 获取视频内容
  • 音频模型
    • minimax
      • 上传复刻音频(purpose=voice_clone)
      • 上传示例音频(purpose=prompt_audio)
      • 音色快速复刻
    • 原生Gemini格式
    • 获取令牌使用情况
  • 代理接口调用
    • 创建令牌(需要登录)
    • 用户登录(用于获取其他接口需要的认证信息)
    • 获取令牌余额信息
    • 获取使用量统计
    • 获取令牌调用日志
  • 嵌入(Embeddings)
    • text-embedding-3-large模型
  1. 客户端应用教程

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 到底能帮你做什么#

1.
帮你记住项目规则
比如你做 PHP 项目,想让 OpenClaw 一直按你的方式写代码:
控制器怎么写
Service 怎么拆
查询要不要加锁
日志放哪里
返回格式统一成什么样
这些都可以写进 Skill 里。
2.
帮你执行固定流程
比如你每次发版都要做下面几件事:
拉代码
运行测试
重启服务
检查日志
你可以写一个 Skill,告诉 OpenClaw:
以后遇到“发版”“重启”“检查服务”这类请求时,按这个流程做。
3.
帮你调用你以前写过的脚本
比如你之前已经写过:
generate_beijing_video.sh
check_video_status_and_download.sh
download_video.sh
你完全可以把这些脚本放进工作区,然后写一个 Skill 告诉 OpenClaw:
什么时候调用它们
先运行哪一个
成功后看哪个文件
失败时怎么提示
这就是 Skill 最实用的地方。

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

这部分你要写得特别谨慎,因为小白会把“控制本地电脑”理解成无所不能。
更准确的说法应该是:
OpenClaw 可以在本地工作区里读文件、写文件、运行命令,甚至调用本地工具,但具体能做到多少,取决于你启用了哪些工具和环境权限。
官方文档里对 Agent Workspace 的说明很关键:
workspace 是代理默认工作的目录,文件工具和工作区上下文都会围绕这里展开;它是默认工作目录,但不是绝对沙箱,如果没额外开沙箱,绝对路径仍然可能访问主机上的其他位置。
这句话翻成小白能懂的话就是:
OpenClaw 默认“站在你的工作区里做事”
它最熟悉的是当前项目目录
但它不是天然百分百隔离的
所以不要随便让它在你不清楚的目录里乱执行命令
💡
image.png
启动网关:
openclaw gateway start
关闭网关:
openclaw gateway stop
打开控制台:
openclaw dashboard
重启网关:
openclaw gateway restart
把openClaw的工具权限切换成完整版
openclaw config set tools.profile full
在执行重启网关
openclaw gateway restart
搞定以后你就可以让openclaw做各种文件读取和修改操作了,比如批量重命名文件、整理桌面、分析磁盘空间占用等等
image.png
openclaw有个官方技能市场ClawHub ,复制此官方链接就能看到
https://clawhub.ai
image.png
您可以看到好多别人做的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帮忙自动执行代码就可以完成所有的工作了
image.png

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

官方有一个 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 像操作说明书

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

1.
以为 Skill 是“装了就自动会”
不是。
Skill 更像规则和说明书,写得越清楚,效果越稳定。
2. 以为 OpenClaw 控制本地电脑是“无限权限”
不是。
它依赖工作区、工具开关、系统权限和你的配置。
3. 把所有规则都写进聊天里
这样很快就乱了。
更好的方式是把常用规则沉淀成 Skill。
4. 不区分全局 Skill 和项目 Skill
官方明确说了,Skills 有全局目录和工作区目录,而且工作区优先。

十三、结尾#

OpenClaw 真正厉害的地方,不只是能聊天,而是你可以一步步把自己的工作方法教给它。
当你只是跟它聊天时,它只是一个助手。
当你开始写 Skills、让它理解你的项目规则、让它调用你写过的脚本、帮你操作本地工作区时,它才真正开始变成“你的助手”。
修改于 2026-03-26 06:22:30
上一页
openClaw 配置飞书教程(小白版)
下一页
Chat-Completions API 使用指南
Built with