带你更加深入了解openclaw的目录结构与skills

🦞 OpenClaw 文件结构详解 + Skills 配置与常用技能指南

从入门到精通，搞懂 OpenClaw 的文件分工和技能生态

📁 OpenClaw 目录结构与各个文件作用

OpenClaw 采用非常清晰的目录设计，让你轻松管理配置、技能和数据。默认安装后，目录结构如下：

~/.openclaw/├── workspace/          # 你的工作区（默认），存放笔记、教程、项目文件│   ├── AGENTS.md       # 工作区行为规范，给AI助手看的│   ├── BOOTSTRAP.md    # 首次启动引导，完成后会自动删除│   ├── HEARTBEAT.md    # 定时检查任务清单，控制心跳自动检查│   ├── IDENTITY.md     # 你的AI助手身份配置（名字、风格等）│   ├── MEMORY.md       # AI的长期记忆，存放重要决策和需要记住的信息│   ├── SOUL.md         # AI助手性格和行为准则│   ├── TOOLS.md        # 本地环境配置笔记（摄像头、SSH偏好等）│   ├── USER.md         # 关于你的信息（名字、时区等）│   └── memory/         # 每日日志，按日期存放每日活动记录├── node_modules/       # npm依赖包，一般不用碰├── extensions/         # 已安装的扩展插件存放位置├── skills/             # 已安装的技能存放位置│   └── [skill-name]/   # 每个技能一个单独目录，包含SKILL.md和脚本├── openclaw.json       # 主配置文件，所有核心配置都在这里└── logs/               # 日志文件，排查问题用

核心文件作用详解

文件/目录	作用	需要修改吗
`workspace/`	你所有个人文件和笔记存放的地方，OpenClaw AI默认在这里工作	✅ 经常修改
`workspace/MEMORY.md`	AI的长期记忆库，重要信息会存在这里方便后续读取	✅ AI自动更新，你也可以手动编辑
`workspace/HEARTBEAT.md`	心跳检查任务，在这里添加需要AI定期检查的任务（收邮件、看日程等）	✅ 按需修改
`openclaw.json`	全局配置文件，包含LLM配置、频道配置、技能配置等	⚠️ 一般用`openclaw config`命令修改，不建议手动编辑
`skills/`	所有安装的技能都在这里，每个技能一个文件夹	✅ 用命令管理，不用手动改
`extensions/`	平台扩展（飞书、钉钉等）存放在这里	❌ 一般不用管
`logs/`	运行日志，出问题了可以看这里排查	⚠️ 出问题的时候才需要看

🧩 Skills 是什么？怎么安装和配置？

Skills 是 OpenClaw 的技能扩展系统，类似浏览器的插件，可以给 AI 增加各种各样的能力。比如：

天气查询
飞书文档操作
安全健康检查
新建技能脚手架
等等...

🧩 OpenClaw 里两个重要概念：Plugins（插件）和 Skills（技能）

很多新手容易搞混这两个，这里先明确：

概念	作用	怎么安装管理
Plugins（插件/扩展）	提供底层工具支持，比如对接飞书、钉钉、QQ等平台，提供API接口	使用 `openclaw plugins` 命令管理
Skills（技能）	给AI提供使用工具的指导文档，告诉AI什么时候该用什么工具、怎么用，类似操作手册	官方技能都随 OpenClaw 内置安装好了，第三方技能可以从 ClawHub 安装

技能管理说明

官方内置技能：OpenClaw 安装后自带所有官方维护的技能，不需要额外安装，AI会自动加载
第三方社区技能：从 ClawHub 安装，命令格式：

# 安装第三方技能openclaw plugins install https://github.com/username/skill-name.git

技能配置

大部分技能不需要额外配置，开箱即用。少数需要配置的技能会提供说明，一般通过以下两种方式配置：

命令行配置（推荐）

openclaw config set skills.<skill-name>.<config-key> <value># 例子：配置天气技能默认城市openclaw config set skills.weather.defaultCity Shanghai

手动编辑配置文件 编辑 openclaw.json，在 skills 节点下添加对应配置：

{"skills": {"weather": {"defaultCity": "Shanghai","enabled": true}}}

插件管理常用命令

如果需要安装平台插件（比如飞书插件），用以下命令：

# 列出所有已发现的插件openclaw plugins list# 安装插件（比如飞书完整插件包）openclaw plugins install feishu# 更新插件openclaw plugins update feishu# 卸载插件openclaw plugins uninstall feishu# 启用插件openclaw plugins enable feishu# 禁用插件openclaw plugins disable feishu

如何安装第三方技能（Skills）

第三方技能一般是社区开发者贡献的，存放在 ClawHub（OpenClaw官方技能分享平台）或者 GitHub，安装方式如下：

从 ClawHub 安装技能（推荐）

ClawHub 是 OpenClaw 官方的技能分享平台，你可以在上面浏览、搜索各种社区贡献的技能。

安装步骤：

访问 https://clawhub.com，搜索你想要的技能
复制技能的安装地址（一般是 clawhub:[author]/[skill-name] 格式）
执行安装命令：

openclaw plugins install clawhub:[author]/[skill-name]# 例子：安装用户 openclaw 分享的 my-skill 技能openclaw plugins install clawhub:openclaw/my-skill

ClawHub 会自动处理下载和安装，非常方便。

从 GitHub 安装第三方技能

如果你知道技能的 GitHub 仓库地址，也可以直接从 GitHub 安装：

openclaw plugins install https://github.com/[username]/[skill-repo-name].git

安装完成后，技能会自动被 OpenClaw 识别加载，不需要额外操作。

本地第三方技能安装

如果你已经下载了技能到本地，或者在本地开发技能，可以用链接方式安装：

openclaw plugins link /path/to/your/local/skill-directory

这会创建一个软链接到本地技能目录，修改代码后立即生效，非常适合开发调试。

更新第三方技能

openclaw plugins update [skill-name]

删除第三方技能

openclaw plugins uninstall [skill-name]

技能配置

大部分技能不需要额外配置，开箱即用。少数需要配置的技能会提供说明，一般通过以下两种方式配置：

命令行配置（推荐）

openclaw config set skills.<skill-name>.<config-key> <value># 例子：配置天气技能默认城市openclaw config set skills.weather.defaultCity Shanghai

手动编辑配置文件 编辑 openclaw.json，在 skills 节点下添加对应配置：

{"skills": {"weather": {"defaultCity": "Shanghai","enabled": true}}}

🔥 常用技能推荐：安装与使用

下面介绍几个官方维护的超实用常用技能，覆盖大部分日常使用场景。

1️⃣ 技能：weather 天气查询

作用：查询任意城市的实时天气和未来预报，不需要API密钥。

安装：官方内置技能，OpenClaw安装后自带，不需要额外安装。

使用：直接问你的AI助手就行：

"今天北京天气怎么样？" "上海未来一周会下雨吗？"

可选配置：

# 设置默认查询城市，这样不用每次都带城市名openclaw config set skills.weather.defaultCity Guangzhou

2️⃣ 技能：feishu-doc 飞书文档操作

作用：直接在对话中读取、编辑、创建飞书文档，支持表格操作、图片上传等。

安装：官方内置技能，OpenClaw安装后自带；需要先安装飞书插件：openclaw plugins install feishu

前置要求：已经配置好飞书渠道，获得了飞书应用凭证。

使用示例：

读取飞书文档："帮我总结一下 https://your-feishu-url/docx/xxx 这篇文档的核心内容"
创建新文档："帮我创建一篇名为'2026年项目规划'的飞书文档，内容是..."
在文档中插入表格："在这篇文档末尾插入一个3列5行的项目进度表"

3️⃣ 技能：feishu-wiki 飞书知识库导航

作用：操作飞书知识库，列出空间、创建文档、移动文档等。

安装：官方内置技能，OpenClaw安装后自带；需要先安装飞书插件：openclaw plugins install feishu

常用场景：

"列出我的飞书知识库所有空间"
"在'个人知识'空间创建一篇标题为'旅行攻略'的文档"
"把这篇文档移动到'项目归档'文件夹"

4️⃣ 技能：healthcheck 系统安全健康检查

作用：给你的 OpenClaw 服务器做安全审计，检查防火墙配置、SSH安全、系统更新等。适合部署在VPS上的用户。

安装：官方内置技能，OpenClaw安装后自带，不需要额外安装。

使用：

# 给AI说：帮我做一次系统安全健康检查# 或者直接在命令行触发健康检查openclaw healthcheck

功能包括：

检查SSH根用户登录是否禁用
检查防火墙是否启用
检查系统是否有未更新的安全补丁
检查OpenClaw版本是否最新
给出安全加固建议

5️⃣ 技能：skill-creator 技能创建助手

作用：帮你快速创建新的 OpenClaw 技能，自动生成目录结构和SKILL.md模板，适合想要开发自己技能的用户。

安装：官方内置技能，OpenClaw安装后自带，不需要额外安装。

使用：直接跟AI说："帮我创建一个新技能，名字叫my-custom-skill，功能是xxx"，skill-creator会自动帮你生成所有需要的文件和模板，你只需要填充内容就行。

6️⃣ 技能：feishu-drive 飞书云文件管理

作用：管理飞书云空间的文件和文件夹，列出文件、创建文件夹、移动删除文件。

安装：官方内置技能，OpenClaw安装后自带；需要先安装飞书插件：openclaw plugins install feishu

常用操作：

"列出飞书云根目录所有文件"
"在'工作文档'文件夹创建一个叫'项目资料'的新文件夹"
"把这个文件移动到'归档'目录"

💡 技能使用小贴士

技能会自动激活：只要你安装了技能，AI在需要的时候会自动调用，你不用手动触发，只需要正常提问就行。
看技能的SKILL.md：每个技能目录里都有SKILL.md，里面有详细的使用说明和参数配置，遇到问题可以直接读这个文件。
找不到技能？去 ClawHub 看看：社区用户分享的技能都在 https://clawhub.com，你也可以把自己做的技能分享上去。
技能冲突很少：OpenClaw 的技能系统设计得很合理，一般同时装很多技能也不会冲突，放心装就行。

📝 总结

OpenClaw 的文件结构非常清晰，你的个人文件都在 workspace，配置在 openclaw.json，技能在 skills 目录
技能安装非常简单，openclaw skills install 一键搞定
常用技能覆盖了天气、飞书操作、安全检查、技能开发等场景，开箱即用
如果你想自己做技能，skill-creator 能帮你快速起步

有了技能系统，OpenClaw 可以无限扩展，满足你各种各样的需求！