← 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.md→memory.md身份影响记忆的存储和回调方式
AGENTS.md→TOOLS.md每个代理角色获得不同的工具权限
TOOLS.md→memory.md定时任务读取记忆上下文,写回结果
SOUL.md→AGENTS.md代理个性从 SOUL.md 默认值继承
配置清单
✅ SOUL.md:身份、沟通风格、边界已定义
✅ AGENTS.md:至少一个默认代理角色并指定模型
✅ TOOLS.md:列出可用工具及权限级别
✅ TOOLS.md:至少一个定时任务(推荐每日简报)
✅ memory.md:填充 20 个最重要的个人事实
✅ 所有文件用 Git 跟踪以记录版本历史
✅ SOUL.md 运行时锁定为只读