什么是 Skill Workshop?
Skill Workshop 是 OpenClaw 在 2026 年推出的交互式技能开发环境。它把传统的"写 SKILL.md → 放到目录 → 重启测试"的流程,变成了一个可视化的、实时反馈的开发体验。
简单来说:Skill Workshop 之于 OpenClaw 技能开发,就像 VS Code 之于写代码——它不只是编辑器,而是一个完整的开发工作台。
🎨 可视化编辑
Markdown + YAML 混合编辑器,支持语法高亮和自动补全
⚡ 实时预览
修改 SKILL.md 后立即在侧边栏看到 Agent 的行为变化
🧪 内置测试
模拟对话测试,验证技能的触发条件和响应逻辑
📦 一键发布
开发完成后直接推送到 ClawHub,无需手动打包
为什么需要 Skill Workshop?
在 Workshop 出现之前,开发一个 OpenClaw 技能的流程是这样的:
- 用文本编辑器写 SKILL.md
- 把文件放到
~/.openclaw/skills/目录 - 重启 Gateway 或等待热重载
- 在聊天中测试
- 发现问题,回到步骤 1
这个循环最大的痛点是反馈慢——每次修改都要经历完整的重启-测试周期。Skill Workshop 把这个周期从分钟级压缩到了秒级。
快速上手:5 分钟创建你的第一个技能
第一步:启动 Workshop
# 在终端中启动 Skill Workshop
openclaw workshop
# 或者通过 Gateway 访问 Web 版
openclaw workshop --port 3210 --web
http://localhost:3210 即可。
第二步:创建新技能
在 Workshop 界面点击 "New Skill",填写基本信息:
# 技能元信息
name: daily-quote
description: 每天分享一句名人名言或AI趣语
version: 1.0.0
author: your-name
tags: [daily, motivational, fun]
第三步:编写触发逻辑
在 SKILL.md 中定义技能的触发条件和行为:
# Daily Quote Skill
## 触发条件
当用户说"来句名言"、"今日语录"、"quote"时触发。
## 执行逻辑
1. 从预设的名言库中随机选择一条
2. 添加日期和来源信息
3. 以卡片格式返回给用户
## 响应模板
📅 {date}
💬 "{quote}"
—— {author}
---
*由 Daily Quote Skill 提供*
第四步:实时测试
在 Workshop 右侧的测试面板中,直接输入测试消息:
测试输入: "来句名言"
预期输出:
📅 2026年6月10日
💬 "世界上最远的距离,不是生与死,而是我站在你面前,你却在用另一个AI。"
—— 妙趣AI
---
*由 Daily Quote Skill 提供*
第五步:发布到 ClawHub
# 在 Workshop 中点击 "Publish to ClawHub"
# 或使用命令行
openclaw skill publish daily-quote --to clawhub
高级功能详解
条件分支与变量
Workshop 支持在 SKILL.md 中使用条件逻辑:
## 条件分支
如果 {user_timezone} 包含 "Asia":
使用中文名言库
否则:
使用英文名言库
如果 {time.hour} < 12:
添加"早上好"前缀
否则如果 {time.hour} < 18:
添加"下午好"前缀
否则:
添加"晚上好"前缀
工具调用集成
技能可以调用 OpenClaw 的内置工具和外部 MCP 工具:
## 工具调用
步骤 1: 使用 web_search 搜索 "今日历史上的今天"
步骤 2: 使用 web_fetch 获取搜索结果详情
步骤 3: 将历史事件整合到每日语录中
多语言支持
## 语言适配
检测 {user_language}:
zh: 使用中文模板
en: Use English template
ja: 日本語テンプレートを使用
Skill Workshop vs 传统开发方式
| 对比维度 | 传统方式 | Skill Workshop |
|---|---|---|
| 开发周期 | 30分钟/迭代 | 30秒/迭代 |
| 测试方式 | 手动聊天测试 | 内置模拟测试 |
| 调试体验 | 查看日志文件 | 可视化调试面板 |
| 发布流程 | 手动打包上传 | 一键发布 |
| 协作支持 | Git 协作 | 实时多人协作 |
最佳实践
- 单一职责:每个技能只做一件事,做好一件事
- 明确触发:触发条件要清晰,避免误触发
- 优雅降级:当外部服务不可用时,提供友好的错误提示
- 可组合性:设计技能时考虑与其他技能的协作
命名规范
# 推荐的技能命名格式
{动词}-{名词}-{场景}
# 示例
daily-quote-generator
web-content-summarizer
github-pr-reviewer
feishu-meeting-note-taker
版本管理
# 使用语义化版本
version: 1.0.0 # 主版本.次版本.修订版本
# 主版本:不兼容的变更
# 次版本:新增功能,向下兼容
# 修订版本:Bug 修复
常见问题
Q: Workshop 支持离线使用吗?
支持。Workshop 的核心编辑和测试功能完全离线可用。只有发布到 ClawHub 时需要网络连接。
Q: 可以导入已有的 SKILL.md 吗?
可以。在 Workshop 中选择 "Import Existing Skill",指向你的 SKILL.md 文件即可。Workshop 会自动解析并加载。
Q: Workshop 和 Skills Development 有什么区别?
Skills Development 是文档化的开发指南,而 Workshop 是一个实际的开发工具。两者互补——先看指南了解概念,再用 Workshop 动手实践。