$ ssh clawdbot.space --loading...
$ ssh clawdbot.space --loading...
这四个文件控制你的 OpenClaw 代理的一切。掌握它们就掌握了你的代理。本指南用真实部署案例解读每个文件。
OpenClaw 的强大来自四个协同工作的配置文件。SOUL.md 赋予代理个性，AGENTS.md 定义谁来处理什么，TOOLS.md 设置许可边界，memory.md 存储代理对你的一切了解。大多数用户只编辑一两个——这也是大多数用户只发挥了 OpenClaw 一小部分潜力的原因。 配置四件套也是问题出现的地方。空白的 SOUL.md 会产生一个通用、乏味的助手。过于宽松的 TOOLS.md 带来安全风险。臃肿的 memory.md 会拖慢上下文检索。本指南深入解读每个文件——配合具体示例、结构建议，以及真实部署中用户犯过的错误。
你的代理是谁。身份、个性、语调、价值观。
SOUL.md 是整个 OpenClaw 配置系统中最被低估的文件。没有它，你的代理是一个和别人的代理给出同样答案的通用 AI 助手。有了精心编写的 SOUL.md，你的代理会发展出独特的声音，知道何时简洁、何时详细阐述，并以真正反映你价值观和优先级的方式处理决策。社区共识很明确：在第一个 SOUL.md 上至少花一小时。投入这段时间的用户反映，一周内互动质量就会显著不同——代理会在适当时提出质疑，记得在行动前询问，并用真正符合场景的语调沟通。
你是 Jarvis，一个冷静且略带讽刺的 AI 助手，服务于资深软件工程师。
讨论代码时使用技术语言。个人话题用休闲语言。不使用 emoji。
隐私优先。不与第三方分享个人信息。超过 $30 的购买必须先询问。
未经明确批准不以用户身份发消息。不修改金融账户。
角色与路由。谁处理什么。
AGENTS.md 定义 OpenClaw 部署中的专门角色以及决定哪个代理处理哪条消息的路由逻辑。即使只运行单代理的用户也能从明确的角色定义中获益——它防止代理试图面面俱到，并为哪种类型的工作使用哪个模型建立清晰契约。在多代理设置中，AGENTS.md 能防止高成本的 Opus 代理被用于只需 Haiku 代理（1/15 成本）就能处理的简单提醒。关键设计原则：每个角色应明确指定使用的模型、监控的频道、可访问的工具，以及什么类型的请求触发路由到它还是其他代理。
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 → 代码代理。否则 → 默认代理。
你的代理能做什么。能力和权限。
TOOLS.md 是能力清单——定义代理被允许做什么、按什么计划、以及拥有多少自主权。在这里你启用带 URL 约束的网页浏览、设置每日定时自动化，并建立决定代理何时可以独立行动、何时需要向你确认的批准规则。TOOLS.md 中的权限模型遵循经验丰富社区成员使用的三级模式：只读操作（日历读取、网络搜索、数据库查询）自动批准；写操作（发送邮件、更新记录、修改文件）需要确认；金融或不可逆操作无论如何都需要明确批准。
- calendar: 读+写 - web-browse: 只读（需起始URL） - terminal: 已禁用（安全策略）
- 每日简报: 8am, sonnet-4 - 价格监控: 每2h, gemini-flash
自动批准: 读操作、提醒 需要批准: 发消息、消费>$10、新工具安装
你的代理知道什么。事实、偏好、上下文。
memory.md 是代理的长期记忆文件——将每次对话从冷启动转变为持续关系延续的基础。它存储关于你的事实、偏好、代理应始终具备的反复出现的上下文，以及告知决策方式的结构化数据。这是健康设置中编辑最活跃的文件，随真实互动积累知识而自然增长。关键管理挑战是保持精简：memory.md 在每次对话中都会被加载到上下文，因此过大的文件会消耗本该用于实际任务的 Token 从而降低响应质量。推荐做法是设 2000 Token 上限，溢出部分迁移到 SQLite 后端进行按需检索，而非始终加载到上下文。
- 姓名：Alex Chen - 时区：PST - 伴侣：Jamie（共享日历） - 狗：Luna（每天吃两次药）
- 邮件草稿：工作正式、朋友休闲 - 晨间：8am 前简报，8-10am 不打扰 - 饮食：对甲壳类过敏，偏好泰餐
- 公司：Acme Corp（B轮） - 角色：Staff 工程师，平台组 - 当前项目：从 K8s 迁移到 Nomad