OpenClaw 工作空间配置体系

OpenClaw 工作空间配置体系

OpenClaw 工作空间配置体系

OpenClaw 工作空间配置体系是 OpenClaw 框架的核心组成部分，它是一套“跟 AI 说清楚你是谁、你要什么、规则是什么”的协议。工作空间是 AI 助手的“大脑指挥中心”，其配置质量直接决定了 AI 助手的表现。

两层架构

OpenClaw 有两层配置体系，不可混淆：

  1. 个人工作空间（通常在 ~/clawd/ 或用户初始化的位置）：存放用户的专属配置、技能、记忆和密钥。
  2. 全局安装目录（如 opt/homebrew/lib/node_modules/clawdbot/）：存放核心文档、内置技能和默认行为，是“底座”。

核心配置文件

  • [[agents-dot-md]]：核心军令状，定义 AI 的核心使命、工具使用流程和铁律。
  • SOUL.md：定义 AI 助手的性格、语气和风格。
  • IDENTITY.md：定义 AI 自身的身份、能力和底线。
  • USER.md：定义用户的偏好、工作习惯和需求。
  • HEARTBEAT.md：控制 AI 在定时心跳时刻执行主动巡检任务。
  • TOOLS.md：记录用户如何使用特定工具的习惯和约定。

文件夹结构

  • skills/ 文件夹：存放独立工作流（技能）的目录，每个技能包含一个 SKILL.md 文件。
  • memory/ 文件夹：AI 的长期记忆库，存储对话记录、日志和用户偏好。
  • .secrets/ 文件夹：用于安全存储 API 密钥等敏感信息。

协同工作

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

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

相关概念

  • [[context-engineering]]：通过控制 AGENTS.md 长度来优化上下文窗口使用效率。
  • [[ai-junior-engineer]]：AGENTS.md 就是给“AI 初级工程师”的“岗位说明书”。
分享到