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:

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

Đường cơ sở lành mạnh:

Runtime: running
RPC 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.

Xử lý sự cố đầy đủ: /channels/whatsapp#troubleshooting-quick

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ố.

Xử lý sự cố đầy đủ: /channels/telegram#troubleshooting

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.

Xử lý sự cố đầy đủ: /channels/discord#troubleshooting

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`.

Xử lý sự cố đầy đủ: /channels/slack#troubleshooting

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.

Xử lý sự cố đầy đủ:

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.

Xử lý sự cố đầy đủ: /channels/signal#troubleshooting

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.

Xử lý sự cố đầy đủ: /channels/matrix#troubleshooting

Tổng quan

Nền tảng nhắn tin

Cấu hình

Xử lý sự cố kênh

Xử lý sự cố kênh

Thang lệnh

WhatsApp

Dấu hiệu lỗi WhatsApp

Telegram

Dấu hiệu lỗi Telegram

Discord

Dấu hiệu lỗi Discord

Slack

Dấu hiệu lỗi Slack

iMessage và BlueBubbles

Dấu hiệu lỗi iMessage và BlueBubbles

Signal

Dấu hiệu lỗi Signal

Matrix

Dấu hiệu lỗi Matrix

​Xử lý sự cố kênh

​Thang lệnh

​WhatsApp

​Dấu hiệu lỗi WhatsApp

​Telegram

​Dấu hiệu lỗi Telegram

​Discord

​Dấu hiệu lỗi Discord

​Slack

​Dấu hiệu lỗi Slack

​iMessage và BlueBubbles

​Dấu hiệu lỗi iMessage và BlueBubbles

​Signal

​Dấu hiệu lỗi Signal

​Matrix

​Dấu hiệu lỗi Matrix

Xử lý sự cố kênh

Thang lệnh

WhatsApp

Dấu hiệu lỗi WhatsApp

Telegram

Dấu hiệu lỗi Telegram

Discord

Dấu hiệu lỗi Discord

Slack

Dấu hiệu lỗi Slack

iMessage và BlueBubbles

Dấu hiệu lỗi iMessage và BlueBubbles

Signal

Dấu hiệu lỗi Signal

Matrix

Dấu hiệu lỗi Matrix