Khắc phục sự cố kênh

Sử dụng trang này khi kênh kết nối nhưng hành vi không đúng.

Thứ tự lệnh

Chạy các lệnh này theo thứ tự:

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

Tiêu chuẩn hoạt động bình thường:

Runtime: running
RPC probe: ok
Kênh kiểm tra cho thấy đã kết nối/sẵn sàng

Dấu hiệu lỗi của WhatsApp

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
Kết nối nhưng không có phản hồi DM	`openclaw pairing list whatsapp`	Phê duyệt người gửi hoặc thay đổi chính sách DM/danh sách cho phép.
Tin nhắn nhóm bị bỏ qua	Kiểm tra `requireMention` + mẫu đề cập trong cấu hình	Đề cập bot hoặc nới lỏng chính sách đề cập cho nhóm đó.
Ngắt kết nối/đăng nhập lại ngẫu nhiên	`openclaw channels status --probe` + logs	Đăng nhập lại và kiểm tra thư mục thông tin xác thực.

Khắc phục sự cố đầy đủ: /channels/whatsapp#troubleshooting

Dấu hiệu lỗi của Telegram

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
`/start` nhưng không có luồng phản hồi khả dụng	`openclaw pairing list telegram`	Phê duyệt ghép đôi hoặc thay đổi chính sách DM.
Bot trực tuyến nhưng nhóm không có phản hồi	Kiểm tra yêu cầu đề cập và chế độ riêng tư của bot	Tắt chế độ riêng tư để nhóm có thể thấy hoặc đề cập bot.
Gửi thất bại với lỗi mạng	Kiểm tra logs cho lỗi gọi API Telegram	Sửa DNS/IPv6/định tuyến proxy tới `api.telegram.org`.
`setMyCommands` bị từ chối khi khởi động	Kiểm tra logs cho `BOT_COMMANDS_TOO_MUCH`	Giảm số lệnh plugin/kỹ năng/Telgram tùy chỉnh hoặc tắt menu gốc.
Nâng cấp và danh sách cho phép chặn bạn	`openclaw security audit` và cấu hình danh sách cho phép	Chạy `openclaw doctor --fix` hoặc thay `@username` bằng ID người gửi số.

Khắc phục sự cố đầy đủ: /channels/telegram#troubleshooting

Discord

Dấu hiệu lỗi của Discord

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
Bot trực tuyến nhưng không có phản hồi từ guild	`openclaw channels status --probe`	Cho phép guild/kênh và kiểm tra ý định nội dung tin nhắn.
Tin nhắn nhóm bị bỏ qua	Kiểm tra logs cho việc bỏ qua đề cập	Đề cập bot hoặc đặt `requireMention: false` cho guild/kênh.
Phản hồi DM bị thiếu	`openclaw pairing list discord`	Phê duyệt ghép đôi DM hoặc điều chỉnh chính sách DM.

Khắc phục sự cố đầy đủ: /channels/discord#troubleshooting

Slack

Dấu hiệu lỗi của Slack

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
Kết nối chế độ socket nhưng không có phản hồi	`openclaw channels status --probe`	Kiểm tra token ứng dụng + token bot và các phạm vi cần thiết.
DM bị chặn	`openclaw pairing list slack`	Phê duyệt ghép đôi hoặc nới lỏng chính sách DM.
Tin nhắn kênh bị bỏ qua	Kiểm tra `groupPolicy` và danh sách cho phép kênh	Cho phép kênh hoặc chuyển chính sách sang `open`.

Khắc phục sự cố đầy đủ: /channels/slack#troubleshooting

iMessage và BlueBubbles

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

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
Không có sự kiện đầu vào	Kiểm tra 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.
Có thể gửi 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 quá 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 đôi hoặc cập nhật danh sách cho phép.

Khắc phục sự cố đầy đủ:

Signal

Dấu hiệu lỗi của Signal

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
Daemon có thể truy cập nhưng bot im lặng	`openclaw channels status --probe`	Kiểm tra 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 danh sách cho phép nhóm và mẫu đề cập	Thêm người gửi/nhóm hoặc nới lỏng điều kiện.

Khắc phục sự cố đầy đủ: /channels/signal#troubleshooting

Matrix

Dấu hiệu lỗi của Matrix

Triệu chứng	Kiểm tra nhanh nhất	Cách sửa chữa
Đã đăng nhập nhưng bỏ qua tin nhắn phòng	`openclaw channels status --probe`	Kiểm tra `groupPolicy` và danh sách cho phép phòng.
DM không 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	Kiểm tra mô-đun mã hóa và cài đặt mã hóa	Bật hỗ trợ mã hóa và tham gia/đồng bộ lại phòng.

Khắc phục sự cố đầy đủ: /channels/matrix#troubleshooting

Tổng quan cài đặt

Chạy qua Container

Triển khai (Hosting)

Bảo trì & Nâng cấp

Khắc phục sự cố kênh

Khắc phục sự cố kênh

Thứ tự lệnh

WhatsApp

Dấu hiệu lỗi của WhatsApp

Telegram

Dấu hiệu lỗi của Telegram

Discord

Dấu hiệu lỗi của Discord

Slack

Dấu hiệu lỗi của Slack

iMessage và BlueBubbles

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

Signal

Dấu hiệu lỗi của Signal

Matrix

Dấu hiệu lỗi của Matrix

​Khắc phục sự cố kênh

​Thứ tự lệnh

​WhatsApp

​Dấu hiệu lỗi của WhatsApp

​Telegram

​Dấu hiệu lỗi của Telegram

​Discord

​Dấu hiệu lỗi của Discord

​Slack

​Dấu hiệu lỗi của Slack

​iMessage và BlueBubbles

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

​Signal

​Dấu hiệu lỗi của Signal

​Matrix

​Dấu hiệu lỗi của Matrix

Khắc phục sự cố kênh

Thứ tự lệnh

WhatsApp

Dấu hiệu lỗi của WhatsApp

Telegram

Dấu hiệu lỗi của Telegram

Discord

Dấu hiệu lỗi của Discord

Slack

Dấu hiệu lỗi của Slack

iMessage và BlueBubbles

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

Signal

Dấu hiệu lỗi của Signal

Matrix

Dấu hiệu lỗi của Matrix