در این صفحه
در این صفحه
Configuration
عیب‌یابی کانال
هنگامی که یک کانال متصل می‌شود اما رفتارش نادرست است، از این صفحه استفاده کنید.
ترتیب فرمان‌ها
ابتدا این فرمان‌ها را به‌ترتیب اجرا کنید:
خط مبنای سالم:
Runtime: runningConnectivity probe: okCapability: read-only،write-capableیاadmin-capable- کاوش کانال نشان می‌دهد که انتقال متصل است و در موارد پشتیبانی‌شده،
worksیاaudit ok
پس از به‌روزرسانی
هنگامی که Telegram، iMessage، پیکربندی‌های دورهٔ BlueBubbles یا کانال Plugin دیگری پس از به‌روزرسانی ناپدید می‌شود، از این روش استفاده کنید.
در openclaw status --all به‌دنبال plugin load failed: dependency tree corrupted; run openclaw doctor --fix بگردید. این یعنی کانال پیکربندی شده است، اما راه‌اندازی یا بارگذاری Plugin به‌جای ثبت کانال با درخت وابستگی خراب مواجه شده است. openclaw doctor --fix پیوندهای نمادین منسوخ وابستگی‌های زمان اجرای Plugin و سایه‌های منسوخ احراز هویت را پاک می‌کند، سپس openclaw gateway restart وضعیت پاک را دوباره بارگذاری می‌کند.
نشانه‌های خرابی 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
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 برای تشخیص نظرسنجی |
ارتقا دهید؛ توقف‌های مداوم معمولاً به پراکسی/DNS/IPv6 اشاره دارند. |
setMyCommands هنگام راه‌اندازی رد می‌شود |
گزارش‌ها را برای BOT_COMMANDS_TOO_MUCH بررسی کنید |
فرمان‌های Telegram مربوط به Plugin، مهارت یا سفارشی را کاهش دهید یا منوهای بومی را غیرفعال کنید. |
| پس از ارتقا، فهرست مجاز شما را مسدود می‌کند | openclaw security audit و فهرست‌های مجاز پیکربندی |
openclaw doctor --fix را اجرا کنید یا @username را با شناسه‌های عددی فرستنده جایگزین کنید. |
عیب‌یابی کامل: عیب‌یابی Telegram
Discord
نشانه‌های خرابی Discord
| نشانه | سریع‌ترین بررسی | راه‌حل |
|---|---|---|
| ربات آنلاین است اما در انجمن پاسخ نمی‌دهد | openclaw channels status --probe |
انجمن/کانال را مجاز کنید و intent محتوای پیام را بررسی کنید. |
| پیام‌های گروه نادیده گرفته می‌شوند | گزارش‌ها را برای حذف‌های ناشی از شرط اشاره بررسی کنید | به ربات اشاره کنید یا requireMention: false انجمن/کانال را تنظیم کنید. |
| استفاده از تایپ/توکن وجود دارد اما پیام Discord ارسال نمی‌شود | بررسی کنید که آیا این یک رویداد اتاق محیطی است یا اتاق message_tool که داوطلبانه فعال شده و مدل در آن message(action=send) را از دست داده است |
گزارش مفصل Gateway را برای فرادادهٔ payload نهایی سرکوب‌شده بررسی کنید، messages.groupChat.unmentionedInbound را تأیید کنید، رویدادهای اتاق محیطی را بخوانید یا برای درخواست‌های عادی گروهی messages.groupChat.visibleReplies: "automatic" را حفظ کنید. |
| پاسخ‌های پیام مستقیم وجود ندارند | openclaw pairing list discord |
جفت‌سازی پیام مستقیم را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید. |
عیب‌یابی کامل: عیب‌یابی Discord
Slack
نشانه‌های خرابی Slack
| نشانه | سریع‌ترین بررسی | راه‌حل |
|---|---|---|
| حالت سوکت متصل است اما پاسخی وجود ندارد | openclaw channels status --probe |
توکن برنامه، توکن ربات و محدوده‌های لازم را تأیید کنید؛ در راه‌اندازی‌های مبتنی بر SecretRef مراقب botTokenStatus / appTokenStatus = configured_unavailable باشید. |
| پیام‌های مستقیم مسدود شده‌اند | openclaw pairing list slack |
جفت‌سازی را تأیید کنید یا سیاست پیام مستقیم را آسان‌گیرانه‌تر کنید. |
| پیام کانال نادیده گرفته می‌شود | groupPolicy و فهرست مجاز کانال را بررسی کنید |
کانال را مجاز کنید یا سیاست را به open تغییر دهید. |
عیب‌یابی کامل: عیب‌یابی Slack
iMessage
نشانه‌های خرابی iMessage
| نشانه | سریع‌ترین بررسی | راه‌حل |
|---|---|---|
imsg وجود ندارد یا در محیطی غیر از macOS شکست می‌خورد |
openclaw channels status --probe --channel imessage |
OpenClaw را روی Mac دارای Messages اجرا کنید یا برای cliPath از یک پوشش SSH استفاده کنید. |
| در macOS ارسال ممکن است اما دریافت انجام نمی‌شود | مجوزهای حریم خصوصی macOS را برای خودکارسازی Messages بررسی کنید | مجوزهای TCC را دوباره اعطا و فرایند کانال را راه‌اندازی مجدد کنید. |
| فرستندهٔ پیام مستقیم مسدود شده است | openclaw pairing list imessage |
جفت‌سازی را تأیید کنید یا فهرست مجاز را به‌روزرسانی کنید. |
عیب‌یابی کامل: عیب‌یابی iMessage
Signal
نشانه‌های خرابی Signal
| نشانه | سریع‌ترین بررسی | راه‌حل |
|---|---|---|
| دیمن قابل‌دسترسی است اما ربات ساکت است | openclaw channels status --probe |
نشانی اینترنتی/حساب دیمن signal-cli و حالت دریافت را تأیید کنید. |
| پیام مستقیم مسدود شده است | openclaw pairing list signal |
فرستنده را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید. |
| پاسخ‌های گروه فعال نمی‌شوند | فهرست مجاز گروه و الگوهای اشاره را بررسی کنید | فرستنده/گروه را اضافه کنید یا محدودیت‌ها را کاهش دهید. |
عیب‌یابی کامل: عیب‌یابی Signal
ربات QQ
نشانه‌های خرابی ربات QQ
| نشانه | سریع‌ترین بررسی | راه‌حل |
|---|---|---|
| ربات پاسخ می‌دهد «به مریخ رفته است» | appId و clientSecret را در پیکربندی تأیید کنید |
اعتبارنامه‌ها را تنظیم کنید یا Gateway را راه‌اندازی مجدد کنید. |
| هیچ پیام ورودی وجود ندارد | openclaw channels status --probe |
اعتبارنامه‌ها را در QQ Open Platform تأیید کنید. |
| صدا رونویسی نمی‌شود | پیکربندی ارائه‌دهندهٔ STT را بررسی کنید | channels.qqbot.stt یا tools.media.audio را پیکربندی کنید. |
| پیام‌های پیش‌دستانه نمی‌رسند | الزامات تعامل پلتفرم QQ را بررسی کنید | QQ ممکن است پیام‌هایی را که ربات بدون تعامل اخیر آغاز کرده است مسدود کند. |
عیب‌یابی کامل: عیب‌یابی ربات QQ
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
مرتبط
Was this useful?
