@captain-app/openclaw 2026.2.4

package/dist/help-format-CEsRHU2f.js

@@ -0,0 +1,17 @@
+import { R as theme } from "./subsystem-CAq3uyo7.js";
+
+//#region src/cli/help-format.ts
+function formatHelpExample(command, description) {
+	return `  ${theme.command(command)}\n    ${theme.muted(description)}`;
+}
+function formatHelpExampleLine(command, description) {
+	if (!description) return `  ${theme.command(command)}`;
+	return `  ${theme.command(command)} ${theme.muted(`# ${description}`)}`;
+}
+function formatHelpExamples(examples, inline = false) {
+	const formatter = inline ? formatHelpExampleLine : formatHelpExample;
+	return examples.map(([command, description]) => formatter(command, description)).join("\n");
+}
+
+//#endregion
+export { formatHelpExamples as t };

package/dist/help-format-GuCWws6r.js

@@ -0,0 +1,17 @@
+import { k as theme } from "./entry.js";
+
+//#region src/cli/help-format.ts
+function formatHelpExample(command, description) {
+	return `  ${theme.command(command)}\n    ${theme.muted(description)}`;
+}
+function formatHelpExampleLine(command, description) {
+	if (!description) return `  ${theme.command(command)}`;
+	return `  ${theme.command(command)} ${theme.muted(`# ${description}`)}`;
+}
+function formatHelpExamples(examples, inline = false) {
+	const formatter = inline ? formatHelpExampleLine : formatHelpExample;
+	return examples.map(([command, description]) => formatter(command, description)).join("\n");
+}
+
+//#endregion
+export { formatHelpExamples as t };

package/dist/helpers-BEJ-phFf.js

@@ -0,0 +1,25 @@
+//#region src/cli/program/helpers.ts
+function collectOption(value, previous = []) {
+	return [...previous, value];
+}
+function parsePositiveIntOrUndefined(value) {
+	if (value === void 0 || value === null || value === "") return;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) return;
+		const parsed = Math.trunc(value);
+		return parsed > 0 ? parsed : void 0;
+	}
+	if (typeof value === "string") {
+		const parsed = Number.parseInt(value, 10);
+		if (Number.isNaN(parsed) || parsed <= 0) return;
+		return parsed;
+	}
+}
+function resolveActionArgs(actionCommand) {
+	if (!actionCommand) return [];
+	const args = actionCommand.args;
+	return Array.isArray(args) ? args : [];
+}
+
+//#endregion
+export { parsePositiveIntOrUndefined as n, resolveActionArgs as r, collectOption as t };

package/dist/helpers-BtbBZVKZ.js

@@ -0,0 +1,10 @@
+import { E as DEFAULT_ACCOUNT_ID } from "./agent-scope-BbT4OG2N.js";
+
+//#region src/channels/plugins/helpers.ts
+function resolveChannelDefaultAccountId(params) {
+	const accountIds = params.accountIds ?? params.plugin.config.listAccountIds(params.cfg);
+	return params.plugin.config.defaultAccountId?.(params.cfg) ?? accountIds[0] ?? DEFAULT_ACCOUNT_ID;
+}
+
+//#endregion
+export { resolveChannelDefaultAccountId as t };

package/dist/helpers-C12w9zxf.js

@@ -0,0 +1,10 @@
+import { E as DEFAULT_ACCOUNT_ID } from "./agent-scope-C_O6Vpl0.js";
+
+//#region src/channels/plugins/helpers.ts
+function resolveChannelDefaultAccountId(params) {
+	const accountIds = params.accountIds ?? params.plugin.config.listAccountIds(params.cfg);
+	return params.plugin.config.defaultAccountId?.(params.cfg) ?? accountIds[0] ?? DEFAULT_ACCOUNT_ID;
+}
+
+//#endregion
+export { resolveChannelDefaultAccountId as t };

package/dist/helpers-CzjGJZmJ.js

@@ -0,0 +1,25 @@
+//#region src/cli/program/helpers.ts
+function collectOption(value, previous = []) {
+	return [...previous, value];
+}
+function parsePositiveIntOrUndefined(value) {
+	if (value === void 0 || value === null || value === "") return;
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) return;
+		const parsed = Math.trunc(value);
+		return parsed > 0 ? parsed : void 0;
+	}
+	if (typeof value === "string") {
+		const parsed = Number.parseInt(value, 10);
+		if (Number.isNaN(parsed) || parsed <= 0) return;
+		return parsed;
+	}
+}
+function resolveActionArgs(actionCommand) {
+	if (!actionCommand) return [];
+	const args = actionCommand.args;
+	return Array.isArray(args) ? args : [];
+}
+
+//#endregion
+export { parsePositiveIntOrUndefined as n, resolveActionArgs as r, collectOption as t };

package/dist/hooks/bundled/boot-md/HOOK.md

@@ -0,0 +1,19 @@
+---
+name: boot-md
+description: "Run BOOT.md on gateway startup"
+homepage: https://docs.openclaw.ai/hooks#boot-md
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🚀",
+        "events": ["gateway:startup"],
+        "requires": { "config": ["workspace.dir"] },
+        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with OpenClaw" }],
+      },
+  }
+---
+
+# Boot Checklist Hook
+
+Runs `BOOT.md` every time the gateway starts, if the file exists in the workspace.

package/dist/hooks/bundled/command-logger/HOOK.md

@@ -0,0 +1,122 @@
+---
+name: command-logger
+description: "Log all command events to a centralized audit file"
+homepage: https://docs.openclaw.ai/hooks#command-logger
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📝",
+        "events": ["command"],
+        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with OpenClaw" }],
+      },
+  }
+---
+
+# Command Logger Hook
+
+Logs all command events (`/new`, `/reset`, `/stop`, etc.) to a centralized audit log file for debugging and monitoring purposes.
+
+## What It Does
+
+Every time you issue a command to the agent:
+
+1. **Captures event details** - Command action, timestamp, session key, sender ID, source
+2. **Appends to log file** - Writes a JSON line to `~/.openclaw/logs/commands.log`
+3. **Silent operation** - Runs in the background without user notifications
+
+## Output Format
+
+Log entries are written in JSONL (JSON Lines) format:
+
+```json
+{"timestamp":"2026-01-16T14:30:00.000Z","action":"new","sessionKey":"agent:main:main","senderId":"+1234567890","source":"telegram"}
+{"timestamp":"2026-01-16T15:45:22.000Z","action":"stop","sessionKey":"agent:main:main","senderId":"user@example.com","source":"whatsapp"}
+```
+
+## Use Cases
+
+- **Debugging**: Track when commands were issued and from which source
+- **Auditing**: Monitor command usage across different channels
+- **Analytics**: Analyze command patterns and frequency
+- **Troubleshooting**: Investigate issues by reviewing command history
+
+## Log File Location
+
+`~/.openclaw/logs/commands.log`
+
+## Requirements
+
+No requirements - this hook works out of the box on all platforms.
+
+## Configuration
+
+No configuration needed. The hook automatically:
+
+- Creates the log directory if it doesn't exist
+- Appends to the log file (doesn't overwrite)
+- Handles errors silently without disrupting command execution
+
+## Disabling
+
+To disable this hook:
+
+```bash
+openclaw hooks disable command-logger
+```
+
+Or via config:
+
+```json
+{
+  "hooks": {
+    "internal": {
+      "entries": {
+        "command-logger": { "enabled": false }
+      }
+    }
+  }
+}
+```
+
+## Log Rotation
+
+The hook does not automatically rotate logs. To manage log size, you can:
+
+1. **Manual rotation**:
+
+   ```bash
+   mv ~/.openclaw/logs/commands.log ~/.openclaw/logs/commands.log.old
+   ```
+
+2. **Use logrotate** (Linux):
+   Create `/etc/logrotate.d/openclaw`:
+   ```
+   /home/username/.openclaw/logs/commands.log {
+       weekly
+       rotate 4
+       compress
+       missingok
+       notifempty
+   }
+   ```
+
+## Viewing Logs
+
+View recent commands:
+
+```bash
+tail -n 20 ~/.openclaw/logs/commands.log
+```
+
+Pretty-print with jq:
+
+```bash
+cat ~/.openclaw/logs/commands.log | jq .
+```
+
+Filter by action:
+
+```bash
+grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
+```

package/dist/hooks/bundled/session-memory/HOOK.md

@@ -0,0 +1,109 @@
+---
+name: session-memory
+description: "Save session context to memory when /new command is issued"
+homepage: https://docs.openclaw.ai/hooks#session-memory
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "💾",
+        "events": ["command:new"],
+        "requires": { "config": ["workspace.dir"] },
+        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with OpenClaw" }],
+      },
+  }
+---
+
+# Session Memory Hook
+
+Automatically saves session context to your workspace memory when you issue the `/new` command.
+
+## What It Does
+
+When you run `/new` to start a fresh session:
+
+1. **Finds the previous session** - Uses the pre-reset session entry to locate the correct transcript
+2. **Extracts conversation** - Reads the last N user/assistant messages from the session (default: 15, configurable)
+3. **Generates descriptive slug** - Uses LLM to create a meaningful filename slug based on conversation content
+4. **Saves to memory** - Creates a new file at `<workspace>/memory/YYYY-MM-DD-slug.md`
+5. **Sends confirmation** - Notifies you with the file path
+
+## Output Format
+
+Memory files are created with the following format:
+
+```markdown
+# Session: 2026-01-16 14:30:00 UTC
+
+- **Session Key**: agent:main:main
+- **Session ID**: abc123def456
+- **Source**: telegram
+```
+
+## Filename Examples
+
+The LLM generates descriptive slugs based on your conversation:
+
+- `2026-01-16-vendor-pitch.md` - Discussion about vendor evaluation
+- `2026-01-16-api-design.md` - API architecture planning
+- `2026-01-16-bug-fix.md` - Debugging session
+- `2026-01-16-1430.md` - Fallback timestamp if slug generation fails
+
+## Requirements
+
+- **Config**: `workspace.dir` must be set (automatically configured during onboarding)
+
+The hook uses your configured LLM provider to generate slugs, so it works with any provider (Anthropic, OpenAI, etc.).
+
+## Configuration
+
+The hook supports optional configuration:
+
+| Option     | Type   | Default | Description                                                     |
+| ---------- | ------ | ------- | --------------------------------------------------------------- |
+| `messages` | number | 15      | Number of user/assistant messages to include in the memory file |
+
+Example configuration:
+
+```json
+{
+  "hooks": {
+    "internal": {
+      "entries": {
+        "session-memory": {
+          "enabled": true,
+          "messages": 25
+        }
+      }
+    }
+  }
+}
+```
+
+The hook automatically:
+
+- Uses your workspace directory (`~/.openclaw/workspace` by default)
+- Uses your configured LLM for slug generation
+- Falls back to timestamp slugs if LLM is unavailable
+
+## Disabling
+
+To disable this hook:
+
+```bash
+openclaw hooks disable session-memory
+```
+
+Or remove it from your config:
+
+```json
+{
+  "hooks": {
+    "internal": {
+      "entries": {
+        "session-memory": { "enabled": false }
+      }
+    }
+  }
+}
+```

package/dist/hooks/bundled/soul-evil/HOOK.md

@@ -0,0 +1,71 @@
+---
+name: soul-evil
+description: "Swap SOUL.md with SOUL_EVIL.md during a purge window or by random chance"
+homepage: https://docs.openclaw.ai/hooks/soul-evil
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "😈",
+        "events": ["agent:bootstrap"],
+        "requires": { "config": ["hooks.internal.entries.soul-evil.enabled"] },
+        "install": [{ "id": "bundled", "kind": "bundled", "label": "Bundled with OpenClaw" }],
+      },
+  }
+---
+
+# SOUL Evil Hook
+
+Replaces the injected `SOUL.md` content with `SOUL_EVIL.md` during a daily purge window or by random chance.
+
+## What It Does
+
+When enabled and the trigger conditions match, the hook swaps the **injected** `SOUL.md` content before the system prompt is built. It does **not** modify files on disk.
+
+## Files
+
+- `SOUL.md` — normal persona (always read)
+- `SOUL_EVIL.md` — alternate persona (read only when triggered)
+
+You can change the filename via hook config.
+
+## Configuration
+
+Add this to your config (`~/.openclaw/openclaw.json`):
+
+```json
+{
+  "hooks": {
+    "internal": {
+      "enabled": true,
+      "entries": {
+        "soul-evil": {
+          "enabled": true,
+          "file": "SOUL_EVIL.md",
+          "chance": 0.1,
+          "purge": { "at": "21:00", "duration": "15m" }
+        }
+      }
+    }
+  }
+}
+```
+
+### Options
+
+- `file` (string): alternate SOUL filename (default: `SOUL_EVIL.md`)
+- `chance` (number 0–1): random chance per run to swap in SOUL_EVIL
+- `purge.at` (HH:mm): daily purge window start time (24h)
+- `purge.duration` (duration): window length (e.g. `30s`, `10m`, `1h`)
+
+**Precedence:** purge window wins over chance.
+
+## Requirements
+
+- `hooks.internal.entries.soul-evil.enabled` must be set to `true`
+
+## Enable
+
+```bash
+openclaw hooks enable soul-evil
+```