SOUL Evil 钩子在清除窗口期间或随机概率下,将注入的 SOUL.md 内容替换为 SOUL_EVIL.md。它不会修改磁盘上的文件。
工作原理
当 agent:bootstrap 运行时,该钩子可以在系统提示词组装之前,在内存中替换 SOUL.md 的内容。如果 SOUL_EVIL.md 缺失或为空,OpenClaw 会记录警告并保留正常的 SOUL.md。
子智能体运行不会在其引导文件中包含 SOUL.md,因此此钩子对子智能体没有影响。
openclaw hooks enable soul-evil
然后设置配置:
{
"hooks": {
"internal": {
"enabled": true,
"entries": {
"soul-evil": {
"enabled": true,
"file": "SOUL_EVIL.md",
"chance": 0.1,
"purge": { "at": "21:00", "duration": "15m" }
}
}
}
}
}
在智能体工作区根目录(SOUL.md 旁边)创建 SOUL_EVIL.md。
file(字符串):替代的 SOUL 文件名(默认:SOUL_EVIL.md)
chance(数字 0–1):每次运行使用 SOUL_EVIL.md 的随机概率
purge.at(HH:mm):每日清除开始时间(24 小时制)
purge.duration(时长):窗口长度(例如 30s、10m、1h)
优先级: 清除窗口优先于随机概率。
时区: 设置了 agents.defaults.userTimezone 时使用该时区;否则使用主机时区。
注意事项
- 不会在磁盘上写入或修改任何文件。
- 如果
SOUL.md 不在引导列表中,该钩子不执行任何操作。
另请参阅
Last modified on February 12, 2026