Configuration
عیبیابی کانال
از این صفحه زمانی استفاده کنید که یک کانال وصل میشود اما رفتار آن نادرست است.
ترتیب فرمانها
ابتدا اینها را بهترتیب اجرا کنید:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeمبنای سالم:
Runtime: runningConnectivity probe: okCapability: read-only،write-capable، یاadmin-capable- بررسی کانال نشان میدهد ترابری وصل است و، در صورت پشتیبانی،
worksیاaudit ok
نشانههای خرابی WhatsApp
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
| وصل است اما پاسخ DM نمیدهد | openclaw pairing list whatsapp |
فرستنده را تأیید کنید یا سیاست/فهرست مجاز DM را تغییر دهید. |
| پیامهای گروهی نادیده گرفته میشوند | پیکربندی requireMention و الگوهای اشاره را بررسی کنید |
بات را mention کنید یا سیاست mention را برای آن گروه آسانتر کنید. |
| ورود با QR با 408 منقضی میشود | متغیر محیطی HTTPS_PROXY / HTTP_PROXY مربوط به Gateway را بررسی کنید |
یک پراکسی قابل دسترس تنظیم کنید؛ از NO_PROXY فقط برای bypassها استفاده کنید. |
| قطع اتصال/ورود دوباره تصادفی | openclaw channels status --probe + لاگها |
reconnectهای اخیر حتی وقتی اکنون وصل است هم علامتگذاری میشوند؛ لاگها را زیر نظر بگیرید، Gateway را بازراهاندازی کنید، سپس اگر نوسان ادامه داشت دوباره لینک کنید. |
| پاسخها با چند ثانیه/دقیقه تأخیر میرسند | openclaw doctor --fix |
Doctor کلاینتهای TUI محلی stale و تأییدشده را، وقتی چرخه رویداد Gateway را تضعیف میکنند، متوقف میکند. |
عیبیابی کامل: عیبیابی WhatsApp
Telegram
نشانههای خرابی Telegram
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
/start اما جریان پاسخ قابل استفاده ندارد |
openclaw pairing list telegram |
pairing را تأیید کنید یا سیاست DM را تغییر دهید. |
| بات آنلاین است اما گروه ساکت میماند | الزام mention و حالت privacy بات را بررسی کنید | برای دیدهشدن در گروه، حالت privacy را غیرفعال کنید یا بات را mention کنید. |
| خطاهای ارسال با خطاهای شبکه | لاگها را برای خطاهای فراخوانی API Telegram بررسی کنید | مسیریابی DNS/IPv6/پراکسی به api.telegram.org را اصلاح کنید. |
راهاندازی گزارش میدهد getMe returned 401 |
منبع token پیکربندیشده را بررسی کنید | token مربوط به BotFather را دوباره کپی یا بازتولید کنید و botToken، tokenFile، یا TELEGRAM_BOT_TOKEN حساب پیشفرض را بهروزرسانی کنید. |
| polling متوقف میشود یا کند دوباره وصل میشود | openclaw logs --follow برای تشخیصهای polling |
ارتقا دهید؛ اگر restarts مثبت کاذب هستند، pollingStallThresholdMs را تنظیم کنید. توقفهای پایدار همچنان به پراکسی/DNS/IPv6 اشاره دارند. |
setMyCommands هنگام راهاندازی رد میشود |
لاگها را برای BOT_COMMANDS_TOO_MUCH بررسی کنید |
فرمانهای Telegram مربوط به plugin/skill/سفارشی را کاهش دهید یا منوهای native را غیرفعال کنید. |
| پس از ارتقا، allowlist شما را مسدود میکند | openclaw security audit و allowlistهای پیکربندی |
openclaw doctor --fix را اجرا کنید یا @username را با شناسههای عددی فرستنده جایگزین کنید. |
عیبیابی کامل: عیبیابی Telegram
Discord
نشانههای خرابی Discord
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
| بات آنلاین است اما در guild پاسخ نمیدهد | openclaw channels status --probe |
guild/channel را مجاز کنید و message content intent را تأیید کنید. |
| پیامهای گروهی نادیده گرفته میشوند | لاگها را برای حذفهای ناشی از mention gating بررسی کنید | بات را mention کنید یا requireMention: false را برای guild/channel تنظیم کنید. |
| استفاده از typing/token هست اما پیام Discord نیست | لاگ نشست متن دستیار را با didSendViaMessagingTool: false نشان میدهد |
مدل بهجای فراخوانی ابزار پیامرسانی، خصوصی پاسخ داده است. از مدلی با قابلیت اتکای بالا در tool-call استفاده کنید، یا messages.groupChat.visibleReplies: "automatic" را برای ارسال خودکار تنظیم کنید. |
| پاسخهای DM وجود ندارند | openclaw pairing list discord |
pairing مربوط به DM را تأیید کنید یا سیاست DM را تنظیم کنید. |
عیبیابی کامل: عیبیابی Discord
Slack
نشانههای خرابی Slack
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
| socket mode وصل است اما پاسخی نیست | openclaw channels status --probe |
app token + bot token و scopeهای لازم را تأیید کنید؛ در راهاندازیهای مبتنی بر SecretRef مراقب botTokenStatus / appTokenStatus = configured_unavailable باشید. |
| DMها مسدود شدهاند | openclaw pairing list slack |
pairing را تأیید کنید یا سیاست DM را آسانتر کنید. |
| پیام کانال نادیده گرفته میشود | groupPolicy و allowlist کانال را بررسی کنید |
کانال را مجاز کنید یا سیاست را به open تغییر دهید. |
عیبیابی کامل: عیبیابی Slack
iMessage
نشانههای خرابی iMessage
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
imsg وجود ندارد یا روی غیر macOS شکست میخورد |
openclaw channels status --probe --channel imessage |
OpenClaw را روی Mac دارای Messages اجرا کنید یا از یک wrapper SSH برای cliPath استفاده کنید. |
| روی macOS میتواند ارسال کند اما دریافت ندارد | مجوزهای privacy macOS برای automation در Messages را بررسی کنید | مجوزهای TCC را دوباره اعطا کنید و فرایند کانال را بازراهاندازی کنید. |
| فرستنده DM مسدود شده است | openclaw pairing list imessage |
pairing را تأیید کنید یا allowlist را بهروزرسانی کنید. |
عیبیابی کامل:
Signal
نشانههای خرابی Signal
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
| Daemon قابل دسترس است اما بات ساکت است | openclaw channels status --probe |
نشانی URL/حساب daemon مربوط به signal-cli و حالت دریافت را تأیید کنید. |
| DM مسدود شده است | openclaw pairing list signal |
فرستنده را تأیید کنید یا سیاست DM را تنظیم کنید. |
| پاسخهای گروهی فعال نمیشوند | allowlist گروه و الگوهای mention را بررسی کنید | فرستنده/گروه را اضافه کنید یا gating را آسانتر کنید. |
عیبیابی کامل: عیبیابی Signal
QQ Bot
نشانههای خرابی QQ Bot
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
| بات پاسخ میدهد "gone to Mars" | appId و clientSecret را در پیکربندی تأیید کنید |
credentials را تنظیم کنید یا Gateway را بازراهاندازی کنید. |
| پیامهای ورودی وجود ندارند | openclaw channels status --probe |
credentials را در QQ Open Platform تأیید کنید. |
| voice رونویسی نمیشود | پیکربندی ارائهدهنده STT را بررسی کنید | channels.qqbot.stt یا tools.media.audio را پیکربندی کنید. |
| پیامهای proactive نمیرسند | الزامات interaction پلتفرم QQ را بررسی کنید | QQ ممکن است پیامهای آغازشده توسط بات را بدون interaction اخیر مسدود کند. |
عیبیابی کامل: عیبیابی QQ Bot
Matrix
نشانههای خرابی Matrix
| نشانه | سریعترین بررسی | رفع مشکل |
|---|---|---|
| وارد شده اما پیامهای اتاق را نادیده میگیرد | openclaw channels status --probe |
groupPolicy، allowlist اتاق، و mention gating را بررسی کنید. |
| DMها پردازش نمیشوند | openclaw pairing list matrix |
فرستنده را تأیید کنید یا سیاست DM را تنظیم کنید. |
| اتاقهای رمزگذاریشده شکست میخورند | openclaw matrix verify status |
دستگاه را دوباره تأیید کنید، سپس openclaw matrix verify backup status را بررسی کنید. |
| بازیابی backup در انتظار/خراب است | openclaw matrix verify backup status |
openclaw matrix verify backup restore را اجرا کنید یا با recovery key دوباره اجرا کنید. |
| cross-signing/bootstrap نادرست به نظر میرسد | openclaw matrix verify bootstrap |
secret storage، cross-signing، و وضعیت backup را در یک گذر ترمیم کنید. |
راهاندازی و پیکربندی کامل: Matrix