Configuration
Khắc phục sự cố kênh
Hãy dùng trang này khi một kênh kết nối được nhưng hoạt động không đúng.
Trình tự lệnh
Trước tiên, hãy chạy các lệnh sau theo thứ tự:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeTrạng thái cơ sở bình thường:
Runtime: runningConnectivity probe: okCapability: read-only,write-capablehoặcadmin-capable- Phép dò kênh cho thấy lớp truyền tải đã kết nối và, nếu được hỗ trợ, hiển thị
workshoặcaudit ok
Sau khi cập nhật
Hãy dùng phần này khi Telegram, iMessage, cấu hình từ thời BlueBubbles hoặc một kênh Plugin khác biến mất sau khi cập nhật.
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --allTìm plugin load failed: dependency tree corrupted; run openclaw doctor --fix trong openclaw status --all. Điều này có nghĩa là kênh đã được cấu hình, nhưng quá trình thiết lập/tải Plugin gặp cây
phụ thuộc bị hỏng thay vì đăng ký kênh. openclaw doctor --fix xóa các liên kết tượng trưng phụ thuộc
cũ của môi trường chạy Plugin và các bản sao xác thực cũ, sau đó openclaw gateway restart tải lại
trạng thái sạch.
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 tin nhắn trực tiếp | openclaw pairing list whatsapp |
Phê duyệt người gửi hoặc thay đổi chính sách/danh sách cho phép đối với tin nhắn trực tiếp. |
| Tin nhắn nhóm bị bỏ qua | Kiểm tra requireMention và các 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 nhập bằng mã QR hết thời gian chờ với mã 408 | Kiểm tra biến môi trường HTTPS_PROXY / HTTP_PROXY của Gateway |
Đặt proxy có thể truy cập; chỉ dùng NO_PROXY cho các trường hợp bỏ qua proxy. |
| Ngắt kết nối/đăng nhập lại lặp lại ngẫu nhiên | openclaw channels status --probe và nhật ký |
Các lần kết nối lại gần đây vẫn bị đánh dấu ngay cả khi hiện đang kết nối; theo dõi nhật ký, khởi động lại Gateway, rồi liên kết lại nếu tình trạng chập chờn tiếp diễn. |
Vòng lặp status=408 Request Time-out |
Dò, xem nhật ký, chạy doctor, rồi kiểm tra trạng thái Gateway | Trước tiên hãy khắc phục kết nối/thời gian của máy chủ; sao lưu dữ liệu xác thực và liên kết lại tài khoản nếu vòng lặp vẫn tiếp diễn. |
| Phản hồi đến trễ vài giây/phút | openclaw doctor --fix |
Doctor dừng các máy khách TUI cục bộ cũ đã được xác minh khi chúng làm suy giảm vòng lặp sự kiện của Gateway. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố WhatsApp
Telegram
Dấu hiệu lỗi Telegram
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
Gửi /start nhưng không có luồng phản hồi dùng được |
openclaw pairing list telegram |
Phê duyệt ghép nối hoặc thay đổi chính sách tin nhắn trực tiếp. |
| Bot trực tuyến nhưng nhóm vẫn im lặng | Xác minh yêu cầu đề cập và chế độ riêng tư của bot | Tắt chế độ riêng tư để bot nhìn thấy nội dung nhóm hoặc đề cập bot. |
| Gửi thất bại kèm lỗi mạng | Kiểm tra nhật ký để tìm lỗi gọi API Telegram | Khắc phục định tuyến DNS/IPv6/proxy đến api.telegram.org. |
Khi khởi động báo getMe returned 401 |
Kiểm tra nguồn token đã cấu hình | Sao chép lại hoặc tạo lại token BotFather rồi cập nhật botToken, tokenFile hoặc TELEGRAM_BOT_TOKEN của tài khoản mặc định. |
| Thăm dò bị đình trệ hoặc kết nối lại chậm | Dùng openclaw logs --follow để xem chẩn đoán thăm dò |
Nâng cấp; nếu các lần khởi động lại là cảnh báo sai, hãy điều chỉnh pollingStallThresholdMs. Tình trạng đình trệ kéo dài vẫn cho thấy vấn đề về proxy/DNS/IPv6. |
setMyCommands bị từ chối khi khởi động |
Kiểm tra nhật ký để tìm BOT_COMMANDS_TOO_MUCH |
Giảm số lệnh Telegram của Plugin/Skills/tùy chỉnh hoặc tắt menu gốc. |
| Sau khi nâng cấp, danh sách cho phép chặn bạn | openclaw security audit và các danh sách cho phép trong cấu hình |
Chạy openclaw doctor --fix hoặc thay @username bằng ID người gửi dạng số. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố Telegram
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 trực tuyến nhưng không phản hồi trong máy chủ | openclaw channels status --probe |
Cho phép máy chủ/kênh và xác minh quyền truy cập nội dung tin nhắn. |
| Tin nhắn nhóm bị bỏ qua | Kiểm tra nhật ký để tìm các lần loại bỏ do cổng kiểm soát đề cập | Đề cập bot hoặc đặt requireMention: false cho máy chủ/kênh. |
| Hiển thị đang nhập/sử dụng token nhưng không có tin nhắn Discord | Kiểm tra đây có phải là sự kiện phòng xung quanh hay phòng message_tool đã chọn tham gia mà mô hình bỏ lỡ message(action=send) hay không |
Kiểm tra nhật ký chi tiết của Gateway để tìm siêu dữ liệu tải trọng cuối bị chặn, xác minh messages.groupChat.unmentionedInbound, đọc Sự kiện phòng xung quanh, hoặc giữ messages.groupChat.visibleReplies: "automatic" cho các yêu cầu nhóm thông thường. |
| Thiếu phản hồi tin nhắn trực tiếp | openclaw pairing list discord |
Phê duyệt ghép nối tin nhắn trực tiếp hoặc điều chỉnh chính sách tin nhắn trực tiếp. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố Discord
Slack
Dấu hiệu lỗi Slack
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Chế độ socket đã kết nối nhưng không có phản hồi | openclaw channels status --probe |
Xác minh token ứng dụng, token bot và các phạm vi bắt buộc; chú ý botTokenStatus / appTokenStatus = configured_unavailable trong các thiết lập dựa trên SecretRef. |
| Tin nhắn trực tiếp bị chặn | openclaw pairing list slack |
Phê duyệt ghép nối hoặc nới lỏng chính sách tin nhắn trực tiếp. |
| Tin nhắn kênh bị bỏ qua | Kiểm tra groupPolicy và danh sách cho phép của kênh |
Cho phép kênh hoặc chuyển chính sách sang open. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố Slack
iMessage
Dấu hiệu lỗi iMessage
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
Thiếu imsg hoặc không chạy trên hệ điều hành không phải macOS |
openclaw channels status --probe --channel imessage |
Chạy OpenClaw trên máy Mac có Messages hoặc dùng trình bao bọc SSH cho cliPath. |
| Có thể gửi nhưng không nhận được trên macOS | Kiểm tra quyền riêng tư của macOS dành cho tính năng 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 tin nhắn trực tiếp bị chặn | openclaw pairing list imessage |
Phê duyệt ghép nối hoặc cập nhật danh sách cho phép. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố iMessage
Signal
Dấu hiệu lỗi Signal
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Có thể truy cập daemon 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. |
| Tin nhắn trực tiếp bị chặn | openclaw pairing list signal |
Phê duyệt người gửi hoặc điều chỉnh chính sách tin nhắn trực tiếp. |
| Phản hồi nhóm không được kích hoạt | Kiểm tra danh sách cho phép của nhóm và các mẫu đề cập | Thêm người gửi/nhóm hoặc nới lỏng cổng kiểm soát. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố Signal
QQ Bot
Dấu hiệu lỗi QQ Bot
| Triệu chứng | Kiểm tra nhanh nhất | Cách khắc phục |
|---|---|---|
| Bot trả lời "đã bay lên sao Hỏa" | Xác minh appId và clientSecret trong cấu hình |
Đặt thông tin xác thực hoặc khởi động lại Gateway. |
| Không có tin nhắn đến | openclaw channels status --probe |
Xác minh thông tin xác thực trên QQ Open Platform. |
| Giọng nói không được chuyển thành văn bản | Kiểm tra cấu hình nhà cung cấp STT | Cấu hình channels.qqbot.stt hoặc tools.media.audio. |
| Tin nhắn chủ động không đến | Kiểm tra yêu cầu tương tác của nền tảng QQ | QQ có thể chặn tin nhắn do bot khởi tạo nếu không có tương tác gần đây. |
Khắc phục sự cố đầy đủ: Khắc phục sự cố QQ Bot
Matrix
Các dấu hiệu lỗi Matrix
| Triệu chứng | Cách 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, danh sách phòng được phép và điều kiện yêu cầu đề cập. |
| Tin nhắn trực tiếp 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 tin nhắn trực tiếp. |
| Phòng được mã hóa không hoạt động | openclaw matrix verify status |
Xác minh lại thiết bị, sau đó kiểm tra openclaw matrix verify backup status. |
| Khôi phục bản sao lưu đang chờ/bị lỗi | openclaw matrix verify backup status |
Chạy openclaw matrix verify backup restore hoặc chạy lại bằng khóa khôi phục. |
| Ký chéo/khởi tạo ban đầu có vẻ không đúng | openclaw matrix verify bootstrap |
Sửa bộ lưu trữ bí mật, trạng thái ký chéo và sao lưu trong một lần. |
Hướng dẫn thiết lập và cấu hình đầy đủ: Matrix
Liên quan
Was this useful?
