Documentation Index
Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
Use this file to discover all available pages before exploring further.
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ứ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
Telegram
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