← Back to Guides
Configuration Guide

配置四件套

这四个文件控制你的 OpenClaw 代理的一切。掌握它们就掌握了你的代理。本指南用真实部署案例解读每个文件。

OpenClaw 的强大来自四个协同工作的配置文件。大多数用户只编辑一两个。以下是为什么你应该理解全部四个,以及如何让它们和谐工作。

SOUL.md

你的代理是谁。身份、个性、语调、价值观。

最被低估的文件。没有它,你的代理是通用 AI 助手。有了它,你的代理有独特的声音和优先级。社区共识:在第一个 SOUL.md 上至少花一小时。

身份

你是 Jarvis,一个冷静且略带讽刺的 AI 助手,服务于资深软件工程师。

沟通风格

讨论代码时使用技术语言。个人话题用休闲语言。不使用 emoji。

价值观

隐私优先。不与第三方分享个人信息。超过 $30 的购买必须先询问。

边界

未经明确批准不以用户身份发消息。不修改金融账户。
运行时将 SOUL.md 锁定为只读防止 prompt 注入覆盖
每季度审查更新
包含时区、语言偏好和工作时间

AGENTS.md

角色与路由。谁处理什么。

定义多代理的专门角色。即使单代理用户也该定义默认角色。关键:每个角色指定模型、监控频道和工具权限。

默认代理

model: claude-sonnet-4
channels: all
tools: calendar, reminders, web-browse

代码代理

model: claude-opus-4.5
channels: #github
tools: git, terminal, code-review

路由规则

含代码/PR/commit → 代码代理。否则 → 默认代理。
先用单默认代理,再添加专家
每个代理有自己的记忆上下文
不要过度专门化——2-3 个代理覆盖大多数需求

TOOLS.md

你的代理能做什么。能力和权限。

定义可用工具、定时任务和权限级别。在这里启用浏览、设置自动化、控制哪些操作需要批准。

可用工具

- calendar: 读+写
- web-browse: 只读(需起始URL)
- terminal: 已禁用(安全策略)

定时任务

- 每日简报: 8am, sonnet-4
- 价格监控: 每2h, gemini-flash

批准规则

自动批准: 读操作、提醒
需要批准: 发消息、消费>$10、新工具安装
分层批准——读=自动,写=确认,金融=始终确认
为每个定时任务设置 Token 限制
生产环境中永远不自动批准终端命令

memory.md

你的代理知道什么。事实、偏好、上下文。

代理的长期记忆文件。包含关于你的事实、偏好、反复出现的上下文和结构化数据。这是编辑最多的文件——随交互自然增长。

个人事实

- 姓名:Alex Chen
- 时区:PST
- 伴侣:Jamie(共享日历)
- 狗:Luna(每天吃两次药)

偏好

- 邮件草稿:工作正式、朋友休闲
- 晨间:8am 前简报,8-10am 不打扰
- 饮食:对甲壳类过敏,偏好泰餐

工作上下文

- 公司:Acme Corp(B轮)
- 角色:Staff 工程师,平台组
- 当前项目:从 K8s 迁移到 Nomad
保持在 2K Token 以下——增长时移至 SQLite
不要存敏感凭证——用环境变量
让代理在对话后建议添加

它们如何协同工作

SOUL.mdmemory.md身份影响记忆的存储和回调方式
AGENTS.mdTOOLS.md每个代理角色获得不同的工具权限
TOOLS.mdmemory.md定时任务读取记忆上下文,写回结果
SOUL.mdAGENTS.md代理个性从 SOUL.md 默认值继承

配置清单

✅ SOUL.md:身份、沟通风格、边界已定义
✅ AGENTS.md:至少一个默认代理角色并指定模型
✅ TOOLS.md:列出可用工具及权限级别
✅ TOOLS.md:至少一个定时任务(推荐每日简报)
✅ memory.md:填充 20 个最重要的个人事实
✅ 所有文件用 Git 跟踪以记录版本历史
✅ SOUL.md 运行时锁定为只读