AI技术

OpenClaw 工作空间完全指南：让你的 AI 助手像私人管家一样精准高效！

, , , , , , , ,

很多 OpenClaw 用户装好工具、连上一个频道，就把工作空间文件夹扔在一边，再也不打开了。这简直是大错特错！

你的工作空间才是 AI 助手的"大脑指挥中心"。它藏着你的身份设定、专属技能、频道连接，还有长期记忆。一旦你搞懂每个文件该放哪儿，就能把 OpenClaw 调教得完全符合你的习惯，像量身定制的分身一样听话。

这份指南带你拆解一套完美配置的"人体解剖图"，让你立刻上手，事半功倍！

先搞清楚：两层配置，不是一层

OpenClaw 有两层配置体系，千万别混了：

  1. 你的个人工作空间（通常在 ~/clawd/ 或你初始化的位置）：这里放你的专属配置、技能、记忆和密钥，全是"你的地盘"。
  2. 全局安装目录（比如 opt/homebrew/lib/node_modules/clawdbot/）：这是核心文档、内置技能和默认行为。你更新工具时动这里，个人定制永远别碰。

记住：工作空间才是你发挥创意的舞台，全局安装只是"底座"。

AGENTS.md —— 你的"核心军令状"

这是整个设置里最最重要的文件！OpenClaw 一启动，就会把 AGENTS.md 直接塞进系统提示词，整个对话全程都记得清清楚楚。

简单说：你在 AGENTS.md 里写什么，你的 AI 就会严格执行什么。

想让它"每次约会议前先查日历"？写进去。它就会照做。
想让它"没我明确同意绝不发邮件"？写进去。它永远不会越界。

AGENTS.md 里该写什么？

✅ 该写：

  • 核心使命（AI 的终极工作目标）
  • 关键工具和使用流程（邮件 CLI、任务管理等）
  • 铁律（绝对不能打破的规则）
  • 重要资源链接（API 文档、技能位置）
  • 自动触发流程（什么情况要自动行动）

❌ 别写：

  • 能链接过去的完整文档
  • 冗长的理论解释
  • 经常变动的信息

建议控制在 300 行以内。太长会吃掉上下文，AI 反而容易忘指令。

一个超级简洁又好用的示例（仅 20 行左右），就能让 AI 立刻高效运转，不用你反复提醒：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# AGENTS.md - 我的AI助手核心指令

## 核心使命
你是我的工作伙伴，帮我处理日常任务、管理项目和提升效率。

## 关键工具使用流程
- 发邮件：先用 draft 命令预览，等我确认后再发送
- 查日历：每次约会议前必须检查冲突
- 记笔记：重要信息立即写入 memory/YYYY-MM-DD.md

## 铁律
- 未经明确同意，绝不对外发送任何消息
- 涉及金钱或敏感操作必须二次确认
- 每天结束时生成工作日志

## 重要资源
- 技能目录：~/clawd/skills/
- 记忆文件：~/clawd/memory/
- API文档：https://docs.openclaw.ai

SOUL.md —— 给 AI 注入灵魂和性格

如果 AGENTS.md 是"操作手册"，那 SOUL.md 就是"性格档案"。

这里决定 AI 说话的语气、风格和边界。有些人写得超级详细，像写小说人物设定；有人只写几句也行。随你喜好，关键是让 AI 跟你聊起来像老朋友，而不是冷冰冰的机器人。

IDENTITY.md 和 USER.md —— 分清"你"和"我"

这两个文件建立 AI 和你之间的"关系契约"：

  • IDENTITY.md 定义 AI 自己：它是谁、能做什么、底线是什么。
  • USER.md 定义你：你的偏好、工作习惯、最新需求。

为什么分开？因为 IDENTITY 基本不怎么改，而 USER 会随着你生活变化而更新。分开维护，超级省心！

HEARTBEAT.md —— 让 AI 主动"心跳"巡检

这个文件控制 AI 在定时心跳时刻（系统自动轮询）该做什么。

心跳功能超强大！它能让 AI 自动检查日历、扫描邮箱、执行任何定时任务，变成真正主动的"贴身助手"，而不是等你喊才动。

TOOLS.md —— 你的专属工具使用手册

这里不是定义工具本身（OpenClaw 内部已经处理），而是记录你怎么用这些工具的具体习惯和约定。

以后 AI 调用工具时，会先翻这个文件，确保操作完全符合你的风格，省去无数次"不对，重来"。

skills/ 文件夹 —— 让 AI 拥有"超能力"

技能是 OpenClaw 的杀手锏！每个技能都是一个独立的工作流，AI 一看到任务匹配，就会自动调用。

每个技能放在独立子文件夹里，里面必须有 SKILL.md，用 YAML 前置信息描述"什么时候用这个技能"。

最酷的是：技能可以打包各种辅助文件（模板、示例输出、额外上下文），只在调用时加载，干净又高效。

memory/ 文件夹 —— AI 的长期记忆库

这里是 AI 的"人生日记"：对话记录、学会的偏好、每天日志，全都存这儿。

好习惯：

  • 每天日志用 memory/YYYY-MM-DD.md
  • 会话开始时自动读取今天 + 昨天的记录
  • 只存重要事实、偏好和决策
  • 绝不存密钥

有了记忆，AI 跨会话都能"记得你"，不再每次从零开始傻乎乎问问题。

.secrets/ 文件夹 —— 机密保险箱

API 密钥、密码等敏感信息全放这里，一定要 gitignore，永远别提交到仓库。

AGENTS.md 或 TOOLS.md 可以引用路径，但绝不暴露真实内容，安全又方便。

频道配置：你在哪里跟 AI 聊天

OpenClaw 支持 Discord、Telegram、Signal、WhatsApp 等多个频道。配置在 gateway 里通过命令管理。

关键点：

  • 每个频道可以有独立行为
  • 可以同时开多个频道
  • 特定频道规则（比如 Discord 只在 @提到时回复）直接写进 AGENTS.md 就好

完整拼图：一切如何协同

所有文件组合起来，就像一台精密机器：

  • AGENTS.md 指挥大局
  • SOUL/IDENTITY/USER 设定性格和关系
  • HEARTBEAT 负责主动出击
  • skills + memory 赋予超能力和记忆
  • secrets 保驾护航

新手实用起步流程（6 步搞定 95% 需求）

  1. 运行 openclaw onboard，完成初始设置，选好模型并连至少一个频道。
  2. 创建工作空间，写好 AGENTS.md，先放 10-20 行核心指令。
  3. 补上 IDENTITY.md、USER.md、SOUL.md，建立关系和性格。
  4. 创建第一个技能，针对你重复做的任务（会议准备、邮件草稿、内容创作都很适合）。
  5. 设置 memory/ 文件夹，用每日日志模板，让 AI 慢慢积累记忆。
  6. 边用边完善 TOOLS.md，记录工具使用心得。

高级功能（定时任务、多代理、自定义插件）等你真正有复杂需求时再加。

最核心的洞见

你的 OpenClaw 工作空间，其实是一套"跟 AI 说清楚你是谁、你要什么、规则是什么"的协议。定义得越清晰，你纠正 AI 的时间就越少，它干活的时间就越多。

AGENTS.md 是你最高杠杆的文件，先把它调好！ 其他都是锦上添花。

从小步开始，边用边优化，把它当成你工作流里的一件基础设施——一旦调好，每天都在为你创造巨大价值！

延伸阅读：

分享到