Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

Use this file to discover all available pages before exploring further.

​

Logging

• Đầu ra console (những gì bạn thấy trong terminal / Debug UI).
• Log file (dòng JSON) được ghi bởi gateway logger.

​

Logger dựa trên file

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

openclaw logs --follow

• Log file được kiểm soát hoàn toà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 file.
• Để ghi lại chi tiết chỉ có trong chế độ verbose vào log file, đặt logging.level thành debug hoặc trace.

​

Ghi nhận console

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

​

Tóm tắt công cụ và che giấu thông tin nhạy cảm

• logging.redactSensitive: off | tools (mặc định: tools)
• logging.redactPatterns: mảng các chuỗi regex (ghi đè mặc định)
  • Sử dụng chuỗi regex thô (tự động gi), hoặc /pattern/flags nếu cần cờ tùy chỉnh.
  • Các kết quả khớp được che giấu 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 gồm các gán khóa phổ biến, cờ CLI, trường JSON, tiêu đề bearer, khối PEM và tiền tố token phổ biến.

​

Log WebSocket của Gateway

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

​

Kiểu log WS

• --ws-log auto (mặc định): chế độ thường được tối ưu hóa; chế độ chi tiết sử dụng đầu ra gọn
• --ws-log compact: đầu ra gọn (yêu cầu/đáp ứng ghép đôi) khi chi tiết
• --ws-log full: đầu ra đầy đủ theo từng khung khi chi tiết
• --compact: bí danh cho --ws-log compact

# tối ưu hóa (chỉ lỗi/chậm)
openclaw gateway

# hiển thị tất cả lưu lượng WS (ghép đôi)
openclaw gateway --verbose --ws-log compact

# hiển thị tất cả lưu lượng WS (đầy đủ meta)
openclaw gateway --verbose --ws-log full

​

Định dạng console (logging subsystem)

• Tiền tố subsystem trên mỗi dòng (ví dụ: [gateway], [canvas], [tailscale])
• Màu subsystem (ổn định theo từng subsystem) cộng với màu mức độ
• Màu khi đầu ra là TTY hoặc môi trường trông giống như terminal phong phú (TERM/COLORTERM/TERM_PROGRAM), tôn trọng NO_COLOR
• Tiền tố subsystem rút gọn: bỏ gateway/ + channels/ dẫn đầu, giữ lại 2 đoạn cuối (ví dụ: whatsapp/outbound)
• Sub-loggers theo subsystem (tự động tiền tố + trường 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 file (file giữ chi tiết đầy đủ khi logging.level được đặt thành debug/trace)
• Nội dung tin nhắn WhatsApp được log ở mức debug (sử dụng --verbose để xem chúng)