Xử lý sự cố kênh
Dùng trang này khi một kênh kết nối được nhưng hành vi không đúng.Thang lệnh
Chạy theo thứ tự trước tiên:Runtime: runningRPC probe: ok- Thăm dò kênh hiển thị đã kết nối/sẵn sàng
Dấu hiệu lỗi WhatsApp
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Đã kết nối nhưng không trả lời DM | openclaw pairing list whatsapp | Phê duyệt người gửi hoặc chuyển chính sách/allowlist DM. |
| Tin nhắn nhóm bị bỏ qua | Kiểm tra requireMention + mẫu nhắc đến trong cấu hình | Nhắc đến bot hoặc nới lỏng chính sách nhắc đến cho nhóm đó. |
| Ngắt kết nối/nghỉ đăng nhập ngẫu nhiên | openclaw channels status --probe + nhật ký | Đăng nhập lại và xác minh thư mục thông tin xác thực còn tốt. |
Telegram
Dấu hiệu lỗi Telegram
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
/start nhưng không có luồng phản hồi dùng được | openclaw pairing list telegram | Phê duyệt ghép cặp hoặc thay đổi chính sách DM. |
| Bot online nhưng nhóm im lặng | Xác minh yêu cầu nhắc đến và chế độ riêng tư của bot | Tắt chế độ riêng tư để nhóm thấy được hoặc nhắc đến bot. |
| Gửi thất bại với lỗi mạng | Kiểm tra nhật ký lỗi gọi API Telegram | Sửa định tuyến DNS/IPv6/proxy tới api.telegram.org. |
| Đã nâng cấp và bị chặn bởi allowlist | openclaw security audit và allowlist cấu hình | Chạy openclaw doctor --fix hoặc thay @username bằng ID người gửi dạng số. |
Discord
Dấu hiệu lỗi Discord
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Bot online nhưng không trả lời trong guild | openclaw channels status --probe | Cho phép guild/kênh và xác minh intent nội dung tin nhắn. |
| Tin nhắn nhóm bị bỏ qua | Kiểm tra nhật ký các lần chặn do yêu cầu nhắc đến | Nhắc đến bot hoặc đặt requireMention: false cho guild/kênh. |
| Thiếu phản hồi DM | openclaw pairing list discord | Phê duyệt ghép cặp DM hoặc điều chỉnh chính sách DM. |
Slack
Dấu hiệu lỗi Slack
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Socket mode đã kết nối nhưng không có phản hồi | openclaw channels status --probe | Xác minh app token + bot token và các scope cần thiết. |
| DMs bị chặn | openclaw pairing list slack | Phê duyệt ghép cặp hoặc nới lỏng chính sách DM. |
| Tin nhắn kênh bị bỏ qua | Kiểm tra groupPolicy và allowlist kênh | Cho phép kênh hoặc chuyển chính sách sang open. |
iMessage và BlueBubbles
Dấu hiệu lỗi iMessage và BlueBubbles
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Không có sự kiện vào | Xác minh khả năng truy cập webhook/máy chủ và quyền ứng dụng | Sửa URL webhook hoặc trạng thái máy chủ BlueBubbles. |
| Gửi được nhưng không nhận trên macOS | Kiểm tra quyền riêng tư macOS cho tự động hóa Messages | Cấp lại quyền TCC và khởi động lại tiến trình kênh. |
| Người gửi DM bị chặn | openclaw pairing list imessage hoặc openclaw pairing list bluebubbles | Phê duyệt ghép cặp hoặc cập nhật allowlist. |
- /channels/imessage#troubleshooting-macos-privacy-and-security-tcc
- /channels/bluebubbles#troubleshooting
Signal
Dấu hiệu lỗi Signal
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Daemon truy cập được nhưng bot im lặng | openclaw channels status --probe | Xác minh URL/tài khoản daemon signal-cli và chế độ nhận. |
| DM bị chặn | openclaw pairing list signal | Phê duyệt người gửi hoặc điều chỉnh chính sách DM. |
| Phản hồi nhóm không kích hoạt | Kiểm tra allowlist nhóm và mẫu nhắc đến | Thêm người gửi/nhóm hoặc nới lỏng cơ chế chặn. |
Matrix
Dấu hiệu lỗi Matrix
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Đã đăng nhập nhưng bỏ qua tin nhắn phòng | openclaw channels status --probe | Kiểm tra groupPolicy và allowlist phòng. |
| DM không được xử lý | openclaw pairing list matrix | Phê duyệt người gửi hoặc điều chỉnh chính sách DM. |
| Phòng mã hóa thất bại | Xác minh mô-đun crypto và cài đặt mã hóa | Bật hỗ trợ mã hóa và tham gia lại/đồng bộ phòng. |