QuotaCheap Playbook

OpenClaw Status, Logs và Troubleshooting: runbook khi agent production bắt đầu lắc

Hướng dẫn OpenClaw troubleshooting: status, gateway status, logs follow, doctor, channels status probe, update recovery, split brain installs, protocol mis…

Khi agent im, chậm, lỗi model, mất channel hoặc Gateway down, đừng đoán. Đi theo command ladder: status, gateway status, logs, doctor, channel probe.

Playbook tiếng Việt về OpenClaw Status, Logs và Troubleshooting: command ladder, gateway health, logs --follow, doctor, channel probes, update recovery, split-brain installs, protocol mismatch, provider errors, JSONL logs và QuotaCheap usage/log visibility.

Agent production không chết theo kiểu điện ảnh.

Nó không nổ tung.

Nó thường chết rất đời: không trả lời, channel mất kết nối, Gateway down, model 401, provider 429, plugin load fail, PATH trỏ nhầm binary cũ, logs nói protocol mismatch, hoặc cron vẫn chạy nhưng output biến mất.

Lúc đó đừng đoán.

OpenClaw có troubleshooting runbook khá rõ.

Cách làm đúng là đi theo command ladder, đọc expected healthy signals, rồi khoanh vùng: Gateway, channel, config, provider, update, protocol, plugin, logs.

Bài này là runbook tiếng Việt để debug OpenClaw production mà không tự biến mình thành thầy bói công nghệ.

Command ladder: chạy theo thứ tự này trước OpenClaw troubleshooting docs đưa command ladder: Đừng đảo lung tung nếu chưa có lý do.

Thứ tự này đi từ toàn cảnh đến runtime, logs, config health, rồi channel probes.

Expected healthy signals: openclaw gateway status shows Runtime: running, Connectivity probe: ok, và Capability: ...

openclaw doctor không báo blocking config/service issues.

openclaw channels status probe hiển thị live per account transport status và probe/audit results như works hoặc audit ok khi supported.

Nếu chưa chạy command ladder mà đã sửa config, bạn đang bắn trong sương mù.

Rất ngầu trong phim, hơi ngu trong production.

Gateway status: runtime sống chưa?

Gateway runbook nhắc health checks: Khi cần RPC proof chứ không chỉ reachability: gateway status deep thì khác: nó thêm system level service scan như LaunchDaemons/systemd/schtasks.

Docs nói nó không phải deeper RPC health probe.

Dùng: khi nghi ngờ service install/stale supervisor/multiple gateway like services.

Logs: đừng chỉ nhìn terminal hiện tại OpenClaw logging docs nói có hai main log surfaces: file logs JSON lines written by Gateway; console output trong terminals và Gateway Debug UI.

Control UI Logs tab tails gateway file log.

Default Gateway log file: Date theo gateway host local timezone.

File rotate khi đạt logging.maxFileBytes default 100 MB; OpenClaw giữ tối đa five numbered archives.

Recommended live tail: Useful options: Khi explicit url, CLI không auto apply config/env credentials; cần tự include token nếu Gateway target yêu cầu auth.

JSONL logs: đọc được bằng người, parse được bằng máy File logs là JSONL.