Chuyển đến nội dung chính

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

WhatsApp

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

Triệu chứngKiểm tra nhanh nhấtCách sửa chữa
Kết nối nhưng không có phản hồi DMopenclaw pairing list whatsappPhê 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ỏ quaKiể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ênopenclaw 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

Telegram

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

Triệu chứngKiểm tra nhanh nhấtCách sửa chữa
/start nhưng không có luồng phản hồi khả dụngopenclaw pairing list telegramPhê 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ồiKiểm tra yêu cầu đề cập và chế độ riêng tư của botTắ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ạngKiểm tra logs cho lỗi gọi API TelegramSửa DNS/IPv6/định tuyến proxy tới api.telegram.org.
setMyCommands bị từ chối khi khởi độngKiểm tra logs cho BOT_COMMANDS_TOO_MUCHGiả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ạnopenclaw security audit và cấu hình danh sách cho phépChạ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ứngKiểm tra nhanh nhấtCách sửa chữa
Bot trực tuyến nhưng không có phản hồi từ guildopenclaw channels status --probeCho phép guild/kênh và kiểm tra ý định nội dung tin nhắn.
Tin nhắn nhóm bị bỏ quaKiể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ếuopenclaw pairing list discordPhê 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ứngKiểm tra nhanh nhấtCách sửa chữa
Kết nối chế độ socket nhưng không có phản hồiopenclaw channels status --probeKiểm tra token ứng dụng + token bot và các phạm vi cần thiết.
DM bị chặnopenclaw pairing list slackPhê duyệt ghép đôi hoặc nới lỏng chính sách DM.
Tin nhắn kênh bị bỏ quaKiểm tra groupPolicy và danh sách cho phép kênhCho 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ứngKiểm tra nhanh nhấtCách sửa chữa
Không có sự kiện đầu vàoKiểm tra khả năng truy cập webhook/máy chủ và quyền ứng dụngSử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 macOSKiểm tra quyền riêng tư macOS cho tự động hóa MessagesCấp lại quyền TCC và khởi động lại quá trình kênh.
Người gửi DM bị chặnopenclaw pairing list imessage hoặc openclaw pairing list bluebubblesPhê 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ứngKiểm tra nhanh nhấtCách sửa chữa
Daemon có thể truy cập nhưng bot im lặngopenclaw channels status --probeKiểm tra URL/ tài khoản daemon signal-cli và chế độ nhận.
DM bị chặnopenclaw pairing list signalPhê 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ạtKiểm tra danh sách cho phép nhóm và mẫu đề cậpThê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ứngKiểm tra nhanh nhấtCách sửa chữa
Đã đăng nhập nhưng bỏ qua tin nhắn phòngopenclaw channels status --probeKiểm tra groupPolicy và danh sách cho phép phòng.
DM không xử lýopenclaw pairing list matrixPhê 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ạiKiểm tra mô-đun mã hóa và cài đặt mã hóaBậ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
Last modified on March 22, 2026