フック

# 利用可能な Hook を一覧表示
openclaw hooks list

# Hook を有効化
openclaw hooks enable session-memory

# Hook の状態を確認
openclaw hooks check

# 詳細情報を取得
openclaw hooks info session-memory

my-hook/
├── HOOK.md          # メタデータ + ドキュメント
└── handler.ts       # ハンドラー実装

---
name: my-hook
description: "この Hook の動作に関する短い説明"
metadata:
  { "openclaw": { "emoji": "🔗", "events": ["command:new"], "requires": { "bins": ["node"] } } }
---

# My Hook

詳細なドキュメントをここに記載します。

const handler = async (event) => {
  if (event.type !== "command" || event.action !== "new") {
    return;
  }

  console.log(`[my-hook] 新しいコマンドがトリガーされました`);
  // ここにロジックを記述

  // 返信可能なサーフェスでは、必要に応じて返信を送信
  event.messages.push("Hook が実行されました！");
};

export default handler;

import { execFile } from "node:child_process";
import { promisify } from "node:util";

const execFileAsync = promisify(execFile);

export default async function handler(event) {
  if (event.type !== "gateway" || event.action !== "pre-restart") {
    return;
  }

  const restartInSeconds = Math.ceil(event.context.restartExpectedMs / 1000);
  await execFileAsync("openclaw", [
    "system",
    "event",
    "--mode",
    "now",
    "--text",
    `Gateway は約${restartInSeconds}秒後に再起動します（${event.context.reason}）。今すぐチェックポイントを作成してください。`,
  ]);
}

openclaw plugins install <path-or-spec>

openclaw hooks enable <hook-name>

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

{
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": { "enabled": true },
        "command-logger": { "enabled": false }
      }
    }
  }
}

{
  "hooks": {
    "internal": {
      "entries": {
        "my-hook": {
          "enabled": true,
          "env": { "MY_CUSTOM_VAR": "value" }
        }
      }
    }
  }
}

{
  "hooks": {
    "internal": {
      "load": {
        "extraDirs": ["/path/to/more/hooks"]
      }
    }
  }
}

# すべてのフックを一覧表示（--eligible、--verbose、または --json を追加可能）
openclaw hooks list

# フックの詳細情報を表示
openclaw hooks info <hook-name>

# 適格性の概要を表示
openclaw hooks check

# 有効化／無効化
openclaw hooks enable <hook-name>
openclaw hooks disable <hook-name>

# ディレクトリ構造を確認
ls -la ~/.openclaw/hooks/my-hook/
# 次のファイルが表示される必要があります: HOOK.md、handler.ts

# 検出されたすべてのフックを一覧表示
openclaw hooks list

openclaw hooks info my-hook