Back to Openclaw

Bootstrap Extra Files Hook

src/hooks/bundled/bootstrap-extra-files/HOOK.md

2026.5.5975 B
Original Source

Bootstrap Extra Files Hook

Loads additional bootstrap files into Project Context during agent:bootstrap.

Why

Use this when your workspace has multiple context roots (for example monorepos) and you want to include extra AGENTS.md/TOOLS.md-class files without changing the workspace root.

Configuration

json
{
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "bootstrap-extra-files": {
          "enabled": true,
          "paths": ["packages/*/AGENTS.md", "packages/*/TOOLS.md"]
        }
      }
    }
  }
}

Options

  • paths (string[]): preferred list of glob/path patterns.
  • patterns (string[]): alias of paths.
  • files (string[]): alias of paths.

All paths are resolved from the workspace and must stay inside it (including realpath checks). Only recognized bootstrap basenames are loaded (AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md, MEMORY.md).