
核对操作细节时,可同时打开这些官方入口: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 官方文档。