# hooks

# `openclaw hooks`

Manage event-driven automations for gateway commands and startup events.

## Core Commands

**Listing and Information:**
- `openclaw hooks list` displays all discovered hooks with readiness status
- `openclaw hooks info <name>` provides detailed information about specific hooks
- `openclaw hooks check` shows overall eligibility summary

**Management:**
- `openclaw hooks enable <name>` activates a hook in your config
- `openclaw hooks disable <name>` deactivates a hook
- `openclaw hooks install <path-or-spec>` adds new hook packs from local directories, archives, or npm
- `openclaw hooks update <id>` refreshes installed npm-based hook packs

## Available Bundled Hooks

The system includes four pre-built hooks:

1. **session-memory** - Saves session context when `/new` command executes, storing output to `~/.openclaw/workspace/memory/`

2. **command-logger** - Records all command events to a centralized audit file at `~/.openclaw/logs/commands.log`

3. **soul-evil** - Swaps `SOUL.md` content with `SOUL_EVIL.md` during specified windows or randomly

4. **boot-md** - Executes `BOOT.md` upon gateway startup (triggered by `gateway:startup` event)

## Important Notes

After enabling or disabling hooks, restart your gateway for changes to take effect. Plugin-managed hooks cannot be toggled directly through these commands - manage the parent plugin instead.