Skip to main content

​
openclaw hooks

Quản lý agent hooks (tự động hóa dựa trên 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

Liệt kê tất cả hooks được phát hiện từ workspace, thư mục quản lý và thư mục đi kèm. Tùy chọn:
  • --eligible: Chỉ hiển thị các 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ụ đầu ra:
Ví dụ (chi tiết):
Hiển thị các yêu cầu còn thiếu cho các hooks không đủ điều kiện. Ví dụ (JSON):
Trả về JSON có cấu trúc để sử dụng trong lập trình.

​
Lấy Thông Tin Hook

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ụ:
Đầu ra:

​
Kiểm Tra Tính Đủ Điều Kiện Của Hooks

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 và không sẵn sàng). Tùy chọn:
  • --json: Xuất dưới dạng JSON
Ví dụ đầu ra:

​
Kích Hoạt Một Hook

Kích hoạt một hook cụ thể bằng cách thêm nó vào cấu hình (~/.openclaw/config.json). Lưu ý: Hooks được quản lý bởi plugins hiển thị plugin:<id> trong openclaw hooks list và không thể kích hoạt/tắt ở đây. Kích hoạt/tắt plugin thay thế. Tham số:
  • <name>: Tên hook (ví dụ: session-memory)
Ví dụ:
Đầu ra:
Những gì nó làm:
  • 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 cấu hình
  • Lưu cấu hình vào đĩa
Sau khi kích hoạt:
  • Khởi động lại gateway để hooks tải lại (khởi động lại ứng dụng menu bar trên macOS, hoặc khởi động lại quá trình gateway trong dev).

​
Tắt Một Hook

Tắt một hook cụ thể bằng cách cập nhật cấu hình. Tham số:
  • <name>: Tên hook (ví dụ: command-logger)
Ví dụ:
Đầu ra:
Sau khi tắt:
  • Khởi động lại gateway để hooks tải lại

​
Cài Đặt Hooks

Cài đặt một gói hook từ thư mục/tệp lưu trữ cục bộ hoặc npm. Các thông số npm chỉ dành cho registry (tên gói + phiên bản chính xác tùy chọn hoặc dist-tag). Các thông số Git/URL/tệp và phạm vi semver bị từ chối. Cài đặt phụ thuộc chạy với --ignore-scripts để đảm bảo an toàn. Các thông số trần và @latest giữ trên đường ổn định. Nếu npm giải quyết một trong hai thành một bản phát hành trước, OpenClaw dừng lại và yêu cầu bạn chọn rõ ràng với một thẻ phát hành trước như @beta/@rc hoặc một phiên bản phát hành trước chính xác. Những gì nó làm:
  • Sao chép gói hook vào ~/.openclaw/hooks/<id>
  • Kích hoạt các hooks đã cài đặt trong hooks.internal.entries.*
  • Ghi lại cài đặt dưới 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 vào hooks.internal.load.extraDirs)
  • --pin: Ghi lại cài đặt npm dưới dạng name@version đã giải quyết chính xác trong hooks.internal.installs
Các tệp lưu trữ hỗ trợ: .zip, .tgz, .tar.gz, .tar Ví dụ:

​
Cập Nhật Hooks

Cập nhật các gói hook đã cài đặt (chỉ cài đặt npm). Tùy chọn:
  • --all: Cập nhật tất cả các gói hook được theo dõi
  • --dry-run: Hiển thị những gì sẽ thay đổi mà không ghi
Khi một hash toàn vẹn được lưu trữ tồn tại và hash của artifact được lấy về thay đổi, OpenClaw in ra cảnh báo và yêu cầu xác nhận trước khi tiếp tục. Sử dụng --yes toàn cầu để bỏ qua các nhắc nhở trong các lần chạy CI/không tương tác.

​
Hooks Đi Kèm

​
session-memory

Lưu ngữ cảnh phiên vào bộ nhớ khi bạn thực hiện /new. Kích hoạt:
Đầu ra: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md Xem thêm: tài liệu session-memory

​
bootstrap-extra-files

Chèn thêm các tệp bootstrap (ví dụ như AGENTS.md / TOOLS.md trong monorepo-local) trong quá trình agent:bootstrap. Kích hoạt:
Xem thêm: tài liệu bootstrap-extra-files

​
command-logger

Ghi lại tất cả sự kiện lệnh vào một tệp audit tập trung. Kích hoạt:
Đầu ra: ~/.openclaw/logs/commands.log Xem nhật ký:
Xem thêm: tài liệu command-logger

​
boot-md

Chạy BOOT.md khi gateway khởi động (sau khi các kênh bắt đầu). Sự kiện: gateway:startup Kích hoạt:
Xem thêm: tài liệu boot-md
Lần sửa đổi cuối 22 tháng 3, 2026