​

Ghi log

• Đầu ra console (những gì bạn thấy trong terminal / Debug UI).
• Log tệp (các dòng JSON) do bộ ghi log của gateway ghi ra.

​

Bộ ghi log dựa trên tệp

• Tệp log cuộn mặc định nằm dưới /tmp/openclaw/ (mỗi ngày một tệp): openclaw-YYYY-MM-DD.log
  • Ngày sử dụng múi giờ cục bộ của máy chủ gateway.
• Đường dẫn tệp log và mức log có thể cấu hình qua ~/.openclaw/openclaw.json:
  • logging.file
  • logging.level

openclaw logs --follow

• Log tệp được điều khiển độc quyền bởi logging.level.
• --verbose chỉ ảnh hưởng đến độ chi tiết của console (và kiểu log WS); nó không nâng mức log của tệp.
• Để ghi lại các chi tiết chỉ có ở verbose vào log tệp, hãy đặt logging.level thành debug hoặc trace.

​

Bắt console

• logging.consoleLevel (mặc định info)
• logging.consoleStyle (pretty | compact | json)

​

Che thông tin tóm tắt của công cụ

• logging.redactSensitive: off | tools (mặc định: tools)
• logging.redactPatterns: mảng các chuỗi regex (ghi đè mặc định)
  • Dùng chuỗi regex thô (tự động gi), hoặc /pattern/flags nếu bạn cần cờ tùy chỉnh.
  • Các khớp sẽ được che bằng cách giữ 6 ký tự đầu + 4 ký tự cuối (độ dài >= 18), nếu không thì ***.
  • Mặc định bao phủ các gán khóa phổ biến, cờ CLI, trường JSON, header bearer, khối PEM và các tiền tố token phổ biến.

​

Log WebSocket của Gateway

• Chế độ thường (không có --verbose): chỉ in các kết quả RPC “đáng chú ý”:
  • lỗi (ok=false)
  • các lời gọi chậm (ngưỡng mặc định: >= 50ms)
  • lỗi phân tích
• Chế độ verbose (--verbose): in toàn bộ lưu lượng yêu cầu/phản hồi WS.

​

Kiểu log WS

• --ws-log auto (mặc định): chế độ thường được tối ưu; chế độ verbose dùng đầu ra gọn
• --ws-log compact: đầu ra gọn (ghép cặp yêu cầu/phản hồi) khi verbose
• --ws-log full: đầu ra đầy đủ theo từng frame khi verbose
• --compact: bí danh cho --ws-log compact

# optimized (only errors/slow)
openclaw gateway

# show all WS traffic (paired)
openclaw gateway --verbose --ws-log compact

# show all WS traffic (full meta)
openclaw gateway --verbose --ws-log full

​

Định dạng console (ghi log theo hệ thống con)

• Tiền tố hệ thống con trên mỗi dòng (ví dụ: [gateway], [canvas], [tailscale])
• Màu theo hệ thống con (ổn định theo từng hệ thống con) cộng với màu theo mức log
• Có màu khi đầu ra là TTY hoặc môi trường trông như terminal phong phú (TERM/COLORTERM/TERM_PROGRAM), tôn trọng NO_COLOR
• Rút gọn tiền tố hệ thống con: bỏ gateway/ + channels/ ở đầu, giữ 2 phân đoạn cuối (ví dụ: whatsapp/outbound)
• Bộ ghi log con theo hệ thống con (tự động thêm tiền tố + trường có cấu trúc { subsystem })
• logRaw() cho đầu ra QR/UX (không tiền tố, không định dạng)
• Kiểu console (ví dụ: pretty | compact | json)
• Mức log console tách biệt với mức log tệp (tệp vẫn giữ đầy đủ chi tiết khi logging.level được đặt thành debug/trace)
• Nội dung tin nhắn WhatsApp được ghi log ở mức debug (dùng --verbose để xem)