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 حساب پیشفرض را بهروزرسانی کنید. |
| polling متوقف میشود یا اتصال مجدد کند است | openclaw logs --follow برای تشخیصهای polling |
ارتقا دهید؛ اگر بازراهاندازیها مثبت کاذب هستند، pollingStallThresholdMs را تنظیم کنید. توقفهای پایدار همچنان به پراکسی/DNS/IPv6 اشاره دارند. |
setMyCommands هنگام راهاندازی رد میشود |
لاگها را برای BOT_COMMANDS_TOO_MUCH بررسی کنید |
فرمانهای Telegram مربوط به Plugin/skill/سفارشی را کم کنید یا منوهای بومی را غیرفعال کنید. |
| ارتقا دادهاید و فهرست مجاز شما را مسدود میکند | openclaw security audit و فهرستهای مجاز پیکربندی |
openclaw doctor --fix را اجرا کنید یا @username را با شناسههای عددی فرستنده جایگزین کنید. |
راهنمای کامل عیبیابی: عیبیابی Telegram
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 را تأیید کنید، رویدادهای اتاق محیطی را بخوانید، یا برای درخواستهای عادی گروه messages.groupChat.visibleReplies: "automatic" را نگه دارید. |
| پاسخهای پیام مستقیم نمیرسند | openclaw pairing list discord |
جفتسازی پیام مستقیم را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید. |
راهنمای کامل عیبیابی: عیبیابی Discord
Slack
امضاهای خرابی Slack
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| حالت سوکت وصل است اما پاسخی نیست | openclaw channels status --probe |
توکن برنامه + توکن ربات و scopeهای لازم را بررسی کنید؛ در راهاندازیهای مبتنی بر 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 از یک wrapper مبتنی بر SSH استفاده کنید. |
| روی macOS میتواند ارسال کند اما دریافت نمیکند | مجوزهای حریم خصوصی macOS برای خودکارسازی Messages را بررسی کنید | مجوزهای TCC را دوباره اعطا کنید و فرایند کانال را بازراهاندازی کنید. |
| فرستنده پیام مستقیم مسدود شده است | openclaw pairing list imessage |
جفتسازی را تأیید کنید یا فهرست مجاز را بهروزرسانی کنید. |
راهنمای کامل عیبیابی:
Signal
امضاهای خرابی Signal
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| daemon قابل دسترس است اما ربات ساکت است | openclaw channels status --probe |
نشانی URL/حساب daemon مربوط به signal-cli و حالت دریافت را بررسی کنید. |
| پیام مستقیم مسدود شده است | openclaw pairing list signal |
فرستنده را تأیید کنید یا سیاست پیام مستقیم را تنظیم کنید. |
| پاسخهای گروه فعال نمیشوند | فهرست مجاز گروه و الگوهای منشن را بررسی کنید | فرستنده/گروه را اضافه کنید یا دروازهبانی را آسانتر کنید. |
راهنمای کامل عیبیابی: عیبیابی Signal
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
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?
