​

Xử lý sự cố Gateway

​

Thứ tự lệnh

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

• openclaw gateway status hiển thị Runtime: running và RPC probe: ok.
• openclaw doctor không báo cáo vấn đề cấu hình/dịch vụ nào gây cản trở.
• openclaw channels status --probe hiển thị các kênh đã kết nối/sẵn sàng.

​

Anthropic 429 cần sử dụng thêm cho ngữ cảnh dài

openclaw logs --follow
openclaw models status
openclaw config get agents.defaults.models

• Mô hình Anthropic Opus/Sonnet được chọn có params.context1m: true.
• Thông tin xác thực Anthropic hiện tại không đủ điều kiện cho việc sử dụng ngữ cảnh dài.
• Yêu cầu chỉ thất bại trong các phiên dài/chạy mô hình cần đường dẫn 1M beta.

1. Vô hiệu hóa context1m cho mô hình đó để quay lại cửa sổ ngữ cảnh bình thường.
2. Sử dụng khóa API Anthropic có thanh toán, hoặc kích hoạt Anthropic Extra Usage trên tài khoản đăng ký.
3. Cấu hình các mô hình dự phòng để tiếp tục chạy khi yêu cầu ngữ cảnh dài của Anthropic bị từ chối.

• /providers/anthropic
• /reference/token-use
• /help/faq#why-am-i-seeing-http-429-ratelimiterror-from-anthropic

​

Không có phản hồi

openclaw status
openclaw channels status --probe
openclaw pairing list --channel <channel> [--account <id>]
openclaw config get channels
openclaw logs --follow

• Ghép đôi đang chờ xử lý cho người gửi DM.
• Chính sách nhắc nhóm (requireMention, mentionPatterns).
• Không khớp danh sách cho phép kênh/nhóm.

• drop guild message (mention required → tin nhắn nhóm bị bỏ qua cho đến khi được nhắc.
• pairing request → người gửi cần được phê duyệt.
• blocked / allowlist → người gửi/kênh bị lọc bởi chính sách.

• /channels/troubleshooting
• /channels/pairing
• /channels/groups

​

Kết nối giao diện điều khiển Dashboard

openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor
openclaw gateway status --json

• URL kiểm tra và URL dashboard chính xác.
• Không khớp chế độ xác thực/token giữa client và gateway.
• Sử dụng HTTP khi cần nhận diện thiết bị.

• device identity required → ngữ cảnh không bảo mật hoặc thiếu xác thực thiết bị.
• device nonce required / device nonce mismatch → client không hoàn thành luồng xác thực thiết bị dựa trên thử thách (connect.challenge + device.nonce).
• device signature invalid / device signature expired → client ký payload sai (hoặc dấu thời gian cũ) cho quá trình bắt tay hiện tại.
• AUTH_TOKEN_MISMATCH với canRetryWithDeviceToken=true → client có thể thử lại một lần với token thiết bị đã lưu trong bộ nhớ cache.
• lặp lại unauthorized sau lần thử lại đó → token chia sẻ/token thiết bị bị lệch; làm mới cấu hình token và phê duyệt/làm mới token thiết bị nếu cần.
• gateway connect failed: → sai host/port/url mục tiêu.

​

Bản đồ nhanh mã chi tiết xác thực

openclaw --version
openclaw doctor
openclaw gateway status

1. chờ connect.challenge
2. ký payload ràng buộc thử thách
3. gửi connect.params.device.nonce với nonce thử thách tương tự

• /web/control-ui
• /gateway/authentication
• /gateway/remote
• /cli/devices

​

Dịch vụ Gateway không chạy

openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor
openclaw gateway status --deep

• Runtime: stopped với gợi ý thoát.
• Không khớp cấu hình dịch vụ (Config (cli) so với Config (service)).
• Xung đột cổng/người nghe.

• Gateway start blocked: set gateway.mode=local → chế độ gateway cục bộ chưa được kích hoạt. Khắc phục: đặt gateway.mode="local" trong cấu hình của bạn (hoặc chạy openclaw configure). Nếu bạn đang chạy OpenClaw qua Podman bằng người dùng openclaw chuyên dụng, cấu hình nằm tại ~openclaw/.openclaw/openclaw.json.
• refusing to bind gateway ... without auth → không ràng buộc loopback mà không có token/mật khẩu.
• another gateway instance is already listening / EADDRINUSE → xung đột cổng.

• /gateway/background-process
• /gateway/configuration
• /gateway/doctor

​

Tin nhắn kênh đã kết nối không lưu thông

openclaw channels status --probe
openclaw pairing list --channel <channel> [--account <id>]
openclaw status --deep
openclaw logs --follow
openclaw config get channels

• Chính sách DM (pairing, allowlist, open, disabled).
• Danh sách cho phép nhóm và yêu cầu nhắc.
• Thiếu quyền/phạm vi API kênh.

• mention required → tin nhắn bị bỏ qua bởi chính sách nhắc nhóm.
• pairing / dấu vết phê duyệt đang chờ xử lý → người gửi chưa được phê duyệt.
• missing_scope, not_in_channel, Forbidden, 401/403 → vấn đề xác thực/quyền kênh.

• /channels/troubleshooting
• /channels/whatsapp
• /channels/telegram
• /channels/discord

​

Giao hàng cron và nhịp tim

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow

• Cron được kích hoạt và lần thức tiếp theo có mặt.
• Trạng thái lịch sử chạy công việc (ok, skipped, error).
• Lý do bỏ qua nhịp tim (quiet-hours, requests-in-flight, alerts-disabled).

• cron: scheduler disabled; jobs will not run automatically → cron bị vô hiệu hóa.
• cron: timer tick failed → tick bộ lập lịch thất bại; kiểm tra lỗi file/nhật ký/thời gian chạy.
• heartbeat skipped với reason=quiet-hours → ngoài cửa sổ giờ hoạt động.
• heartbeat: unknown accountId → id tài khoản không hợp lệ cho mục tiêu giao hàng nhịp tim.
• heartbeat skipped với reason=dm-blocked → mục tiêu nhịp tim được giải quyết thành đích kiểu DM trong khi agents.defaults.heartbeat.directPolicy (hoặc ghi đè theo agent) được đặt thành block.

• /automation/troubleshooting
• /automation/cron-jobs
• /gateway/heartbeat

​

Công cụ node ghép đôi thất bại

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
openclaw status

• Node trực tuyến với các khả năng mong đợi.
• Cấp quyền hệ điều hành cho camera/mic/vị trí/màn hình.
• Trạng thái phê duyệt thực thi và danh sách cho phép.

• NODE_BACKGROUND_UNAVAILABLE → ứng dụng node phải ở nền trước.
• *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → thiếu quyền hệ điều hành.
• SYSTEM_RUN_DENIED: approval required → phê duyệt thực thi đang chờ xử lý.
• SYSTEM_RUN_DENIED: allowlist miss → lệnh bị chặn bởi danh sách cho phép.

• /nodes/troubleshooting
• /nodes/index
• /tools/exec-approvals

​

Công cụ trình duyệt thất bại

openclaw browser status
openclaw browser start --browser-profile openclaw
openclaw browser profiles
openclaw logs --follow
openclaw doctor

• Đường dẫn thực thi trình duyệt hợp lệ.
• Khả năng truy cập hồ sơ CDP.
• Khả dụng Chrome cục bộ cho các hồ sơ existing-session / user.

• Failed to start Chrome CDP on port → quá trình trình duyệt không khởi động được.
• browser.executablePath not found → đường dẫn cấu hình không hợp lệ.
• No Chrome tabs found for profile="user" → hồ sơ đính kèm Chrome MCP không có tab Chrome cục bộ mở.
• Browser attachOnly is enabled ... not reachable → hồ sơ chỉ đính kèm không có mục tiêu có thể truy cập.

• /tools/browser-linux-troubleshooting
• /tools/browser

​

Nếu bạn đã nâng cấp và có gì đó đột ngột bị hỏng

​

1) Hành vi ghi đè xác thực và URL đã thay đổi

openclaw gateway status
openclaw config get gateway.mode
openclaw config get gateway.remote.url
openclaw config get gateway.auth.mode

• Nếu gateway.mode=remote, các cuộc gọi CLI có thể đang nhắm mục tiêu từ xa trong khi dịch vụ cục bộ của bạn vẫn ổn.
• Các cuộc gọi --url rõ ràng không quay lại thông tin xác thực đã lưu.

• gateway connect failed: → sai mục tiêu URL.
• unauthorized → điểm cuối có thể truy cập nhưng xác thực sai.

​

2) Các rào cản ràng buộc và xác thực nghiêm ngặt hơn

openclaw config get gateway.bind
openclaw config get gateway.auth.token
openclaw gateway status
openclaw logs --follow

• Các ràng buộc không loopback (lan, tailnet, custom) cần cấu hình xác thực.
• Các khóa cũ như gateway.token không thay thế gateway.auth.token.

• refusing to bind gateway ... without auth → không khớp ràng buộc+xác thực.
• RPC probe: failed trong khi thời gian chạy đang hoạt động → gateway sống nhưng không thể truy cập với xác thực/url hiện tại.

​

3) Trạng thái ghép đôi và nhận diện thiết bị đã thay đổi

openclaw devices list
openclaw pairing list --channel <channel> [--account <id>]
openclaw logs --follow
openclaw doctor

• Phê duyệt thiết bị đang chờ xử lý cho dashboard/nodes.
• Phê duyệt ghép đôi DM đang chờ xử lý sau khi thay đổi chính sách hoặc nhận diện.

• device identity required → xác thực thiết bị không được thỏa mãn.
• pairing required → người gửi/thiết bị phải được phê duyệt.

openclaw gateway install --force
openclaw gateway restart

• /gateway/pairing
• /gateway/authentication
• /gateway/background-process