> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaude.app/llms.txt
> Use this file to discover all available pages before exploring further.

# SOUL Evil 钩子

> SOUL Evil 钩子 文档

SOUL Evil 钩子在清除窗口期间或随机概率下，将**注入的** `SOUL.md` 内容替换为 `SOUL_EVIL.md`。它**不会**修改磁盘上的文件。

## 工作原理

当 `agent:bootstrap` 运行时，该钩子可以在系统提示词组装之前，在内存中替换 `SOUL.md` 的内容。如果 `SOUL_EVIL.md` 缺失或为空，OpenClaw 会记录警告并保留正常的 `SOUL.md`。

子智能体运行**不会**在其引导文件中包含 `SOUL.md`，因此此钩子对子智能体没有影响。

## 启用

```bash theme={null} theme={null}
openclaw hooks enable soul-evil
```

然后设置配置：

```json theme={null} theme={null}
{
  "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` 不在引导列表中，该钩子不执行任何操作。

## 另请参阅

* [钩子](/automation/hooks)