English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

Nhật ký

openclaw logs

Theo dõi phần cuối nhật ký tệp Gateway qua RPC (hoạt động ở chế độ từ xa).

Liên quan:

Tùy chọn

  • --limit <n>: số dòng nhật ký tối đa cần trả về (mặc định 200)
  • --max-bytes <n>: số byte tối đa cần đọc từ tệp nhật ký (mặc định 250000)
  • --follow: theo dõi luồng nhật ký
  • --interval <ms>: khoảng thời gian thăm dò khi đang theo dõi (mặc định 1000)
  • --json: xuất các sự kiện JSON phân tách theo dòng
  • --plain: đầu ra văn bản thuần không có định dạng kiểu cách
  • --no-color: tắt màu ANSI
  • --local-time: hiển thị dấu thời gian theo múi giờ cục bộ của bạn (mặc định)
  • --utc: hiển thị dấu thời gian theo UTC

Tùy chọn RPC Gateway dùng chung

openclaw logs cũng chấp nhận các cờ máy khách Gateway tiêu chuẩn:

  • --url <url>: URL WebSocket của Gateway
  • --token <token>: token Gateway
  • --timeout <ms>: thời gian chờ tính bằng ms (mặc định 30000)
  • --expect-final: chờ phản hồi cuối cùng khi lệnh gọi Gateway được tác tử hỗ trợ

Khi bạn truyền --url, CLI không tự động áp dụng cấu hình hoặc thông tin xác thực từ môi trường. Hãy bao gồm --token rõ ràng nếu Gateway đích yêu cầu xác thực.

Ví dụ

bash
openclaw logsopenclaw logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --limit 500openclaw logs --local-timeopenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Ghi chú

  • Dấu thời gian mặc định hiển thị theo múi giờ cục bộ của bạn. Dùng --utc để xuất theo UTC.
  • Nếu Gateway local loopback ngầm định yêu cầu ghép nối, đóng trong khi kết nối, hoặc hết thời gian chờ trước khi logs.tail trả lời, openclaw logs sẽ tự động chuyển về nhật ký tệp Gateway đã cấu hình. Các đích --url rõ ràng không dùng cơ chế dự phòng này.
  • openclaw logs --follow không theo dõi các dự phòng tệp đã cấu hình sau lỗi RPC Gateway cục bộ ngầm định. Trên Linux, lệnh này dùng journal Gateway user-systemd đang hoạt động theo PID khi có sẵn và in nguồn nhật ký đã chọn; nếu không, lệnh tiếp tục thử lại Gateway trực tiếp thay vì theo dõi một tệp đặt cạnh có thể đã cũ.
  • Khi dùng --follow, các lần ngắt kết nối Gateway tạm thời (đóng WebSocket, hết thời gian chờ, rớt kết nối) sẽ kích hoạt tự động kết nối lại với backoff lũy thừa (tối đa 8 lần thử lại, giới hạn 30 giây giữa các lần thử). Một cảnh báo được in ra stderr ở mỗi lần thử lại, và thông báo [logs] gateway reconnected được in sau khi một lần thăm dò thành công. Ở chế độ --json, cả cảnh báo thử lại và chuyển trạng thái kết nối lại đều được phát ra dưới dạng bản ghi {"type":"notice"} trên stderr. Các lỗi không thể khôi phục (lỗi xác thực, cấu hình sai) vẫn thoát ngay lập tức.
  • Ở chế độ --follow --json, các chuyển đổi nguồn nhật ký được phát ra dưới dạng bản ghi {"type":"meta"}. Thành phần tiêu thụ nên theo dõi con trỏ theo từng sourceKind: một luồng có thể chuyển từ đầu ra tệp Gateway (sourceKind: "file") sang dự phòng journal cục bộ (sourceKind: "journal", localFallback: true, cùng với service.pid/service.unit) rồi quay lại đầu ra tệp Gateway sau khi khôi phục. Đừng giả định một nguồn hoặc con trỏ ổn định duy nhất cho toàn bộ phiên theo dõi, và hãy chấp nhận các dòng trùng lặp khi quá trình khôi phục phát lại con trỏ tệp Gateway.

Liên quan

Was this useful?
On this page

On this page