OpenClaw 工作空间配置文件全景图

OpenClaw Agent 工作空间由12个核心配置文件构成，分三类。搞懂这些文件，你就搞懂了整个 Agent 系统是怎么跑起来的。

🔐 一、认证与基础设施

这一类文件回答的问题是："能不能跑"——没有它们，OpenClaw 根本启动不了。

openclaw.json — 主配置文件，定义 channels（飞书/Discord/Telegram等）、accounts（多账号）、plugins（扩展插件）、requireMention（是否需要@触发）等运行时核心参数。相当于 OpenClaw 的"系统设置"。

device.json — 设备认证密钥对，用于 Gateway 节点接入和设备配对安全验证。你可以理解成"这台机器的身份证"，只有配对成功的设备才能接入 OpenClaw 网络。

.env — 环境变量，存储所有 API 密钥（VOLCENGINE_IMAGE_API_KEY、WECHAT_APP_ID、MiniMax API Key 等）。文件内容不上传 git，敏感信息靠它保护。

models.json — 各 Agent 的模型配置，告诉 OpenClaw 该用哪个 AI 模型来驱动这个 Agent。比如 xiaowei 用的是 MiniMax M2.7，不同 Agent 可以用不同的模型。

这一类文件回答的问题是："我是谁、该怎么干"——决定了 Agent 的性格和行为方式。

AGENTS.md — 定义 Agent 调度架构。总入口 Agent（如小熊）负责接收消息、分发给对应的 Agent 成员，每个 Agent 的职责分工在这里说清楚。

SOUL.md — Agent 灵魂定义，回答"我是谁"这个问题。包含核心原则（快/准/稳）、做事风格、工作底线。一个 Agent 的 SOUL.md 决定了它和其他 AI 助手的差异。

IDENTITY.md — 身份标识卡。名字（小微 🐻）、角色定位（公众号助手）、vibe（活泼/执行力强）。是 Agent 启动时最早加载的几行基础信息。

BOOTSTRAP.md — 启动引导配置。新 workspace 首次启动时的初始化文案，告诉 Agent"你是谁、你属于哪个团队、你的职责是什么"。初始化完成后可以删除。

这一类文件回答的问题是："为谁干、怎么调度"——让 Agent 知道服务对象是谁、什么时候该干什么。

USER.md — 用户画像。记录 CEO 的身份、时区、AI 团队架构（7个 Agent 及其 AppID）、交互偏好（飞书群聊/方案A）。随对话积累持续更新，Agent 越用越懂主人。

TOOLS.md — 本地工具备注。API 密钥（微信 AppId/Secret）、中文字体路径、公众号写作风格配置等环境特定信息。只属于这台机器，不随 workspace 迁移。

HEARTBEAT.md — 心跳配置。控制 Agent 主动向用户推送状态更新的机制（如每日定时报告）。空文件 = 未配置心跳，跳过主动汇报。

cron/jobs.json — 定时任务清单。定义有哪些自动化任务在什么时间执行，比如"每日 8:30 公众号 AI 选题"。每个任务记录了触发时间、目标 Agent、执行内容。

所有文件共同构成一个可独立运行、可多 Agent 协作的 AI 工作空间。

认证文件确保"有资格进门"，角色文件确保"知道自己是谁"，任务文件确保"知道该干什么事"——三者缺一不可。

理解了这些配置文件的逻辑，你就能玩转 OpenClaw 的多 Agent 架构了。