SOUL、USER、HEARTBEAT 怎么写:OpenClaw 配置文件字段参考
先确认边界
本文教的是 OpenClaw 与公开信息整理方法,不提供投资建议,不承诺收益,也不要求你连接钱包或给 AI 交易权限。所有结论都应回到官方来源、原始页面和你自己的风险承受能力重新核对。

核对操作细节时,可同时打开这些官方入口:OpenClaw Getting Started · OpenClaw Tools · OpenClaw CLI · OpenClaw Agent Runtime · OpenClaw FAQ · OpenClaw Docs Hubs

三类文件分别负责什么

文件回答的问题不要写什么
SOUL.md这个 Agent 的职责、边界、禁区私人密钥、API Key、临时情绪
USER.md你的关注范围、语言、时区、偏好会频繁变化的调度规则
HEARTBEAT.md什么时候运行、运行哪些任务、失败如何处理投资结论和主观预测

SOUL.md:先写红线,再写任务

SOUL 是 Agent 的“性格和法律”。普通用户最重要的不是让 AI 更会说,而是让 AI 知道不能做什么。建议把红线放在文件开头,并使用清晰的禁止句。

你是ChainSentry的只读信息整理 Agent。
禁止:输出买卖建议、仓位建议、收益承诺、保证安全结论。
禁止:要求用户提供助记词、验证码、远程控制、交易权限 API Key。
必须:每条关键结论附来源、时间、人工复核提示。

USER.md:把个人偏好写成字段

USER 不是日记,而是偏好表。建议写关注资产、语言、推送时间、风险关键词、忽略列表和输出长度。这样你后续调整时,不需要改 SOUL 的底层边界。

HEARTBEAT.md:少频率、多复核

新手常以为频率越高越好,实际更容易制造焦虑和误报。每日简报可以一天一次;公告监控可以 30 到 60 分钟一次;链上大额转账如果没有明确用途,先别高频推送。

推荐字段表

字段建议写法检查点
sources列官方公告、行情 API、链上浏览器是否能打开原文
output_format固定为概览、异常、待复核、禁止结论是否减少废话
red_lines禁止收益承诺和交易指令是否放在前 20 行
failure_policy接口失败时输出“数据缺失”是否避免编造

配置也要有版本

每次修改配置,都在文件末尾写一行更新记录:日期、改动、原因、观察结果。SEO 内容和 AI 工具一样,真正有价值的是长期迭代,而不是一次写完就不管。

常见问题

可以把所有规则写进一个文件吗?

可以,但后期会难维护。把边界、偏好和调度分开,更容易定位问题。

配置越长越好吗?

不是。关键红线要短而明确,示例要贴近你的真实场景,避免堆很多模糊口号。

改配置前怎么避免破坏旧规则?

先复制当前版本并写明修改目的,每次只改一个变量,例如来源、推送频率或输出格式。改完用三类输入测试:正常数据、缺失数据和互相矛盾的数据。正常数据要附来源,缺失数据要明确说缺失,矛盾数据要暂停给结论。三类结果都符合预期后再替换原配置;如果效果变差,直接恢复上一版,而不是继续叠加新规则。

最后更新:2026-06-01。本文为ChainSentry原创教程,非 Binance 或 OpenClaw 官方文档。