Configuration
عیبیابی کانال
از این صفحه زمانی استفاده کنید که یک کانال وصل میشود اما رفتار آن نادرست است.
نردبان فرمان
ابتدا اینها را بهترتیب اجرا کنید:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
خط مبنای سالم:
Runtime: runningConnectivity probe: okCapability: read-only،write-capable، یاadmin-capable- بررسی کانال نشان میدهد ترابری وصل است و، در صورت پشتیبانی،
worksیاaudit ok
امضاهای خرابی WhatsApp
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| وصل است اما پاسخ DM نمیآید | openclaw pairing list whatsapp |
فرستنده را تأیید کنید یا سیاست/allowlist مربوط به DM را تغییر دهید. |
| پیامهای گروه نادیده گرفته میشوند | requireMention و الگوهای اشاره را در پیکربندی بررسی کنید |
ربات را منشن کنید یا سیاست منشن را برای آن گروه آسانتر کنید. |
| ورود QR با 408 منقضی میشود | متغیرهای محیطی HTTPS_PROXY / HTTP_PROXY مربوط به Gateway را بررسی کنید |
یک پراکسی قابل دسترس تنظیم کنید؛ از NO_PROXY فقط برای دورزدنها استفاده کنید. |
| قطع اتصال/ورود دوباره تصادفی | openclaw channels status --probe + لاگها |
اتصالهای مجدد اخیر حتی وقتی اکنون وصل هستند علامتگذاری میشوند؛ لاگها را ببینید، Gateway را بازراهاندازی کنید، سپس اگر نوسان ادامه داشت دوباره لینک کنید. |
| پاسخها با چند ثانیه/دقیقه تأخیر میرسند | openclaw doctor --fix |
Doctor کلاینتهای محلی TUI مانده و تأییدشده را که حلقه رویداد Gateway را تضعیف میکنند متوقف میکند. |
عیبیابی کامل: عیبیابی WhatsApp
Telegram
امضاهای خرابی Telegram
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
/start اما جریان پاسخ قابل استفاده نیست |
openclaw pairing list telegram |
جفتسازی را تأیید کنید یا سیاست DM را تغییر دهید. |
| ربات آنلاین است اما گروه ساکت میماند | الزام منشن و حالت حریم خصوصی ربات را تأیید کنید | برای دیدهشدن در گروه، حالت حریم خصوصی را غیرفعال کنید یا ربات را منشن کنید. |
| شکست ارسال با خطاهای شبکه | لاگها را برای شکستهای فراخوانی 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 بررسی کنید |
فرمانهای Plugin/skill/سفارشی Telegram را کاهش دهید یا منوهای بومی را غیرفعال کنید. |
| ارتقا دادهاید و allowlist شما را مسدود میکند | openclaw security audit و allowlistهای پیکربندی |
openclaw doctor --fix را اجرا کنید یا @username را با شناسههای عددی فرستنده جایگزین کنید. |
عیبیابی کامل: عیبیابی Telegram
Discord
امضاهای خرابی Discord
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| ربات آنلاین است اما در guild پاسخی نمیدهد | openclaw channels status --probe |
guild/کانال را مجاز کنید و intent محتوای پیام را تأیید کنید. |
| پیامهای گروه نادیده گرفته میشوند | لاگها را برای حذفهای ناشی از دروازهگذاری منشن بررسی کنید | ربات را منشن کنید یا requireMention: false را برای guild/کانال تنظیم کنید. |
| استفاده از تایپ/توکن دیده میشود اما پیام Discord ارسال نمیشود | لاگ نشست متن دستیار را با didSendViaMessagingTool: false نشان میدهد |
مدل بهجای فراخوانی ابزار پیام، بهصورت خصوصی پاسخ داده است. از مدلی استفاده کنید که در فراخوانی ابزار قابل اعتماد است، یا messages.groupChat.visibleReplies: "automatic" را برای ارسال خودکار تنظیم کنید. |
| پاسخهای DM موجود نیستند | openclaw pairing list discord |
جفتسازی DM را تأیید کنید یا سیاست DM را تنظیم کنید. |
عیبیابی کامل: عیبیابی Discord
Slack
امضاهای خرابی Slack
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| حالت socket وصل است اما پاسخی نمیآید | openclaw channels status --probe |
توکن app + توکن bot و scopeهای لازم را تأیید کنید؛ در راهاندازیهای مبتنی بر SecretRef مراقب botTokenStatus / appTokenStatus = configured_unavailable باشید. |
| DMها مسدود شدهاند | openclaw pairing list slack |
جفتسازی را تأیید کنید یا سیاست DM را آسانتر کنید. |
| پیام کانال نادیده گرفته میشود | groupPolicy و allowlist کانال را بررسی کنید |
کانال را مجاز کنید یا سیاست را به open تغییر دهید. |
عیبیابی کامل: عیبیابی Slack
iMessage و BlueBubbles
امضاهای خرابی iMessage و BlueBubbles
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| هیچ رویداد ورودی وجود ندارد | دسترسی webhook/سرور و مجوزهای app را تأیید کنید | URL webhook یا وضعیت سرور BlueBubbles را اصلاح کنید. |
| میتواند ارسال کند اما روی macOS دریافت ندارد | مجوزهای حریم خصوصی macOS برای خودکارسازی Messages را بررسی کنید | مجوزهای TCC را دوباره بدهید و فرایند کانال را بازراهاندازی کنید. |
| فرستنده DM مسدود شده است | openclaw pairing list imessage یا openclaw pairing list bluebubbles |
جفتسازی را تأیید کنید یا allowlist را بهروزرسانی کنید. |
عیبیابی کامل:
Signal
امضاهای خرابی Signal
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| daemon در دسترس است اما ربات ساکت است | openclaw channels status --probe |
URL/حساب daemon مربوط به signal-cli و حالت دریافت را تأیید کنید. |
| DM مسدود شده است | openclaw pairing list signal |
فرستنده را تأیید کنید یا سیاست DM را تنظیم کنید. |
| پاسخهای گروه فعال نمیشوند | allowlist گروه و الگوهای منشن را بررسی کنید | فرستنده/گروه را اضافه کنید یا دروازهگذاری را آسانتر کنید. |
عیبیابی کامل: عیبیابی Signal
QQ Bot
امضاهای خرابی QQ Bot
| نشانه | سریعترین بررسی | رفع |
|---|---|---|
| ربات پاسخ میدهد «به مریخ رفته» | 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، allowlist اتاق، و دروازهگذاری منشن را بررسی کنید. |
| DMها پردازش نمیشوند | openclaw pairing list matrix |
فرستنده را تأیید کنید یا سیاست DM را تنظیم کنید. |
| اتاقهای رمزگذاریشده شکست میخورند | openclaw matrix verify status |
دستگاه را دوباره تأیید کنید، سپس openclaw matrix verify backup status را بررسی کنید. |
| بازیابی پشتیبان در انتظار/خراب است | openclaw matrix verify backup status |
openclaw matrix verify backup restore را اجرا کنید یا با کلید بازیابی دوباره اجرا کنید. |
| cross-signing/bootstrap نادرست به نظر میرسد | openclaw matrix verify bootstrap |
ذخیرهسازی secret، cross-signing، و وضعیت پشتیبان را در یک گذر تعمیر کنید. |
راهاندازی و پیکربندی کامل: Matrix