---
read_when:
    - انتقال‌دهندهٔ کانال متصل بودن را نشان می‌دهد، اما پاسخ‌ها ارسال نمی‌شوند
    - پیش از بررسی عمیق مستندات ارائه‌دهنده، باید بررسی‌های مختص کانال را انجام دهید
summary: عیب‌یابی سریع در سطح کانال با نشانه‌های خرابی و راهکارهای رفع مختص هر کانال
title: عیب‌یابی کانال
x-i18n:
    generated_at: "2026-07-12T09:37:11Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d2699b48ed6ab1f702789d2180daa43aed6ee83023889d0d8821faceb9a943b5
    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` حساب پیش‌فرض را به‌روزرسانی کنید. |
| نمونه‌برداری متوقف می‌شود یا اتصال مجدد کند است | برای تشخیص مشکلات نمونه‌برداری از `openclaw logs --follow` استفاده کنید | ارتقا دهید؛ اگر راه‌اندازی‌های مجدد تشخیص‌های مثبت کاذب هستند، `pollingStallThresholdMs` را تنظیم کنید. توقف‌های مداوم همچنان نشان‌دهندهٔ مشکل پراکسی/DNS/IPv6 هستند. |
| `setMyCommands` هنگام راه‌اندازی رد می‌شود | گزارش‌ها را برای `BOT_COMMANDS_TOO_MUCH` بررسی کنید | فرمان‌های Plugin، Skills یا سفارشی Telegram را کاهش دهید یا منوهای بومی را غیرفعال کنید. |
| پس از ارتقا فهرست مجاز دسترسی شما را مسدود می‌کند | `openclaw security audit` و فهرست‌های مجاز پیکربندی | `openclaw doctor --fix` را اجرا کنید یا `@username` را با شناسه‌های عددی فرستنده جایگزین کنید. |

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

## Discord

### نشانه‌های خرابی Discord

| نشانه | سریع‌ترین بررسی | راه‌حل |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ربات آنلاین است اما در سرور پاسخ نمی‌دهد | `openclaw channels status --probe` | سرور/کانال را مجاز کنید و فعال بودن دسترسی به محتوای پیام را بررسی کنید. |
| پیام‌های گروه نادیده گرفته می‌شوند | گزارش‌ها را برای حذف پیام‌ها به‌دلیل دروازهٔ اشاره بررسی کنید | به ربات اشاره کنید یا `requireMention: false` را برای سرور/کانال تنظیم کنید. |
| تایپ/مصرف توکن رخ می‌دهد اما پیامی در Discord دیده نمی‌شود | بررسی کنید که آیا این یک رویداد اتاق محیطی است یا اتاقی با `message_tool` فعال که در آن مدل `message(action=send)` را اجرا نکرده است | گزارش مفصل Gateway را برای فرادادهٔ محمولهٔ نهایی سرکوب‌شده بررسی کنید، `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` | توکن برنامه، توکن ربات و دامنه‌های دسترسی لازم را بررسی کنید؛ در راه‌اندازی‌های مبتنی بر 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 را روی مکِ دارای Messages اجرا کنید یا برای `cliPath` از یک پوشش SSH استفاده کنید. |
| در macOS ارسال انجام می‌شود اما دریافتی وجود ندارد | مجوزهای حریم خصوصی macOS برای خودکارسازی Messages را بررسی کنید | مجوزهای TCC را دوباره اعطا کنید و فرایند کانال را راه‌اندازی مجدد کنید. |
| فرستندهٔ پیام مستقیم مسدود شده است | `openclaw pairing list imessage` | جفت‌سازی را تأیید کنید یا فهرست مجاز را به‌روزرسانی کنید. |

عیب‌یابی کامل: [عیب‌یابی iMessage](/fa/channels/imessage#troubleshooting)

## Signal

### نشانه‌های خرابی Signal

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

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

## ربات QQ

### نشانه‌های خرابی ربات QQ

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

عیب‌یابی کامل: [عیب‌یابی ربات QQ](/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)