Configuration
عیبیابی کانال
هنگامی که یک کانال متصل میشود اما رفتارش نادرست است، از این صفحه استفاده کنید.
ترتیب فرمانها
ابتدا این فرمانها را بهترتیب اجرا کنید:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeخط مبنای سالم:
Runtime: runningConnectivity probe: okCapability: read-only،write-capableیاadmin-capable- کاوش کانال نشان میدهد که انتقال متصل است و در موارد پشتیبانیشده،
worksیاaudit ok
پس از بهروزرسانی
هنگامی که Telegram، iMessage، پیکربندیهای دورهٔ BlueBubbles یا کانال Plugin دیگری پس از بهروزرسانی ناپدید میشود، از این روش استفاده کنید.
openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --allدر 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?
