什么是 Skill Workshop?

Skill Workshop 是 OpenClaw 在 2026 年推出的交互式技能开发环境。它把传统的"写 SKILL.md → 放到目录 → 重启测试"的流程,变成了一个可视化的、实时反馈的开发体验。

简单来说:Skill Workshop 之于 OpenClaw 技能开发,就像 VS Code 之于写代码——它不只是编辑器,而是一个完整的开发工作台。

🎨 可视化编辑

Markdown + YAML 混合编辑器,支持语法高亮和自动补全

⚡ 实时预览

修改 SKILL.md 后立即在侧边栏看到 Agent 的行为变化

🧪 内置测试

模拟对话测试,验证技能的触发条件和响应逻辑

📦 一键发布

开发完成后直接推送到 ClawHub,无需手动打包

为什么需要 Skill Workshop?

在 Workshop 出现之前,开发一个 OpenClaw 技能的流程是这样的:

  1. 用文本编辑器写 SKILL.md
  2. 把文件放到 ~/.openclaw/skills/ 目录
  3. 重启 Gateway 或等待热重载
  4. 在聊天中测试
  5. 发现问题,回到步骤 1

这个循环最大的痛点是反馈慢——每次修改都要经历完整的重启-测试周期。Skill Workshop 把这个周期从分钟级压缩到了秒级。

快速上手:5 分钟创建你的第一个技能

第一步:启动 Workshop

# 在终端中启动 Skill Workshop
openclaw workshop

# 或者通过 Gateway 访问 Web 版
openclaw workshop --port 3210 --web
💡 提示: Web 版 Workshop 支持多人协作,适合团队开发。访问 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 动手实践。