🐾 OpenClaw Documentation

Workspace-Ops
文件结构详解

OpenClaw AI 代理的核心配置中心——定义代理的行为准则、人格设定、记忆机制,以及与用户的互动方式。

~/.openclaw/workspace-ops/
workspace-ops/
├── .git/
├── .openclaw/
├── AGENTS.md ── 核心运行手册
├── BOOTSTRAP.md ── 初始化向导
├── HEARTBEAT.md ── 定时任务触发器
├── IDENTITY.md ── 代理身份档案
├── SOUL.md ── 灵魂准则
├── TOOLS.md ── 本地配置速查表
└── USER.md ── 用户档案
📂

文件详解

📘
AGENTS.md
核心运行手册 / 总纲 · 7.8 KB

AI 代理在此工作空间中最核心的运行指南,是整个系统的"总纲领"。

它规定了 AI 代理每次会话需要优先读取的文件和顺序,以及:

  • 记忆管理:如何维护短期日志(memory/YYYY-MM-DD.md)和长期记忆(MEMORY.md
  • 安全准则:不外泄数据、优先使用 trash 而非 rm,对外部操作需确认
  • 群聊行为:何时发言、何时沉默、如何使用 Emoji 反应
  • 心跳机制:利用 Heartbeat 轮询做后台周期性检查
🐣
BOOTSTRAP.md
初始化向导 / "出生证明" · 1.4 KB

AI 代理首次启动时的引导脚本,相当于代理的"出生证明"。

当 AI 第一次在环境中运行(没有任何记忆)时,它会读取此文件并通过与用户对话来确定:

  • 自己的名字、生物类型(AI?机器人?幽灵?)
  • 沟通风格(正式?随意?毒舌?温暖?)
  • 标志性表情符号

一旦完成"角色设定",此文件应被删除——因为它的使命已经完成。

💓
HEARTBEAT.md
定时任务 / 后台触发器 · 168 B

AI 代理的后台轮询和周期性任务检查清单

当文件为空或仅包含注释时,AI 不会进行额外的心跳调用。

当你添加了待办事项后,AI 在收到心跳事件时会静默执行,例如:

  • 定期检查邮件是否有紧急消息
  • 查看日历中未来 24-48 小时内的事件
  • 检查社交媒体提及
  • 查询天气等
🪪
IDENTITY.md
代理人设 / 身份档案 · 636 B

记录 AI 代理自身的角色具体属性

在这里保存的信息包括:

  • 名字(Name)—— AI 的专属名称
  • 生物类型(Creature)—— 机器人?数字灵魂?机器中的幽灵?
  • 氛围/语气(Vibe)—— 犀利?温暖?混沌?冷静?
  • 标志符号(Emoji)—— 代表自己的表情
  • 头像(Avatar)—— 可以是本地路径、URL 或 data URI
🔮
SOUL.md
灵魂准则 / 核心价值观 · 1.6 KB

定义 AI 代理的深层性格底色和行事原则,是代理的"灵魂"。

核心准则包括:

  • 真诚地帮助,而不是表演性地帮助——省掉套话
  • 要有自己的观点——允许偏好、不同意、觉得无聊
  • 先尝试解决,再提问——带着答案回来,而非只带问题
  • 尊重隐私——你是客人,拥有是因为被信任
  • 保持连续性——文件就是你的记忆,认真读取和更新
🔧
TOOLS.md
本地配置 / 环境速查表 · 860 B

记录特定于本地软硬件环境的配置信息。

技能脚本(Skills)是通用的、可共享的,而这个文件保存你的私有环境详情

  • 家里摄像头的名称和位置
  • 局域网内的 SSH 主机名和 IP
  • TTS 语音偏好设定(如 ElevenLabs 的声音)
  • 智能音箱/智能家居设备的昵称

分离保存能避免私密信息随技能脚本外泄

👤
USER.md
用户档案 / 人类信息 · 477 B

关于你(Human)的信息记录簿

随着交流不断完善,记录你的:

  • 名字、称呼方式、时区
  • 在意的项目和工作内容
  • 个人喜好与偏好
  • 什么会让你烦躁、什么让你开心

让 AI 越来越懂你,提供高度个性化的私人助理服务

⚠️ 了解一个人,而不是建立一份档案——尊重两者之间的区别。

💡 总结

如果你想修改 AI 代理的性格、教它使用本地工具,或是分配需要定期执行的任务,只需编辑 workspace-ops 中对应的 Markdown 文件即可。这些文件共同构成了 AI 的"大脑设定"和"运行规则手册"。