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

# hooks

# `openclaw hooks`

Hantera agent-hooks (händelsedrivna automatiseringar för kommandon som `/new`, `/reset` och gateway-start).

Relaterat:

* Krokar: [Krokar](/automation/hooks)
* Plugin-hooks: [Plugins](/tools/plugin#plugin-hooks)

## Lista alla hooks

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks list
```

Lista alla upptäckta hooks från arbetsytans, hanterade och paketerade kataloger.

**Alternativ:**

* `--eligible`: Visa endast behöriga hooks (krav uppfyllda)
* `--json`: Utdata som JSON
* `-v, --verbose`: Visa detaljerad information inklusive saknade krav

**Exempelutdata:**

```
Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new command is issued
  😈 soul-evil ✓ - Swap injected SOUL content during a purge window or by random chance
```

**Exempel (utförlig):**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks list --verbose
```

Visar saknade krav för obehöriga hooks.

**Exempel (JSON):**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks list --json
```

Returnerar strukturerad JSON för programmatisk användning.

## Hämta hook-information

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks info <name>
```

Visa detaljerad information om en specifik hook.

**Argument:**

* `<name>`: Kroknamn (t.ex., `session-memory`)

**Alternativ:**

* `--json`: Utdata som JSON

**Exempel:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks info session-memory
```

**Utdata:**

```
💾 session-memory ✓ Ready

Save session context to memory when /new command is issued

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/hooks#session-memory
  Events: command:new

Requirements:
  Config: ✓ workspace.dir
```

## Kontrollera hooks behörighet

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks check
```

Visa en sammanfattning av hooks behörighetsstatus (hur många som är redo jämfört med inte redo).

**Alternativ:**

* `--json`: Utdata som JSON

**Exempelutdata:**

```
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0
```

## Aktivera en hook

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks enable <name>
```

Aktivera en specifik hook genom att lägga till den i din konfig (`~/.openclaw/config.json`).

**Observera:** Krokar som hanteras av plugins visar `plugin:<id>` i `openclaw hooks list` och
kan inte aktiveras/inaktiveras här. Aktivera/inaktivera plugin istället.

**Argument:**

* `<name>`: Kroknamn (t.ex., `session-memory`)

**Exempel:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks enable session-memory
```

**Utdata:**

```
✓ Enabled hook: 💾 session-memory
```

**Vad den gör:**

* Kontrollerar om hooken finns och är behörig
* Uppdaterar `hooks.internal.entries.<name>.enabled = true` i din konfiguration
* Sparar konfig till disk

**Efter aktivering:**

* Starta om gateway (nätverksgateway) så att hooks laddas om (starta om menyradsappen på macOS, eller starta om din gateway-process i utveckling).

## Inaktivera en hook

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks disable <name>
```

Inaktivera en specifik hook genom att uppdatera din konfig.

**Argument:**

* `<name>`: Kroknamn (t.ex., `command-logger`)

**Exempel:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks disable command-logger
```

**Utdata:**

```
⏸ Disabled hook: 📝 command-logger
```

**Efter inaktivering:**

* Starta om gateway (nätverksgateway) så att hooks laddas om

## Installera hooks

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks install <path-or-spec>
```

Installera ett hook-paket från en lokal mapp/arkiv eller npm.

Npm-specifikationer är **endast för registry** (paketnamn + valfri version/tagg). Git/URL/file
specifikationer avvisas. Beroendeinstallationer körs med `--ignore-scripts` av säkerhetsskäl.

**Vad den gör:**

* Kopierar hook-paketet till `~/.openclaw/hooks/<id>`
* Aktiverar de installerade hooks i `hooks.internal.entries.*`
* Registrerar installationen under `hooks.internal.installs`

**Alternativ:**

* `-l, --link`: Länka en lokal katalog i stället för att kopiera (lägger till den i `hooks.internal.load.extraDirs`)

**Exempel:**

**Exempel:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Local directory
openclaw hooks install ./my-hook-pack

# Local archive
openclaw hooks install ./my-hook-pack.zip

# NPM package
openclaw hooks install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw hooks install -l ./my-hook-pack
```

## Uppdatera hooks

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks update <id>
openclaw hooks update --all
```

**Alternativ:**

**Alternativ:**

* `--all`: Uppdatera alla spårade hook-paket
* `--dry-run`: Visa vad som skulle ändras utan att skriva

## Medföljande hooks

### session-memory

**Aktivera:**

**Aktivera:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks enable session-memory
```

**Se:** [session-memory-dokumentation](/automation/hooks#session-memory)

**Se:** [session-memory-dokumentation](/automation/hooks#session-memory)

### bootstrap-extra-files

**Aktivera:**

**Aktivera:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks aktiverar bootstrap-extra-files
```

**Visa loggar:**

### command-logger

**Se:** [command-logger-dokumentation](/automation/hooks#command-logger)

**Aktivera:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks enable command-logger
```

**Aktivera:**

**Visa loggar:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Recent commands
tail -n 20 ~/.openclaw/logs/commands.log

# Pretty-print
cat ~/.openclaw/logs/commands.log | jq .

# Filter by action
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
```

**Se:** [command-logger-dokumentation](/automation/hooks#command-logger)

### boot-md

**Händelser**: `gateway:startup`

**Aktivera**:

**Aktivera**:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw hooks enable boot-md
```

**Se:** [boot-md-dokumentation](/automation/hooks#boot-md)