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 استفاده کنید |
ارتقا دهید؛ اگر راهاندازیهای مجدد تشخیصهای مثبت کاذب هستند، pollingStallThresholdMs را تنظیم کنید. توقفهای مداوم همچنان نشاندهندهٔ مشکل پراکسی/DNS/IPv6 هستند. |
setMyCommands هنگام راهاندازی رد میشود |
گزارشها را برای BOT_COMMANDS_TOO_MUCH بررسی کنید |
فرمانهای Plugin، Skills یا سفارشی Telegram را کاهش دهید یا منوهای بومی را غیرفعال کنید. |
| پس از ارتقا فهرست مجاز دسترسی شما را مسدود میکند | openclaw security audit و فهرستهای مجاز پیکربندی |
openclaw doctor --fix را اجرا کنید یا @username را با شناسههای عددی فرستنده جایگزین کنید. |
عیبیابی کامل: عیبیابی Telegram
Discord
نشانههای خرابی Discord
| نشانه | سریعترین بررسی | راهحل |
|---|---|---|
| ربات آنلاین است اما در سرور پاسخ نمیدهد | openclaw channels status --probe |
سرور/کانال را مجاز کنید و فعال بودن دسترسی به محتوای پیام را بررسی کنید. |
| پیامهای گروه نادیده گرفته میشوند | گزارشها را برای حذف پیامها بهدلیل دروازهٔ اشاره بررسی کنید | به ربات اشاره کنید یا requireMention: false را برای سرور/کانال تنظیم کنید. |
| تایپ/مصرف توکن رخ میدهد اما پیامی در Discord دیده نمیشود | بررسی کنید که آیا این یک رویداد اتاق محیطی است یا اتاقی با message_tool فعال که در آن مدل message(action=send) را اجرا نکرده است |
گزارش مفصل Gateway را برای فرادادهٔ محمولهٔ نهایی سرکوبشده بررسی کنید، 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 را روی مکِ دارای 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?
