OpenClaw指南你的小龙虾里到底住着什么? openclaw目录功能全介绍

点击下方👇“李新新AI”关注公众号

一起学习AI、成长、赚钱、搞副业！

❝
强烈建议大家，把这篇文章直接发给你的小龙虾，让他阅读学习后，以后改动都遵守最标准的规范配置

大家好，我是李新新

相信大家应该都用了 OpenClaw 一段时间了，很多人说这只小龙虾真挺难养！

光基础配置问题就能把人搞得一脸懵😵

如果配置了一些不太聪明的AI模型，它自己一顿乱改，甚至会把自己改崩😩。

为什么呢？因为它连它自己都搞不清楚！

改崩了怎么办？搞清楚他的目录，就很好排查问题了！

很多人打开本地目录结构一头雾水——配置文件在哪？Agent 的记忆存哪？Skills 优先级怎么算？今天把这些统统讲清楚，一次搞定。

OpenClaw 安装完成后，核心数据全部住在你的用户目录下：~/.openclaw/。从配置、技能到记忆、日志，各司其职，结构非常清晰。

先看全貌

01 · `openclaw.json`

整个 OpenClaw 的神经中枢。所有关于"我要连哪个 AI"、"我要接哪些聊天平台"、"Skills 从哪加载"的问题，答案都在这一个文件里。

主要配置内容：

配置项	说明
LLM 提供商	Claude / GPT / DeepSeek 等模型的 API Key 和默认参数
渠道配置	Telegram Bot Token、Discord 密钥、WhatsApp 等各平台接入参数
skills.load	Skills 加载策略，含 extraDirs（额外技能目录）配置
Gateway 参数	端口、沙箱策略、心跳间隔、workspace 路径等运行参数

模型配置支持 ${MY_API_KEY} 这样的环境变量展开，密钥不用明文写死在文件里。

❝
💡 Gateway 监听文件变化，改完自动热加载，无需重启。

02 · `agents/`

这个目录是 Gateway 自动生成和维护的运行时状态目录，不是你手动编辑的地方。每个 Agent 有一个以其 ID 命名的子目录，里面包含：

auth-profiles.json — 该 Agent 的认证凭据，包括 WhatsApp 配对信息、OAuth token 等。不同 Agent 之间不自动共享
sessions/sessions.json — 会话路由表，记录所有 session key 到 session ID 的映射及元数据
sessions/<ID>.jsonl — 每个具体会话的完整对话记录（transcript），JSONL 格式逐条存储，包含工具调用输出

❝
⚠️ 这个目录可能包含私密信息（完整的对话内容、token）。建议对 ~/.openclaw/ 设置严格权限：目录 700，文件 600。切勿把这里的内容提交到 Git。

03 · `skills/`

OpenClaw 的技能系统让你可以"教会" Agent 如何使用某个工具或遵循某套流程。

~/.openclaw/skills/ 是共享技能库 ，同一台机器上的所有 Agent 都能用。

每个技能是一个子目录，核心是一个 SKILL.md 文件，包含 YAML 元数据（名称、描述、环境要求）和使用说明正文。

技能加载优先级（高 → 低）：

workspace/skills > ~/.openclaw/skills > 内置 bundled > extraDirs

同名技能以优先级最高的为准。

❝
💡 ClawHub（clawhub.com）是公共技能注册表，可以一键安装社区技能：clawhub install <skill-slug>，默认安装到当前工作目录的 skills/ 下。

04 · `workspace/`

这是整个目录体系里最值得花时间了解的部分。简单说：openclaw.json 控制 OpenClaw 怎么跑，而 workspace/ 决定你的 Agent 是谁、怎么说话、记住什么。

每次会话开始时，这里的 Markdown 文件会自动注入到 Agent 的上下文里，相当于给 Agent 的"开机说明书"。

workspace 下的文件

文件	加载时机	说明
`AGENTS.md`	每次	最核心的引导文件——操作指令、行为规则、重要约定，想让 Agent 永远遵守的事情都写这里
`SOUL.md`	每次	人格定义：语气风格、价值观、说话方式、边界。让 Agent 有自己的"味道"
`USER.md`	每次	你的画像：称呼偏好、语言习惯、背景信息，让 Agent 更了解你这个人
`IDENTITY.md`	启动时	Agent 的名字、emoji、风格定义。首次 setup 时由问答流程自动创建
`TOOLS.md`	每次	工具使用约定：SSH 主机地址、命令偏好、TTS 声音等。不控制工具能不能用，只是使用指导
`MEMORY.md`	主会话	长期精华记忆，可选（不自动创建）。仅私聊加载，群组会话不加载——保护你的隐私
`HEARTBEAT.md`	心跳	可选，定时任务指令。建议保持简短，每次心跳都消耗 token
`BOOT.md`	重启时	可选，Gateway 重启时执行的启动清单
`BOOTSTRAP.md`	仅一次	全新 workspace 首次运行时的初始化向导，完成后自动删除，不会再出现
`memory/`	近两天	每日对话日志目录，文件名格式为 `YYYY-MM-DD.md`，每次会话加载今天和昨天的文件
`skills/`	每次	此 workspace 的专属技能目录，优先级最高，覆盖同名的共享或内置技能
`canvas/`	Node 端	macOS/iOS Node 界面的 Canvas UI 文件（如 `index.html`），用于节点端自定义显示

05 · 知识库 / 记忆存在哪？

这是问得最多的问题。你对 Agent 说"记住这件事"，它到底存哪了？答案是分层存储，按重要程度落地：

第一层 · 当日日志

先写入 workspace/memory/今日日期.md，追加式记录，不覆盖历史。

第二层 · 长期精华

重要内容同步写入 workspace/MEMORY.md，这里是你知识库的核心，完全透明，可以随时手动编辑和整理。

第三层 · 向量索引

OpenClaw 自动把所有 Markdown 文件做嵌入，存入 ~/.openclaw/memory/<agentId>.sqlite，无需手动操作，供语义检索使用。检索时同时用向量相似度（措辞不同也能找到）和 BM25 关键词匹配（精确查代码符号、ID 等），混合排名。

第四层 · 扩展知识库

有大量外部资料（如本地笔记目录）？在 openclaw.json 里配置 memorySearch.extraPaths，指定目录后 OpenClaw 自动扫描索引，纳入统一检索。

❝
💡 如果会话过长快到 context 上限，OpenClaw 会在压缩前自动触发"记忆冲刷"，提醒 Agent 把重要内容写入文件，确保知识不随对话截断而消失。

06 · 其他目录

extensions/已安装的插件目录，包含插件代码及其 node_modules/。通过 ClawHub 或手动安装的插件都在这里。

sandboxes/工具沙箱的工作目录。启用沙箱后，工具在这个独立空间里操作，可能积累读写过的文件副本，可以定期清理释放空间。

实用建议

备份策略workspace/ 里的 Markdown 文件适合放 Git 版本控制；agents/ 下的会话记录和凭据绝对不要提交到远程仓库。

多 Agent 配置每个 Agent 可以指向不同的 workspace 路径（如 workspace-work/、workspace-home/），在 openclaw.json 的 agents.list 里配置。

权限设置建议执行：

chmod 700 ~/.openclawchmod 600 ~/.openclaw/openclaw.json

防止其他用户读取你的 token 和对话记录。

技能冲突同名技能以最高优先级为准。想临时覆盖某个内置技能，在 workspace/skills/ 下放同名目录即可，立即生效。

李新新说

养虾前先搞清楚这些目录，OpenClaw 就真的用透了一半。

剩下那一半——在 SOUL.md 里写出一个有趣的 Agent，在 MEMORY.md 里积累真正有用的知识，然后让它替你处理那些重复又无聊的事情。

❝
快把这篇文章发给你的小龙虾吧！

喜欢本文就点赞分享一下吧！

📌 关注我，下一篇将详细介绍：怎么快速、低成本养虾？

欢迎扫描下方二维码，添加李新新微信。