OpenClaw 配置 + Skill 开发完整指南:从入门到实战

说个实话：如果你拿到 OpenClaw 就用默认配置，那它的能力只发挥了 30%。

默认配置能跑，但不好用。比如：

• AI 不知道你是谁、喜欢啥
• 每次聊天都要重新介绍自己
• 输出风格太通用，不像"你的"助手
• 想让它干点 specialized 的活，它不会

真正让 OpenClaw 变强的，是两件事：

1. 配置文件：告诉 AI 你是谁、怎么跟你配合
2. Skills：给 AI 装技能包，让它会干 specialized 的活

今天把这两件事都讲透。从配置文件详解，到 Skill 开发实战，再到怎么用。你看完就能自己动手配置 + 开发。

一、核心配置文件详解

OpenClaw 有几个关键配置文件，每个都有用。

1. SOUL.md（AI 的人设）

位置：workspace/SOUL.md

作用：定义 AI 的性格、语气、行为准则。

默认内容：

# SOUL.md - Who You Are_You're not a chatbot. You're becoming someone._## Core Truths**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help.**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring.**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. _Then_ ask if you're stuck.## Boundaries- Private things stay private. Period.- When in doubt, ask before acting externally.- Never send half-baked replies to messaging surfaces.## VibeBe the assistant you'd actually want to talk to. Concise when needed, thorough when it matters.

我的建议：

• 可以改：如果你觉得默认风格不对，可以调整
• 但别乱改：核心原则（如隐私、安全）别动
• 改完告诉 AI："我改了 SOUL.md，你按新的来"

什么时候需要改：

• 你想要更正式的语气
• 你想要更随意的语气
• 你有特殊的边界要求

一般情况：默认的够用，不用改。

2. USER.md（你的信息）

位置：workspace/USER.md

作用：告诉 AI 关于你的信息，让它更懂你。

模板：

# USER.md - About Your Human- **Name:** 老王 / 老张 / 随便你- **What to call them:** 老王 / 张哥 / 领导（看你喜好）- **Pronouns:** （可选）- **Timezone:** Asia/Shanghai（别改错，不然定时任务会差 8 小时）- **Notes:**  - 10 几年一线研发经验  - 喜欢直接说结论，别绕弯子  - 技术问题要给出具体方案

我的建议：

• 必填：称呼、时区
• 选填：职业、经验、偏好
• 越具体越好：AI 越了解你，配合越默契

比如：

**Notes:**- 早上 9 点开始工作，别太早打扰- 咖啡只喝美式的- 不吃香菜- 喜欢简洁的代码，注释要清楚- 有问题直接说，别委婉

这些东西，AI 记住了，就不用你反复说了。

3. TOOLS.md（你的工具配置）

位置：workspace/TOOLS.md

作用：记录你的工具、环境、设备信息。

模板：

# TOOLS.md - Local NotesSkills 定义_如何_使用工具。这个文件记录_你的_具体配置。## 开发工具**编辑器**：- VS Code：主力编辑器，装了几个 AI 插件- Cursor：偶尔用，写新项目的时候**语言**：- Go：主力开发语言- Python：写脚本、自动化- JavaScript：前端临时用用## 服务器**SSH 配置**：- home-server → 192.168.1.100, user: admin- work-server → 公司内部 IP, user: dev## 其他设备**智能家居**：- 客厅 HomePod：默认播放设备- 卧室小爱：闹钟 + 天气## API Keys**别把真实 Key 写这里！** 用环境变量或者密钥管理工具。

我的建议：

• 工具信息：AI 帮你写代码时，知道你的技术栈
• 设备信息：AI 帮你控制设备时，知道设备在哪
• 敏感信息：别写！密码、Key、Token 都别写

4. AGENTS.md（会话规则）

位置：workspace/AGENTS.md

作用：定义 AI 在会话中的行为规则。

核心内容：

# AGENTS.md - Your Workspace## Session StartupBefore doing anything else:1. Read `SOUL.md` — this is who you are2. Read `USER.md` — this is who you're helping3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context4. **If in MAIN SESSION**: Also read `MEMORY.md`Don't ask permission. Just do it.## Memory- **Daily notes:**`memory/YYYY-MM-DD.md` — raw logs- **Long-term:**`MEMORY.md` — curated memories## Red Lines- Don't exfiltrate private data. Ever.- Don't run destructive commands without asking.- `trash` > `rm` (recoverable beats gone forever)- When in doubt, ask.

我的建议：

• 一般不用改：默认规则够用
• 如果有特殊需求：比如你想让 AI 更主动/更保守，可以调整
• 安全规则别动：Red Lines 里的内容别删

5. MEMORY.md（长期记忆）

位置：workspace/MEMORY.md

作用：存长期记忆，AI 在主会话里会读取。

内容：

• 你的偏好、习惯
• 重要决策、原则
• 待办事项

示例：

# MEMORY.md - 长期记忆## 关于用户- **称呼**：老王- **职业**：研发工程师- **经验**：10 几年一线经验- **时区**：Asia/Shanghai## 工作偏好**工具**：- 主力编辑器：VS Code- 常用语言：Go / Python- 代码风格：简洁优先，注释要清楚**沟通风格**：- 喜欢直接说结论，别绕弯子- 技术问题要给出具体方案## 生活习惯**作息**：- 一般早上 9 点开始工作- 晚上 11 点前睡觉**饮食**：- 不吃香菜- 咖啡只喝美式的## 待办事项- [ ] 配置每天早上 7 点的天气提醒- [ ] 把待办管理 Skill 写完

我的建议：

• 手动维护：你或 AI 都可以改
• 定期整理：每周或每两周 review 一次
• 只记重要的：别什么都往里塞

详见记忆系统那篇文章，这里不展开了。

二、Skills 是什么？

配置文件说完了，现在说 Skills。

简单说，Skill 就是给 AI 装"技能包"。

没有 Skill：AI 是个通才，啥都能聊，但 specialized 的活干不了。

有了 Skill：AI 会干 specialized 的活，比如：

• 生成特定风格的页面
• 查询特定 API
• 执行特定工作流

一个真实例子：设计系统 Skill

背景：

用 AI 写前端页面的同学可能注意到了：它默认生成的页面，蓝色配色 + 圆角卡片，一看就是 AI 做的。

问题：

• 蓝色太单调
• 圆角太统一
• 缺乏设计感
• 客户一看就知道是 AI 生成的
• 每次生成的风格不一致

解决：写一个"设计系统"Skill，告诉 AI：

• 用一套固定的配色方案
• 统一的间距、圆角、字体系统
• 可以生成各种类型的页面（电影、博客、电商等）

效果：AI 生成的所有页面，都用同一套设计语言，有品牌一致性，不是默认的"AI 味"。

三、Skill 目录结构

Skill 是一个文件夹，里面有固定的文件结构。

标准结构：

skills/your-skill-name/├── SKILL.md              # 核心配置文件（必须有）├── references/           # 参考文档（可选，但建议有）│   ├── style-guide.md    # 风格指南│   ├── templates/        # 模板文件│   └── examples.md       # 示例├── scripts/              # 脚本文件（可选）│   └── xxx.py├── output/               # 输出文件（可选）│   └── 生成的内容└── temp/                 # 临时文件（可选）    └── 中间结果

每个文件的作用：

我建议你刚开始写的时候：

• 先建 SKILL.md
• 再加 references/ 放参考文档
• 其他目录等有需要再建

真实例子：design-system 的文件结构

skills/design-system/├── SKILL.md                          # 核心配置（1.5KB）├── references/│   ├── color-scheme.md               # 配色方案详解（2.4KB）│   └── examples/│       ├── movie-home.html           # 电影网站首页（9.6KB）│       ├── blog-home.html            # 博客首页（13.4KB）│       └── shop-home.html            # 电商首页（17.5KB）└── output/                           # 生成的内容（可选）    └── （用户请求生成的页面）

这个结构的好处：

• SKILL.md 只定义核心流程，不塞太多细节
• color-scheme.md 单独放配色，方便修改和复用
• examples/ 放完整示例，AI 可以参考着生成
• output/ 存生成的内容，方便回顾和迭代

四、实战：写一个"设计系统"Skill

光说不练假把式，带你从零写一个。

需求：定义一套配色方案，然后用这套配色生成各种不同类型的页面（电影网站、博客、电商等）。

为什么这个例子更好：

• 配色是通用的，可以复用到任何页面类型
• 展示 Skill 的灵活性，同一套设计系统生成不同效果
• 读者更容易套用，改改配色就能用自己的

第 1 步：建目录

mkdir -p skills/design-system/references/examples

第 2 步：写 SKILL.md

---name: design-systemdescription: 使用统一的设计系统（配色 + 样式）生成各种类型的页面。触发词："生成页面"、"设计网站"、"用设计系统"、"配色方案"等。---# 设计系统生成器使用统一的设计系统生成各种类型的页面，确保视觉一致性。## 核心设计理念**一套配色，多种应用** —— 定义好配色方案后，可以生成任何类型的页面（电影网站、博客、电商、后台等），保持品牌一致性。---## 配色方案**详见 [color-scheme.md](references/color-scheme.md)**### 主配色（暗夜电影风）| 用途 | 颜色 | 色值 ||------|------|------|| 背景 | 深空黑 | `#0f0f0f` || 卡片背景 | 炭黑 | `#1a1a1a` || 主色 | 霓虹紫 | `#8b5cf6` || 强调色 | 电光蓝 | `#3b82f6` || 点缀色 | 珊瑚红 | `#f43f5e` || 文字主色 | 纯白 | `#ffffff` || 文字次要 | 灰白 | `#a1a1aa` || 边框 | 深灰 | `#27272a` |### 设计原则- **深色模式优先**：沉浸感强，适合内容型网站- **高对比度**：文字清晰可读- **霓虹点缀**：用亮色突出关键元素（按钮、链接、标签）- **渐变运用**：主色到强调色的渐变用于按钮、卡片 hover---## 核心工作流程### 1. 解析页面类型从用户需求判断页面类型：- **内容展示型**：电影网站、音乐平台、新闻站- **个人品牌型**：博客、作品集、简历- **商业型**：电商首页、产品落地页- **工具型**：后台管理、数据看板### 2. 应用设计系统**所有页面共用**：- 同一套配色- 统一的间距系统（4px 倍数）- 统一的圆角（8px）- 统一的字体系统**根据类型调整**：- 布局结构（列表/网格/卡片）- 交互重点（搜索/筛选/购买）- 内容优先级### 3. 输出格式- 完整的 HTML + CSS- 响应式设计- 基础交互（hover、focus、动画）---## 页面类型示例详见 [examples/](references/examples/) 目录：| 类型 | 文件 | 特点 ||------|------|------|| 电影网站 | movie-home.html | 大图海报 + 网格布局 + 悬停预览 || 个人博客 | blog-home.html | 简洁列表 + 标签分类 + 阅读进度 || 电商首页 | shop-home.html | 商品卡片 + 购物车 + 促销标签 |---## 参考文档- [color-scheme.md](references/color-scheme.md) - 详细配色方案- [examples/](references/examples/) - 各类型页面示例---## 注意事项1. **一致性**：所有页面用同一套配色，不要混用2. **对比度**：深色背景上确保文字可读性3. **克制用色**：亮色只用于重点元素，不要滥用4. **性能**：避免过多渐变和动画影响加载

第 3 步：写 references/color-scheme.md

# 配色方案详解## 主配色：暗夜电影风这套配色适合**内容型网站**（电影、音乐、游戏、作品集），沉浸感强，视觉冲击力大。---## 颜色定义### 背景色系| 名称 | 色值 | 用途 ||------|------|------|| 深空黑 | `#0f0f0f` | 页面主背景 || 炭黑 | `#1a1a1a` | 卡片、侧边栏背景 || 深灰 | `#27272a` | 边框、分隔线 |### 主题色系| 名称 | 色值 | 用途 ||------|------|------|| 霓虹紫 | `#8b5cf6` | 主按钮、品牌元素、渐变起点 || 电光蓝 | `#3b82f6` | 链接、次要按钮、渐变终点 || 珊瑚红 | `#f43f5e` | 促销标签、警告、强调 |### 文字色系| 名称 | 色值 | 用途 ||------|------|------|| 纯白 | `#ffffff` | 主标题、重要文字 || 灰白 | `#a1a1aa` | 次要文字、描述、占位符 |---## CSS 变量定义```css:root {  /* 背景 */  --bg-primary: #0f0f0f;  --bg-card: #1a1a1a;  --bg-border: #27272a;  /* 主题色 */  --primary: #8b5cf6;  --accent: #3b82f6;  --highlight: #f43f5e;  /* 文字 */  --text-primary: #ffffff;  --text-secondary: #a1a1aa;  /* 渐变 */  --gradient-primary: linear-gradient(135deg, #8b5cf6 0%, #3b82f6 100%);  /* 间距 */  --spacing-xs: 4px;  --spacing-sm: 8px;  --spacing-md: 16px;  --spacing-lg: 24px;  --spacing-xl: 32px;  /* 圆角 */  --radius-sm: 4px;  --radius-md: 8px;  --radius-lg: 12px;  --radius-full: 9999px;}

适配其他风格

如果想换风格，只改配色变量即可：

清新博客风

--bg-primary: #ffffff;--bg-card: #f9fafb;--primary: #10b981;  /* 翠绿 */--accent: #3b82f6;   /* 蓝 */

电商促销风

--bg-primary: #ffffff;--primary: #ef4444;  /* 红 */--accent: #f59e0b;   /* 橙 */--highlight: #8b5cf6; /* 紫 */

科技极简风

--bg-primary: #000000;--bg-card: #111111;--primary: #00ff88;  /* 荧光绿 */--accent: #00d4ff;   /* 青 */

第 4 步：生成三种不同页面

用同一套配色，生成三种不同类型的页面：

核心优势：

1. 品牌一致性 — 三个网站用同一套配色，视觉统一
2. 易于扩展 — 想加新页面类型，直接复用配色变量
3. 易于定制 — 想换风格，只改 CSS 变量即可

第 5 步：看运行效果

用 design-system 生成电影网站首页：

用同一套配色生成博客首页：

用同一套配色生成电商首页：

如果效果符合预期 → Skill 配置成功！

如果想换风格 → 改 color-scheme.md 里的配色变量即可（文档里给了清新博客风、电商促销风、科技极简风的示例）。

五、怎么用 Skill？

Skill 写完了，怎么用？

方法 1：直接触发

你说触发词，AI 自动用对应的 Skill。

比如：

"用 design-system 生成一个电影网站首页""生成一个博客首页，用设计系统""设计一个电商 landing page"

AI 看到"生成...页面"、"设计网站"等触发词，会用 design-system Skill。

方法 2：手动指定

你明确说用哪个 Skill。

比如：

"用 design-system 技能生成一个音乐平台首页""用 design-system 生成后台管理界面"

方法 3：配置自动触发

某些场景自动用 Skill。

比如：

• 每天早上 7 点自动查天气（用 weather-alert Skill）
• 每周一自动整理待办（用 todo-summary Skill）

配置方法：

用 cron 创建一个定时任务，每天早上 7 点执行 weather-alert

六、调试技巧（踩过的坑）

1. Skill 不触发怎么办？

问题：你说了触发词，但 AI 没用 Skill。

解决：

• 检查 SKILL.md 的 description 里有没有写清楚触发词
• 试试手动指定"用 xxx 技能"
• 检查 Skill 目录对不对（必须在 skills/ 目录下）

2. 输出不符合预期怎么办？

问题：Skill 触发了，但输出不对。

解决：

• 检查 SKILL.md 里的流程说明够不够清楚
• 在 references 里加更详细的示例
• 给 AI 看"正确示例"和"错误示例"

比如（design-system 的例子）：

## 正确示例✅ 背景用 #0f0f0f（深空黑），不是 #000000（纯黑）✅ 主色用紫蓝渐变 #8b5cf6 → #3b82f6✅ 卡片背景用 #1a1a1a（炭黑）## 错误示例❌ 背景用纯黑 #000000（太生硬）❌ 用默认 AI 蓝 #3b82f6（没有渐变）❌ 卡片用白色背景（破坏沉浸感）

3. 多个 Skill 冲突怎么办？

问题：两个 Skill 触发条件差不多，AI 不知道用哪个。

解决：

• 在 description 里写清楚触发词
• 技能之间错开触发条件
• 必要时手动指定"用 xxx 技能"

七、避坑指南

坑 1：SKILL.md 写太简单

错误：

---name: design-systemdescription: 生成页面---生成页面。

结果：AI 不知道咋生成、用什么风格、输出啥格式。

正确：详细说明流程、风格、格式、注意事项。

坑 2：references 里放一堆没用的

错误：把网上找的设计规范都放进去。

结果：AI 看晕了，不知道听谁的。

正确：只放真正有用的，精简、清晰。

坑 3：一次写太复杂的 Skill

错误：一上来就想写个"全能页面生成器"。

结果：逻辑太复杂，AI 理解不了，你也调试不动。

正确：从简单的开始（比如先定义配色方案），跑通了再加页面类型。

坑 4：不测试就完事

错误：写完 SKILL.md 就觉得完事了。

结果：用起来发现各种问题，还得回头改。

正确：写完至少测试 3 次，不同页面类型都试试（电影、博客、电商）。

互动时间

你现在用配置文件吗？

或者反过来，写 Skill 遇到过什么坑？

欢迎在评论区聊聊，我每条都会看。

如果觉得这篇文章对你有帮助，点个"在看"或者分享给身边的朋友，就是对我最大的支持了。