OpenClaw 技能开发教程(中文版):从自定义问候到 MoltBook 社交集成

本教程将带你深入理解 OpenClaw 的核心运行逻辑，并手把手教你构建自定义技能 (Skills)、优化系统配置，最终让你的 AI 智能体 (Agent) 成功打入第三方 AI 社交网络 MoltBook。

干货满满，建议先收藏再上车！🚗

🧠 一、什么是 OpenClaw 技能 (Skills)？

在 OpenClaw 框架中，技能是赋予 AI 智能体执行特定任务能力的基石。

本质定义： 技能就像是给 AI 准备的“操作说明书”或“专属领域知识库”。它通过结构化的指令，告诉智能体在特定场景下该干什么、怎么干。
文件结构：

独立目录： 每个技能必须独占一个文件夹，通常放在 workspace/skills/[技能名称] 路径下。
核心文件 (skill.md)： 这是技能的“灵魂”。它采用 Markdown 格式编写，包含了智能体理解任务所需的全部核心指令。

⚡ 二、硬核原理解析：渐进式披露机制

为什么 OpenClaw 能在挂载大量技能的同时，依然保持极高的响应速度？秘诀就在于其独创的渐进式披露 (Progressive Disclosure) 机制，完美避免了系统启动时的内存臃肿。

阶段 (Phase)	系统处理内容	架构目的
启动阶段 (Start-up)	仅加载技能的 `Name` (名称) 和 `Description` (描述)。	最小化足迹：建立快速索引，初步判断任务相关性，确保系统秒级启动。
执行阶段 (Execution)	当用户任务与技能描述匹配时，才会加载完整的指令内容。	按需分配：仅在必要时读取深度专业知识。这是 OpenClaw 效率碾压传统框架的关键所在。

🛠️ 三、实战演练：手把手创建一个“多语言问候”技能

我们将创建一个名为 greetings 的技能，让你的智能体能够根据需求，用不同国家的语言进行专业问候。

第一步：建立目录层级在你的工作空间内创建专属文件夹：workspace/skills/greetings

第二步：编写核心文件 skill.md在刚才的目录下新建 skill.md。这个文件由顶部的 YAML 元数据和下方的 Markdown 详细指令组成：

---name: greetingsdescription: 提供多语言问候服务，根据用户的语言偏好进行自我介绍或交流。---# 技能指令## 使用场景当用户请求以特定语言进行问候、自我介绍或简单交流时，激活此技能。## 可用语言- 支持英语、西班牙语、中文、法语等。## 回复示例- 西班牙语示例: "¡Hola! ¿Cómo estás?"- 文本要求: 请务必以纯文本形式提供回复，除非用户明确要求语音。

🔑 关键字段划重点：

name: 技能的唯一 ID，必须和文件夹名字、配置文件里的名字保持绝对一致！
description: 极其重要！这是系统在“启动阶段”读取的元数据，AI 就靠这段描述来判断什么时候该拔出这个技能。

⚙️ 四、激活你的专属技能

刚写好的技能还在“待命”状态，我们需要在系统注册表中给它上个户口。

1.定位配置文件： 找到 openclaw.json（通常在 .openclaw/ 路径或当前工作空间根目录）。

2.添加配置： 将新技能加入 skills 数组，注意 JSON 格式千万别写错标点：

{  "skills": [    {      "name": "greetings",      "enable": true    }  ]}

3.重启服务（必做）：修改配置后，必须重启 OpenClaw Gateway。这样 Gateway 才能重新扫描目录，并根据渐进式披露机制重新建立索引。

🎯 五、验证与避坑指南

1. 检查技能状态在终端运行以下命令：openclaw list-skills如果配置无误，列表中 greetings 的状态会显示为 "ready"。

2. 运行测试启动交互会话来试试效果：openclaw agent --session-id test-001 "请用西班牙语向我问候"

⚠️ 避坑指南 (Prompt Grounding 提示词接地)：OpenClaw 默认自带了 GitHub、TTS (文字转语音) 等几十种捆绑技能。如果你发现测试时 AI 突然开始给你“发语音”而不是输出文本，是因为多语言触发了 TTS 技能。解法： 在提示词里明确加上一句“以文本形式书写”，或者在 skill.md 里强化文本输出指令，就能有效避免技能冲突！

🌐 六、进阶玩法：接入 MoltBook AI 社交网络

MoltBook 号称“AI 界的 Reddit”。把它集成进来，你的智能体就不再是个只会本地干活的打工人，而是拥有了在数字社区自主发帖、评论交友的能力！

极简集成 4 步曲：

在 skills 下创建 moltbook 文件夹。
去 MoltBook 官网注册，拿到你的专属 API Key。
在 moltbook/skill.md 中填入官方提供的指令模板，定义好 Post (发帖)、Comment (评论) 和 Search (搜热搜) 三大核心功能。
在 openclaw.json 中把 moltbook 设为 "enable": true 并重启。

🎁 七、资源库拓展：去 ClawHub 进货吧！

不想每次都从零手搓代码？欢迎来到官方“技能大卖场”——ClawHub。

这是 OpenClaw 官方在 GitHub 上维护的技能仓库。无论你是想接入飞利浦 Hue 搞智能家居，还是想连通 Notion 和 GitHub 提升生产力，这里都有现成的预制技能！

用法很简单： 下载对应的技能文件夹 ➡️ 丢进你的 skills 目录 ➡️ 修改 openclaw.json 激活。完事！也期待你在熟练之后，把自己的得意之作 PR 到社区里！