1. 为什么你的 OpenClaw 总是“差点意思”很多人第一次跑 OpenClaw社区里也叫 Moltbot、Clawdbot时都会经历同一个心理曲线装完那一刻很兴奋聊两句觉得还行用三天之后开始觉得“它好像不太懂我”。回复不算错但就是隔着一层你昨天刚说过的项目背景今天它又问一遍你让它盯着某个指标它要么一声不吭要么在你开会时疯狂弹消息。问题基本不在模型而在架构。OpenClaw 的行为根基是磁盘上的三个 Markdown 文件SOUL.md、USER.md、MEMORY.md再加上两个调度系统 Heartbeat心跳和 Cron定时。这五个部件决定了代理“怎么想、为谁想、记得什么、什么时候自己动”。只改其中一个就像给汽车换了轮胎却没调方向盘能开但一直跑偏。这篇面向想真正把 OpenClaw 落地配置起来的开发者。我会先讲清 SOUL、USER、MEMORY 三层结构各自负责什么、边界在哪再给出可以直接复制的config.toml骨架和settings.json片段最后用具体命令验证主动机制是否触发、记忆读写是否生效。如果你之前只是把默认文件跑起来就用这篇能帮你把“能用”推到“好用”。2. 三层结构SOUL 管表达USER 管背景MEMORY 管沉淀2.1 SOUL.md 决定代理的思考与表达方式SOUL.md 是代理每次会话开始时读取的第一份文件它定义语气、回复优先级、行为边界。默认版本是工程师写的通用模板能跑但不会贴合你的工作习惯。它分两半前半部分写沟通偏好比如开场方式、给结论还是先铺垫、遇到不确定时是标注不确定性还是先给最佳猜测后半部分写操作边界也就是代理在外部内容转发的邮件、共享文档里遇到指令时该怎么办、执行影响对话之外系统的操作前需要多大确认。负面约束和正面指令一样重要。不想要客套话就明确写“不要用排比句、不要用‘首先其次最后’”。这些禁令消除的是那种说不清哪里别扭、但会慢慢让你放弃工具的摩擦。2.2 USER.md 决定代理为谁工作USER.md 回答“我在为谁工作”。只填名字、时区和一行职位是不够的。要写你正在推进的项目、组织里的关键人物、你和他们的关系、你的优先级、当前卡住你的东西。细节越多代理越能在不重复提问的情况下结合背景给建议。它也是失效最快的文件优先级每周甚至每天都在变。建议每晚花五分钟微调这是对这份文件杠杆率最高的维护习惯。SOUL 定义沟通方式USER 定义沟通背景USER 没配好SOUL 基本是摆设。2.3 MEMORY.md 决定长期沉淀什么OpenClaw 的持久记忆默认关闭需要显式开启。它分两层第一层是按日期整理的每日日志记录每次会话发生了什么、做了什么决策第二层是 MEMORY.md 本身作为精选长期存储放长期重要的决策、持续的项目背景以及对你纠正过的错误的记录。关键取舍是不要记录一切。全量记录会让每次会话加载上下文时消耗更多 Token杂音还会淹没相关信息响应质量反而下降。可行做法是让代理建立重要性评分只把超过阈值的写进长期层。另一个习惯是当你觉得某件事值得记直接说“把这个记进 memory.md”五秒钟省掉无数次重复解释。2.4 Heartbeat 与 Cron 决定代理何时自己动这两个系统让代理从被动工具变成后台协作伙伴。Heartbeat 是固定间隔自主醒来检查你让它监控的任务清单判断是否值得通过消息平台联系你。Cron 处理需要精确时间点的任务比如每周一早上汇总。区别在于Heartbeat 是周期性意识检查Cron 是特定时间点触发不要在该用心跳的地方用 Cron。心跳指令的价值依赖核心文件。“检查紧急邮件”只有在 USER.md 里定义了什么叫“紧急”时才有意义“提醒日程事件”只有在 SOUL.md 定义了提前多久、用什么格式提醒时才成立。间隔太短、清单太长代理就变成通知机器所以目标是精简清单加匹配你工作节奏的间隔。3. 可复制的 config.toml 骨架下面这份骨架把三层文件和两个调度系统串起来。字段名按 OpenClaw 常见约定组织实际以你安装版本的文档为准重点是结构关系。# config.toml —— OpenClaw 核心配置骨架 [agent] name claw workspace /opt/openclaw/workspace # 三层 Markdown 文件路径代理启动时按顺序加载 [agent.files] soul /opt/openclaw/workspace/SOUL.md user /opt/openclaw/workspace/USER.md memory /opt/openclaw/workspace/MEMORY.md [memory] enabled true # 持久记忆默认关闭必须显式开启 daily_log_dir /opt/openclaw/workspace/memory/daily long_term_file /opt/openclaw/workspace/MEMORY.md importance_threshold 0.6 # 低于该分数只进每日日志不进长期层 max_context_tokens 4000 # 每次会话注入记忆的 token 上限 [heartbeat] enabled true interval 3h # 心跳间隔按你的工作节奏调整 quiet_hours [23:00, 08:00] # 静默时段避免半夜打扰 tasks [ 检查收件箱中标记为紧急的邮件, 查看项目看板是否有阻塞项超过 24 小时, ] [cron] enabled true [[cron.jobs]] name weekly-digest schedule 0 9 * * 1 # 每周一 09:00 prompt 汇总上周 MEMORY.md 中新增的决策输出三条要点 [[cron.jobs]] name daily-standup schedule 30 8 * * 1-5 # 工作日 08:30 prompt 根据 USER.md 中的当前项目生成今日待办草稿几个容易踩的点importance_threshold设太低会让长期记忆膨胀设太高会漏掉重要背景0.5 到 0.7 之间比较稳max_context_tokens要和模型上下文窗口匹配别把窗口全喂给记忆quiet_hours一定要配否则心跳会在你睡觉时发消息。4. settings.json 配置片段与主动机制参数settings.json负责运行时行为和config.toml的分工是前者管调度与记忆策略后者管模型接入与请求参数。下面这段可以直接作为起点。{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, model: claude-sonnet-4-5, api_key_env: TAOTOKEN_API_KEY, max_tokens: 4096, temperature: 0.7 }, memory: { write_mode: scored, score_model: claude-haiku-4-5, dedupe: true, daily_retention_days: 30 }, heartbeat: { notify_channel: telegram, min_interval_between_notifications: 45m, escalate_after: 3 }, cron: { timezone: Asia/Shanghai, catch_up_missed: true } }write_mode设为scored时代理会先用一个便宜的小模型给每条候选记忆打分再决定是否写入长期层这就是前面说的重要性评分落地方式。min_interval_between_notifications是心跳的节流阀防止短时间内连续打扰。catch_up_missed让 Cron 在服务重启后补跑错过的任务对长期运行的代理很实用。模型接入这里用的是 OpenAI 兼容协议base_url指向https://taotoken.net/apiAPI Key 通过环境变量注入不要硬编码进文件export TAOTOKEN_API_KEYsk-你的密钥密钥在控制台的 API Keys 页面创建接入细节看接入文档。5. 验证主动机制触发与记忆读写配置写完不算完要验证三件事记忆是否真的写入、心跳是否按间隔触发、Cron 是否在正确时间点执行。先验证记忆写入。手动触发一次会话明确要求记录openclaw chat --message 把这个记进 memory.md项目 X 的截止日期改到 3 月 20 日然后检查长期记忆文件是否新增条目grep -n 3 月 20 日 /opt/openclaw/workspace/MEMORY.md tail -n 20 /opt/openclaw/workspace/memory/daily/$(date %F).md如果长期文件没有、每日日志有说明分数没过阈值可以临时把importance_threshold调到 0.4 再试一次确认链路通了再调回去。再验证心跳。把间隔临时改成 1 分钟观察日志openclaw heartbeat --status openclaw logs --follow --component heartbeat正常输出会显示每次唤醒的时间戳、检查的任务数、是否触发通知。如果只唤醒不通知检查quiet_hours是否覆盖了当前时间以及任务描述是否足够具体到能判定“值得联系”。最后验证 Cronopenclaw cron list openclaw cron run weekly-digest --dry-run--dry-run会立即执行一次但不发送通知用来确认 prompt 和输出格式符合预期。确认无误后等真实时间点触发即可。6. 常见报错与排查记忆不写入先确认config.toml里memory.enabled true默认是关闭的。再看daily_log_dir目录是否存在且可写权限不对会静默失败。如果每日日志有、长期文件没有就是阈值问题。心跳不触发检查heartbeat.enabled和interval格式3h合法3不合法。再看quiet_hours是否把当前时间整个盖住了。日志里如果显示唤醒但任务列表为空说明tasks数组没被正确解析。Cron 时间不对settings.json里的timezone必须显式设置不设会跟随系统时区容器里通常是 UTC导致你以为的早上九点实际是下午五点。模型请求 401api_key_env指向的环境变量没导出或者导出在了另一个 shell 会话里。用echo $TAOTOKEN_API_KEY确认当前会话能读到。回复风格不对回到 SOUL.md检查负面约束是否写清楚。语气问题几乎都能在 SOUL 前半部分找到答案不要试图在 settings.json 里调 temperature 解决。7. 把配置跑通之后三层文件加两个调度系统本质是把“代理知道什么、为谁工作、记得什么、何时行动”拆成可独立维护的部件。SOUL 和 USER 要对齐MEMORY 要跟着优先级更新Heartbeat 的监控清单要匹配你真实的工作节奏。局部配置效果差通常不是缺文件而是文件之间不匹配。验证环节别省。记忆写入、心跳触发、Cron 执行这三条链路各自跑通一次后面出问题你才知道该看哪个日志。密钥和接入参数统一走环境变量模型对话可以在模型对话页面直接试长期跑编码和 Agent 任务可以看 Coding Plan密钥管理在 API Keys接入细节查接入文档。把配置骨架复制过去改掉路径和阈值先跑通再优化。