---
read_when:
    - انتقال کانال می‌گوید متصل است اما پاسخ‌ها شکست می‌خورند
    - پیش از مستندات عمیق ارائه‌دهنده، به بررسی‌های اختصاصی کانال نیاز دارید
summary: عیب‌یابی سریع در سطح کانال با امضاهای خرابی و راه‌حل‌های مخصوص هر کانال
title: عیب‌یابی کانال
x-i18n:
    generated_at: "2026-06-27T17:14:56Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 56b64030ec56553b4c2e156195806029f91bc8cc449588a242b0f45f8bbddb6e
    source_path: channels/troubleshooting.md
    workflow: 16
---

از این صفحه زمانی استفاده کنید که یک کانال وصل می‌شود اما رفتار آن نادرست است.

## نردبان دستورها

ابتدا این‌ها را به‌ترتیب اجرا کنید:

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

خط مبنای سالم:

- `Runtime: running`
- `Connectivity probe: ok`
- `Capability: read-only`، `write-capable` یا `admin-capable`
- پروب کانال نشان می‌دهد انتقال وصل است و، در مواردی که پشتیبانی می‌شود، `works` یا `audit ok`

## پس از به‌روزرسانی

وقتی Telegram، iMessage، پیکربندی‌های دوره BlueBubbles، یا کانال Plugin دیگری
پس از به‌روزرسانی ناپدید می‌شود، از این استفاده کنید.

```bash
openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all
```

در `openclaw status --all` دنبال `plugin load failed: dependency tree corrupted; run openclaw doctor
--fix` بگردید. این یعنی کانال پیکربندی شده است، اما
مسیر راه‌اندازی/بارگذاری Plugin به‌جای ثبت کانال، به یک درخت وابستگی خراب
برخورده است. `openclaw doctor --fix` دایرکتوری‌های مرحله‌بندی وابستگی Plugin
قدیمی و سایه‌های احراز هویت قدیمی را حذف می‌کند، سپس `openclaw gateway restart` وضعیت
پاک را دوباره بارگذاری می‌کند.

## WhatsApp

### امضاهای خرابی WhatsApp

| نشانه | سریع‌ترین بررسی | رفع |
| ----------------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| وصل است اما پاسخی به پیام مستقیم نمی‌دهد | `openclaw pairing list whatsapp` | فرستنده را تأیید کنید یا سیاست/فهرست مجاز پیام مستقیم را تغییر دهید. |
| پیام‌های گروه نادیده گرفته می‌شوند | `requireMention` و الگوهای منشن را در پیکربندی بررسی کنید | ربات را منشن کنید یا سیاست منشن را برای آن گروه آسان‌تر کنید. |
| ورود با QR با 408 مهلت‌اش تمام می‌شود | متغیرهای محیطی `HTTPS_PROXY` / `HTTP_PROXY` در Gateway را بررسی کنید | یک پراکسی قابل دسترس تنظیم کنید؛ از `NO_PROXY` فقط برای میان‌برها استفاده کنید. |
| قطع اتصال/ورود دوباره تصادفی تکرار می‌شود | `openclaw channels status --probe` + لاگ‌ها | اتصال‌های مجدد اخیر حتی وقتی اکنون وصل هستند علامت‌گذاری می‌شوند؛ لاگ‌ها را ببینید، Gateway را بازراه‌اندازی کنید، سپس اگر نوسان ادامه داشت دوباره پیوند دهید. |
| حلقه `status=408 Request Time-out` | پروب، لاگ‌ها، doctor، سپس وضعیت Gateway | ابتدا اتصال/زمان‌بندی میزبان را رفع کنید؛ اگر حلقه ادامه داشت از احراز هویت پشتیبان بگیرید و حساب را دوباره پیوند دهید. |
| پاسخ‌ها چند ثانیه/دقیقه دیر می‌رسند | `openclaw doctor --fix` | `doctor` کلاینت‌های محلی TUI قدیمی تأییدشده را وقتی حلقه رویداد Gateway را تخریب می‌کنند متوقف می‌کند. |

راهنمای کامل عیب‌یابی: [عیب‌یابی WhatsApp](/fa/channels/whatsapp#troubleshooting)

## Telegram

### امضاهای خرابی Telegram

| نشانه | سریع‌ترین بررسی | رفع |
| ------------------------------------ | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| `/start` اما بدون جریان پاسخ قابل استفاده | `openclaw pairing list telegram` | جفت‌سازی را تأیید کنید یا سیاست پیام مستقیم را تغییر دهید. |
| ربات آنلاین است اما گروه ساکت می‌ماند | الزام منشن و حالت حریم خصوصی ربات را بررسی کنید | برای دیده‌شدن در گروه، حالت حریم خصوصی را غیرفعال کنید یا ربات را منشن کنید. |
| خطاهای ارسال با خطاهای شبکه | لاگ‌ها را برای شکست‌های فراخوانی API Telegram بررسی کنید | مسیریابی DNS/IPv6/پراکسی به `api.telegram.org` را رفع کنید. |
| راه‌اندازی گزارش می‌دهد `getMe returned 401` | منبع توکن پیکربندی‌شده را بررسی کنید | توکن BotFather را دوباره کپی یا بازتولید کنید و `botToken`، `tokenFile`، یا `TELEGRAM_BOT_TOKEN` حساب پیش‌فرض را به‌روزرسانی کنید. |
| polling متوقف می‌شود یا اتصال مجدد کند است | `openclaw logs --follow` برای تشخیص‌های polling | ارتقا دهید؛ اگر بازراه‌اندازی‌ها مثبت کاذب هستند، `pollingStallThresholdMs` را تنظیم کنید. توقف‌های پایدار همچنان به پراکسی/DNS/IPv6 اشاره دارند. |
| `setMyCommands` هنگام راه‌اندازی رد می‌شود | لاگ‌ها را برای `BOT_COMMANDS_TOO_MUCH` بررسی کنید | فرمان‌های Telegram مربوط به Plugin/skill/سفارشی را کم کنید یا منوهای بومی را غیرفعال کنید. |
| ارتقا داده‌اید و فهرست مجاز شما را مسدود می‌کند | `openclaw security audit` و فهرست‌های مجاز پیکربندی | `openclaw doctor --fix` را اجرا کنید یا `@username` را با شناسه‌های عددی فرستنده جایگزین کنید. |

راهنمای کامل عیب‌یابی: [عیب‌یابی Telegram](/fa/channels/telegram#troubleshooting)

## Discord

### امضاهای خرابی Discord

| نشانه | سریع‌ترین بررسی | رفع |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ربات آنلاین است اما در guild پاسخی نمی‌دهد | `openclaw channels status --probe` | guild/کانال را مجاز کنید و message content intent را بررسی کنید. |
| پیام‌های گروه نادیده گرفته می‌شوند | لاگ‌ها را برای حذف‌های ناشی از دروازه‌بانی منشن بررسی کنید | ربات را منشن کنید یا `requireMention: false` را برای guild/کانال تنظیم کنید. |
| استفاده از typing/token وجود دارد اما پیام Discord نیست | بررسی کنید آیا این یک رویداد اتاق محیطی است یا اتاق `message_tool` انتخاب‌شده‌ای که مدل در آن `message(action=send)` را از دست داده است | لاگ verbose Gateway را برای فراداده payload نهایی سرکوب‌شده بررسی کنید، `messages.groupChat.unmentionedInbound` را تأیید کنید، [رویدادهای اتاق محیطی](/fa/channels/ambient-room-events) را بخوانید، یا برای درخواست‌های عادی گروه `messages.groupChat.visibleReplies: "automatic"` را نگه دارید. |
| پاسخ‌های پیام مستقیم نمی‌رسند | `openclaw pairing list discord` | جفت‌سازی پیام مستقیم را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید. |

راهنمای کامل عیب‌یابی: [عیب‌یابی Discord](/fa/channels/discord#troubleshooting)

## Slack

### امضاهای خرابی Slack

| نشانه | سریع‌ترین بررسی | رفع |
| -------------------------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| حالت سوکت وصل است اما پاسخی نیست | `openclaw channels status --probe` | توکن برنامه + توکن ربات و scopeهای لازم را بررسی کنید؛ در راه‌اندازی‌های مبتنی بر SecretRef مراقب `botTokenStatus` / `appTokenStatus = configured_unavailable` باشید. |
| پیام‌های مستقیم مسدود شده‌اند | `openclaw pairing list slack` | جفت‌سازی را تأیید کنید یا سیاست پیام مستقیم را آسان‌تر کنید. |
| پیام کانال نادیده گرفته می‌شود | `groupPolicy` و فهرست مجاز کانال را بررسی کنید | کانال را مجاز کنید یا سیاست را به `open` تغییر دهید. |

راهنمای کامل عیب‌یابی: [عیب‌یابی Slack](/fa/channels/slack#troubleshooting)

## iMessage

### امضاهای خرابی iMessage

| نشانه | سریع‌ترین بررسی | رفع |
| ------------------------------------ | ------------------------------------------------------- | --------------------------------------------------------------------- |
| `imsg` موجود نیست یا روی غیر macOS شکست می‌خورد | `openclaw channels status --probe --channel imessage` | OpenClaw را روی Mac دارای Messages اجرا کنید یا برای `cliPath` از یک wrapper مبتنی بر SSH استفاده کنید. |
| روی macOS می‌تواند ارسال کند اما دریافت نمی‌کند | مجوزهای حریم خصوصی macOS برای خودکارسازی Messages را بررسی کنید | مجوزهای TCC را دوباره اعطا کنید و فرایند کانال را بازراه‌اندازی کنید. |
| فرستنده پیام مستقیم مسدود شده است | `openclaw pairing list imessage` | جفت‌سازی را تأیید کنید یا فهرست مجاز را به‌روزرسانی کنید. |

راهنمای کامل عیب‌یابی:

- [عیب‌یابی iMessage](/fa/channels/imessage#troubleshooting)

## Signal

### امضاهای خرابی Signal

| نشانه | سریع‌ترین بررسی | رفع |
| ------------------------------- | ------------------------------------------ | -------------------------------------------------------- |
| daemon قابل دسترس است اما ربات ساکت است | `openclaw channels status --probe` | نشانی URL/حساب daemon مربوط به `signal-cli` و حالت دریافت را بررسی کنید. |
| پیام مستقیم مسدود شده است | `openclaw pairing list signal` | فرستنده را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید. |
| پاسخ‌های گروه فعال نمی‌شوند | فهرست مجاز گروه و الگوهای منشن را بررسی کنید | فرستنده/گروه را اضافه کنید یا دروازه‌بانی را آسان‌تر کنید. |

راهنمای کامل عیب‌یابی: [عیب‌یابی Signal](/fa/channels/signal#troubleshooting)

## QQ Bot

### امضاهای خرابی QQ Bot

| نشانه | سریع‌ترین بررسی | رفع |
| ------------------------------- | ------------------------------------------- | --------------------------------------------------------------- |
| ربات پاسخ می‌دهد «gone to Mars» | `appId` و `clientSecret` را در پیکربندی بررسی کنید | اعتبارنامه‌ها را تنظیم کنید یا Gateway را بازراه‌اندازی کنید. |
| پیام ورودی وجود ندارد | `openclaw channels status --probe` | اعتبارنامه‌ها را در QQ Open Platform بررسی کنید. |
| صدا رونوشت نمی‌شود | پیکربندی ارائه‌دهنده STT را بررسی کنید | `channels.qqbot.stt` یا `tools.media.audio` را پیکربندی کنید. |
| پیام‌های پیش‌دستانه نمی‌رسند | الزامات تعامل پلتفرم QQ را بررسی کنید | QQ ممکن است پیام‌های آغازشده توسط ربات را بدون تعامل اخیر مسدود کند. |

عیب‌یابی کامل: [عیب‌یابی QQ Bot](/fa/channels/qqbot#troubleshooting)

## Matrix

### امضاهای خطای Matrix

| نشانه                              | سریع‌ترین بررسی                         | رفع مشکل                                                                               |
| ---------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------- |
| وارد شده اما پیام‌های اتاق را نادیده می‌گیرد | `openclaw channels status --probe`      | `groupPolicy`، فهرست مجاز اتاق، و کنترل مبتنی بر منشن را بررسی کنید.                  |
| پیام‌های مستقیم پردازش نمی‌شوند    | `openclaw pairing list matrix`          | فرستنده را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید.                             |
| اتاق‌های رمزگذاری‌شده خطا می‌دهند | `openclaw matrix verify status`         | دستگاه را دوباره تأیید کنید، سپس `openclaw matrix verify backup status` را بررسی کنید. |
| بازیابی پشتیبان معلق/خراب است      | `openclaw matrix verify backup status`  | `openclaw matrix verify backup restore` را اجرا کنید یا دوباره با کلید بازیابی اجرا کنید. |
| امضای متقابل/راه‌اندازی اولیه نادرست به نظر می‌رسد | `openclaw matrix verify bootstrap`      | ذخیره‌سازی محرمانه، امضای متقابل، و وضعیت پشتیبان را در یک گذر ترمیم کنید.            |

راه‌اندازی و پیکربندی کامل: [Matrix](/fa/channels/matrix)

## مرتبط

- [جفت‌سازی](/fa/channels/pairing)
- [مسیریابی کانال](/fa/channels/channel-routing)
- [عیب‌یابی Gateway](/fa/gateway/troubleshooting)