openclaw hooks

Quản lý agent hooks (tự động hóa theo sự kiện cho các lệnh như /new, /reset, và khởi động gateway).

Liên quan:

Liệt kê tất cả Hooks

openclaw hooks list

Liệt kê tất cả hooks được phát hiện từ workspace, thư mục quản lý và thư mục tích hợp sẵn.

Tùy chọn:

  • --eligible: Chỉ hiển thị hooks đủ điều kiện (đáp ứng yêu cầu)
  • --json: Xuất dưới dạng JSON
  • -v, --verbose: Hiển thị thông tin chi tiết bao gồm các yêu cầu còn thiếu

Ví dụ kết quả:

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

Ví dụ (verbose):

openclaw hooks list --verbose

Hiển thị các yêu cầu còn thiếu cho hooks chưa đủ điều kiện.

Ví dụ (JSON):

openclaw hooks list --json

Trả về JSON có cấu trúc để sử dụng theo chương trình.

Xem thông tin Hook

openclaw hooks info <name>

Hiển thị thông tin chi tiết về một hook cụ thể.

Tham số:

  • <name>: Tên hook (ví dụ: session-memory)

Tùy chọn:

  • --json: Xuất dưới dạng JSON

Ví dụ:

openclaw hooks info session-memory

Kết quả:

💾 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

Kiểm tra tính đủ điều kiện của Hooks

openclaw hooks check

Hiển thị tóm tắt trạng thái đủ điều kiện của hooks (bao nhiêu đã sẵn sàng so với chưa sẵn sàng).

Tùy chọn:

  • --json: Xuất dưới dạng JSON

Ví dụ kết quả:

Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

Bật một Hook

openclaw hooks enable <name>

Bật một hook cụ thể bằng cách thêm nó vào config của bạn (~/.openclaw/config.json).

Lưu ý: Hooks được quản lý bởi plugins sẽ hiển thị plugin:<id> trong openclaw hooks list và không thể bật/tắt ở đây. Thay vào đó, hãy bật/tắt plugin.

Tham số:

  • <name>: Tên hook (ví dụ: session-memory)

Ví dụ:

openclaw hooks enable session-memory

Kết quả:

✓ Enabled hook: 💾 session-memory

Lệnh này làm gì:

  • Kiểm tra xem hook có tồn tại và đủ điều kiện không
  • Cập nhật hooks.internal.entries.<name>.enabled = true trong config của bạn
  • Lưu config vào đĩa

Sau khi bật:

  • Khởi động lại gateway để hooks được tải lại (khởi động lại ứng dụng menu bar trên macOS, hoặc khởi động lại tiến trình gateway trong môi trường dev).

Tắt một Hook

openclaw hooks disable <name>

Tắt một hook cụ thể bằng cách cập nhật config của bạn.

Tham số:

  • <name>: Tên hook (ví dụ: command-logger)

Ví dụ:

openclaw hooks disable command-logger

Kết quả:

⏸ Disabled hook: 📝 command-logger

Sau khi tắt:

  • Khởi động lại gateway để hooks được tải lại

Cài đặt Hooks

openclaw hooks install <path-or-spec>

Cài đặt một hook pack từ thư mục/archive cục bộ hoặc npm.

Lệnh này làm gì:

  • Sao chép hook pack vào ~/.openclaw/hooks/<id>
  • Bật các hooks đã cài đặt trong hooks.internal.entries.*
  • Ghi lại việc cài đặt trong hooks.internal.installs

Tùy chọn:

  • -l, --link: Liên kết một thư mục cục bộ thay vì sao chép (thêm nó vào hooks.internal.load.extraDirs)

Các định dạng archive được hỗ trợ: .zip, .tgz, .tar.gz, .tar

Ví dụ:

# Thư mục cục bộ
openclaw hooks install ./my-hook-pack

# Archive cục bộ
openclaw hooks install ./my-hook-pack.zip

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

# Liên kết một thư mục cục bộ mà không sao chép
openclaw hooks install -l ./my-hook-pack

Cập nhật Hooks

openclaw hooks update <id>
openclaw hooks update --all

Cập nhật các hook packs đã cài đặt (chỉ các cài đặt từ npm).

Tùy chọn:

  • --all: Cập nhật tất cả hook packs được theo dõi
  • --dry-run: Hiển thị những gì sẽ thay đổi mà không ghi

Hooks tích hợp sẵn

session-memory

Lưu ngữ cảnh session vào bộ nhớ khi bạn thực hiện lệnh /new.

Bật:

openclaw hooks enable session-memory

Kết quả: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md

Xem thêm: Tài liệu session-memory

command-logger

Ghi lại tất cả các sự kiện lệnh vào một file audit tập trung.

Bật:

openclaw hooks enable command-logger

Kết quả: ~/.openclaw/logs/commands.log

Xem logs:

# Các lệnh gần đây
tail -n 20 ~/.openclaw/logs/commands.log

# In đẹp
cat ~/.openclaw/logs/commands.log | jq .

# Lọc theo action
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .

Xem thêm: Tài liệu command-logger

soul-evil

Hoán đổi nội dung SOUL.md được inject với SOUL_EVIL.md trong cửa sổ purge hoặc theo ngẫu nhiên.

Bật:

openclaw hooks enable soul-evil

Xem thêm: SOUL Evil Hook

boot-md

Chạy BOOT.md khi gateway khởi động (sau khi các channels khởi động).

Events: gateway:startup

Bật:

openclaw hooks enable boot-md

Xem thêm: Tài liệu boot-md