گروه‌ها

OpenClaw قوانین گروه یکسانی را در همه کانال‌های دارای قابلیت گروه، از جمله Discord، iMessage، Matrix، Microsoft Teams، QQBot، Signal، Slack، Telegram، WhatsApp و Zalo اعمال می‌کند.

برای اتاق‌های همیشه‌فعالی که باید زمینه‌ای بی‌سروصدا فراهم کنند، مگر اینکه عامل صراحتاً پیامی قابل‌مشاهده ارسال کند، به رویدادهای محیطی اتاق مراجعه کنید.

مقدمه مبتدی (۲ دقیقه)

OpenClaw روی حساب‌های پیام‌رسان خودتان «زندگی می‌کند». کاربر ربات WhatsApp جداگانه‌ای وجود ندارد: اگر شما در گروهی باشید، OpenClaw می‌تواند آن گروه را ببیند و در آنجا پاسخ دهد.

رفتار پیش‌فرض:

• گروه‌ها محدود هستند (groupPolicy: "allowlist")؛ فرستندگان گروه تا زمانی که در فهرست مجاز قرار نگیرند، مسدود می‌شوند.
• پاسخ‌ها به اشاره نیاز دارند، مگر اینکه دروازه‌بانی اشاره را برای گروهی غیرفعال کنید.
• متن پاسخ نهایی به‌طور خودکار در اتاق ارسال می‌شود (visibleReplies: "automatic").

به‌عبارت دیگر: فرستندگان مجاز می‌توانند با اشاره به OpenClaw آن را فعال کنند.

روند سریع (آنچه برای یک پیام گروهی رخ می‌دهد):

groupPolicy؟ disabled -> کنار گذاشتنgroupPolicy؟ allowlist -> گروه مجاز است؟ خیر -> کنار گذاشتنrequireMention؟ بله -> اشاره شده؟ خیر -> فقط برای زمینه ذخیره شوداشاره/پاسخ/فرمان/پیام مستقیم -> درخواست کاربرگفت‌وگوی همیشه‌فعال گروه -> درخواست کاربر، یا در صورت پیکربندی رویداد اتاق

پاسخ‌های قابل‌مشاهده

برای درخواست‌های عادی گروه/کانال، پیش‌فرض OpenClaw برابر messages.groupChat.visibleReplies: "automatic" است: متن نهایی دستیار به‌عنوان پاسخ قابل‌مشاهده در اتاق ارسال می‌شود.

وقتی یک اتاق مشترک باید به عامل اجازه دهد با فراخوانی message(action=send) تصمیم بگیرد چه زمانی صحبت کند، از messages.groupChat.visibleReplies: "message_tool" استفاده کنید. این حالت با مدل‌هایی که در استفاده از ابزار قابل‌اعتماد هستند (برای مثال GPT-5.6 Sol) بهترین عملکرد را دارد. اگر مدل ابزار را نادیده بگیرد و متن نهایی معناداری برگرداند، OpenClaw به‌جای ارسال آن در اتاق، متن را خصوصی نگه می‌دارد.

برای مدل‌ها یا محیط‌های اجرایی که تحویل صرفاً از طریق ابزار را به‌طور قابل‌اعتماد رعایت نمی‌کنند، از "automatic" استفاده کنید: متن‌های نهایی عادی مستقیماً در اتاق ارسال می‌شوند و عامل همچنان می‌تواند برای فایل‌ها، تصاویر یا پیوست‌های دیگری که نمی‌توانند همراه متن نهایی ارسال شوند، message(action=send) را فراخوانی کند.

اگر ابزار پیام تحت سیاست ابزار فعال در دسترس نباشد، OpenClaw به‌جای سرکوب بی‌سروصدای پاسخ، به پاسخ‌های قابل‌مشاهده خودکار بازمی‌گردد. openclaw doctor درباره این ناسازگاری هشدار می‌دهد.

برای گفت‌وگوهای مستقیم و هر رویداد منبع دیگری، messages.visibleReplies: "message_tool" همان رفتار صرفاً ابزاری را به‌صورت سراسری اعمال می‌کند؛ messages.groupChat.visibleReplies همچنان بازنویسی اختصاصی‌تر برای اتاق‌های گروه/کانال است. نوبت‌های مستقیم WebChat داخلی به‌طور پیش‌فرض از تحویل خودکار پاسخ نهایی استفاده می‌کنند تا Pi و Codex قرارداد یکسانی برای پاسخ قابل‌مشاهده دریافت کنند.

حالت صرفاً ابزاری جایگزین الگوی قدیمی اجبار مدل به پاسخ‌دادن با NO_REPLY در بیشتر نوبت‌های حالت کمین می‌شود. در حالت صرفاً ابزاری، اعلان قراردادی برای NO_REPLY تعریف نمی‌کند؛ انجام‌ندادن هیچ کار قابل‌مشاهده‌ای صرفاً به‌معنای فراخوانی‌نکردن ابزار پیام است.

اتصال‌های مکالمه تحت مالکیت Plugin استثنا هستند. پس از اینکه یک Plugin رشته‌ای را متصل و نوبت ورودی را تصاحب کرد، پاسخ برگردانده‌شده Plugin همان پاسخ قابل‌مشاهده اتصال است؛ به message(action=send) نیازی ندارد. آن پاسخ خروجی محیط اجرایی Plugin است، نه متن نهایی خصوصی مدل.

نشانگرهای تایپ همچنان برای درخواست‌های مستقیم گروه ارسال می‌شوند. رویدادهای محیطی اتاق همیشه‌فعال، در صورت فعال‌بودن، سخت‌گیر و بی‌صدا باقی می‌مانند، مگر اینکه عامل ابزار پیام را فراخوانی کند.

نشست‌ها به‌طور پیش‌فرض خلاصه‌های مفصل ابزار/پیشرفت را سرکوب می‌کنند. هنگام اشکال‌زدایی، برای نمایش آن‌ها در نشست جاری از /verbose on (یا /verbose full) استفاده کنید و برای بازگشت به رفتار فقط پاسخ نهایی، /verbose off را به‌کار ببرید. وضعیت مفصل برای هر نشست جداگانه است و در گفت‌وگوهای مستقیم، گروه‌ها، کانال‌ها و موضوعات انجمن به یک شکل کار می‌کند.

برای ثبت گفت‌وگوی بدون اشاره گروه همیشه‌فعال به‌عنوان زمینه بی‌صدای اتاق به‌جای درخواست کاربر، از رویدادهای محیطی اتاق استفاده کنید:

{  messages: {    groupChat: {      unmentionedInbound: "room_event",    },  },}

پیش‌فرض unmentionedInbound: "user_request" است. پیام‌های دارای اشاره، فرمان‌ها، درخواست‌های توقف و پیام‌های مستقیم همچنان درخواست کاربر باقی می‌مانند.

برای الزام عبور خروجی قابل‌مشاهده از ابزار پیام در درخواست‌های گروه/کانال:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },}

برای الزام آن در همه گفت‌وگوهای منبع:

{  messages: {    visibleReplies: "message_tool",  },}

Gateway پس از ذخیره فایل، تغییرات پیکربندی messages را بدون راه‌اندازی مجدد دریافت می‌کند. فقط زمانی راه‌اندازی مجدد کنید که بارگذاری مجدد پیکربندی غیرفعال باشد (gateway.reload.mode: "off").

نوبت‌های فرمان visibleReplies: "message_tool" را دور می‌زنند و همیشه به‌صورت قابل‌مشاهده پاسخ می‌دهند: هم فرمان‌های اسلش بومی (Discord، Telegram و سایر سطوح دارای پشتیبانی بومی فرمان) و هم فرمان‌های متنی مجاز /... پاسخ خود را در گفت‌وگوی منبع ارسال می‌کنند. نوبت‌های متنی غیرمجاز /... در گروه‌ها صرفاً ابزاری باقی می‌مانند؛ نوبت‌های عادی گفت‌وگو از پیش‌فرض پیکربندی‌شده پیروی می‌کنند.

مشاهده‌پذیری زمینه و فهرست‌های مجاز

دو کنترل متفاوت در ایمنی گروه نقش دارند:

• مجوز فعال‌سازی: چه کسی می‌تواند عامل را فعال کند (groupPolicy، groups، groupAllowFrom، فهرست‌های مجاز مختص کانال).
• مشاهده‌پذیری زمینه: چه زمینه تکمیلی به مدل تزریق می‌شود (متن پاسخ/نقل‌قول، تاریخچه رشته، فراداده بازارسال‌شده).

به‌طور پیش‌فرض، OpenClaw زمینه را همان‌گونه که دریافت شده نگه می‌دارد: فهرست‌های مجاز تعیین می‌کنند چه کسی می‌تواند اقدام‌ها را فعال کند، نه اینکه مدل چه قطعه‌های نقل‌قول‌شده یا تاریخی را می‌بیند. برای فیلترکردن زمینه تکمیلی نیز contextVisibility را تنظیم کنید:

آن را برای هر کانال (channels.<channel>.contextVisibility)، هر حساب (channels.<channel>.accounts.<accountId>.contextVisibility) یا به‌صورت سراسری (channels.defaults.contextVisibility) تنظیم کنید. کانال‌هایی که زمینه تکمیلی را واکشی می‌کنند (Discord، Feishu، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp)، هنگام ساخت زمینه ورودی این سیاست را اعمال می‌کنند؛ ترکیب‌های سیاست ناشناخته به‌صورت بسته شکست می‌خورند و زمینه را حذف می‌کنند.

این حالت‌ها فقط زمینه تکمیلی فراهم‌شده توسط کانال را فیلتر می‌کنند. سیاست ابزار و موجودی ابزار مختص مالک همچنان بر اساس درخواست‌کننده مبدأ نوبت جاری انتخاب می‌شوند، نه همه فرستندگانی که در اعلان حضور دارند. به کنترل‌های محدود به درخواست‌کننده و زمینه اعلان مراجعه کنید.

اگر می‌خواهید...

برای فهرست‌های مجاز فرستنده با قابلیت استفاده مجدد، به گروه‌های دسترسی مراجعه کنید.

کلیدهای نشست

• نشست‌های گروه از کلیدهای نشست agent:<agentId>:<channel>:group:<id> استفاده می‌کنند (اتاق‌ها/کانال‌ها از agent:<agentId>:<channel>:channel:<id> استفاده می‌کنند).
• موضوعات انجمن Telegram مقدار :topic:<threadId> را به شناسه گروه اضافه می‌کنند تا هر موضوع نشست مخصوص خود را داشته باشد.
• گفت‌وگوهای مستقیم از نشست اصلی استفاده می‌کنند (یا اگر session.dmScope پیکربندی شده باشد، نشست‌های جداگانه برای هر فرستنده).
• Heartbeatها در نشست Heartbeat پیکربندی‌شده اجرا می‌شوند (پیش‌فرض: نشست اصلی عامل)؛ نشست‌های گروه Heartbeatهای خودشان را اجرا نمی‌کنند.

الگو: پیام‌های مستقیم شخصی + گروه‌های عمومی (یک عامل)

بله — اگر ترافیک «شخصی» شما پیام‌های مستقیم و ترافیک «عمومی» شما گروه‌ها باشد، این روش به‌خوبی کار می‌کند.

دلیل: در حالت تک‌عاملی، پیام‌های مستقیم معمولاً وارد کلید نشست اصلی (agent:main:main) می‌شوند، درحالی‌که گروه‌ها همیشه از کلیدهای نشست غیراصلی (agent:main:<channel>:group:<id>) استفاده می‌کنند. اگر جداسازی را با mode: "non-main" فعال کنید، آن نشست‌های گروه در بک‌اند جداسازی پیکربندی‌شده اجرا می‌شوند، درحالی‌که نشست اصلی پیام مستقیم شما روی میزبان باقی می‌ماند. اگر بک‌اندی انتخاب نکنید، Docker بک‌اند پیش‌فرض است.

این تنظیم یک «مغز» عامل (فضای کاری + حافظه مشترک)، اما دو وضعیت اجرایی به شما می‌دهد:

• پیام‌های مستقیم: ابزارهای کامل (میزبان)
• گروه‌ها: محیط ایزوله + ابزارهای محدود

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // گروه‌ها/کانال‌ها غیراصلی هستند -> در محیط ایزوله        scope: "session", // قوی‌ترین جداسازی (یک کانتینر برای هر گروه/کانال)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // اگر allow خالی نباشد، همه موارد دیگر مسدود می‌شوند (deny همچنان اولویت دارد).        allow: ["group:messaging", "group:sessions"],        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],      },    },  },}

{  agents: {    defaults: {      sandbox: {        mode: "non-main",        scope: "session",        workspaceAccess: "none",        docker: {          binds: [            // hostPath:containerPath:mode            "/home/user/FriendsShared:/data:ro",          ],        },      },    },  },}

مرتبط:

• کلیدهای پیکربندی و پیش‌فرض‌ها: پیکربندی Gateway
• اشکال‌زدایی علت مسدودشدن ابزار: محیط ایزوله در برابر سیاست ابزار در برابر دسترسی ارتقایافته
• جزئیات سوارکردن اتصال‌ها: جداسازی

برچسب‌های نمایشی

• برچسب‌های رابط کاربری در صورت وجود از displayName استفاده می‌کنند که به‌شکل <channel>:<token> قالب‌بندی می‌شود.
• #room برای اتاق‌ها/کانال‌ها رزرو شده است؛ گفت‌وگوهای گروهی از g-<slug> استفاده می‌کنند (حروف کوچک، فاصله‌ها -> -، حفظ #@+._-). شناسه‌های مبهم و بسیار طولانی به توکنی پایدار کوتاه می‌شوند تا شناسه‌های کامل مسیر در رابط کاربری افشا نشوند.

سیاست گروه

نحوه مدیریت پیام‌های گروه/اتاق را برای هر کانال کنترل کنید:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // شناسه عددی کاربر Telegram (راه‌اندازی @username را تفکیک می‌کند)    },    signal: {      groupPolicy: "disabled",      groupAllowFrom: ["+15551234567"],    },    imessage: {      groupPolicy: "disabled",      groupAllowFrom: ["chat_id:123"],    },    msteams: {      groupPolicy: "disabled",      groupAllowFrom: ["user@org.com"],    },    discord: {      groupPolicy: "allowlist",      guilds: {        GUILD_ID: { channels: { help: { enabled: true } } },      },    },    slack: {      groupPolicy: "allowlist",      channels: { "#general": { enabled: true } },    },    matrix: {      groupPolicy: "allowlist",      groupAllowFrom: ["@owner:example.org"],      groups: {        "!roomId:example.org": { enabled: true },        "#alias:example.org": { enabled: true },      },    },  },}

مدل ذهنی سریع (ترتیب ارزیابی پیام‌های گروهی):

الزام اشاره (پیش‌فرض)

پیام‌های گروهی به اشاره نیاز دارند، مگر آنکه برای هر گروه بازنویسی شده باشد. مقادیر پیش‌فرض هر زیرسامانه در *.groups."*" قرار دارند.

واقعیت‌های اشاره ضمنی پشتیبانی‌شده مختص هر کانال هستند:

وقتی کانال هر واقعیت را تولید می‌کند، آن واقعیت به‌طور پیش‌فرض فعال است. پرچم متناظر implicitMentions را روی false تنظیم کنید تا آن واقعیت دیگر الزام اشاره را دور نزند؛ اشاره‌های صریح بومی تحت‌تأثیر قرار نمی‌گیرند. این پرچم روی کانال‌هایی که آن واقعیت را تولید نمی‌کنند اثری ندارد.

{  channels: {    whatsapp: {      groups: {        "*": { requireMention: true },        "123@g.us": { requireMention: false },      },    },    telegram: {      groups: {        "*": { requireMention: true },        "123456789": { requireMention: false },      },    },    imessage: {      groups: {        "*": { requireMention: true },        "123": { requireMention: false },      },    },  },  agents: {    entries: {      main: {        groupChat: {          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],          historyLimit: 50,        },      },    },  },}

محدودکردن دامنه الگوهای اشاره پیکربندی‌شده

‏mentionPatterns پیکربندی‌شده، محرک‌های جایگزین عبارت منظم هستند. زمانی از آن‌ها استفاده کنید که پلتفرم اشاره بومی به ربات را ارائه نمی‌کند، یا می‌خواهید متن ساده‌ای مانند openclaw: به‌عنوان اشاره محسوب شود. اشاره‌های بومی پلتفرم جدا هستند: وقتی Discord، Slack، Telegram، Matrix، Signal یا کانال دیگری بتواند ثابت کند پیام به‌صراحت به ربات اشاره کرده است، آن اشاره بومی حتی در صورت ردشدن الگوهای عبارت منظم پیکربندی‌شده همچنان فعال می‌شود.

به‌طور پیش‌فرض، الگوهای اشاره پیکربندی‌شده در هر جایی اعمال می‌شوند که کانال، واقعیت‌های ارائه‌دهنده و مکالمه را به تشخیص اشاره منتقل کند. برای جلوگیری از اینکه الگوهای گسترده عامل را در همه گروه‌ها فعال کنند، دامنه آن‌ها را برای هر کانال با channels.<channel>.mentionPatterns محدود کنید.

وقتی الگوهای عبارت منظم اشاره باید به‌طور پیش‌فرض برای یک کانال خاموش باشند، از mode: "deny" استفاده کنید و سپس اتاق‌های مشخص را با allowIn فعال کنید:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b", "\\bops bot\\b"],    },  },  channels: {    slack: {      mentionPatterns: {        mode: "deny",        allowIn: ["C0123OPS"],      },    },  },}

وقتی الگوهای عبارت منظم اشاره باید به‌طور گسترده اعمال شوند، از mode: "allow" پیش‌فرض استفاده کنید (یا mode را حذف کنید) و سپس آن‌ها را در اتاق‌های شلوغ با denyIn خاموش کنید:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b"],    },  },  channels: {    telegram: {      mentionPatterns: {        denyIn: ["-1001234567890", "-1001234567890:topic:42"],      },    },  },}

تفکیک سیاست:

سیاست عبارت منظم دامنه‌بندی‌شده‌ای که اکنون پشتیبانی می‌شود:

پیکربندی‌های کانال در سطح حساب، در کانال‌هایی که از چند حساب پشتیبانی می‌کنند، می‌توانند همین سیاست را زیر channels.<channel>.accounts.<accountId>.mentionPatterns تنظیم کنند. سیاست حساب برای آن حساب بر سیاست سطح بالای کانال اولویت دارد.

محدودیت‌های ابزار گروه/کانال (اختیاری)

برخی پیکربندی‌های کانال از محدودکردن ابزارهای در دسترس درون یک گروه/اتاق/کانال مشخص پشتیبانی می‌کنند.

• tools: مجاز/ردکردن ابزارها برای کل گروه (allow، ‏alsoAllow، ‏deny؛ رد اولویت دارد).
• toolsBySender: بازنویسی‌های هر فرستنده درون گروه. از پیشوندهای صریح کلید استفاده کنید: channel:<channelId>:<senderId>، ‏id:<senderId>، ‏e164:<phone>، ‏username:<handle>، ‏name:<displayName> و نویسه عام "*". شناسه‌های کانال از شناسه‌های متعارف کانال OpenClaw استفاده می‌کنند؛ نام‌های مستعاری مانند teams به msteams نرمال‌سازی می‌شوند. کلیدهای قدیمی بدون پیشوند همچنان پذیرفته می‌شوند، فقط به‌عنوان id: مطابقت داده می‌شوند و هشدار منسوخ‌شدن ثبت می‌کنند.

ترتیب تفکیک (مشخص‌ترین مورد اولویت دارد):

نمونه (Telegram):

{  channels: {    telegram: {      groups: {        "*": { tools: { deny: ["exec"] } },        "-1001234567890": {          tools: { deny: ["exec", "read", "write"] },          toolsBySender: {            "id:123456789": { alsoAllow: ["exec"] },          },        },      },    },  },}

فهرست‌های مجاز گروه‌ها

وقتی channels.whatsapp.groups، channels.telegram.groups یا channels.imessage.groups پیکربندی شود، کلیدها به‌عنوان فهرست مجاز گروه‌ها عمل می‌کنند. برای مجاز کردن همه گروه‌ها و درعین‌حال تنظیم رفتار پیش‌فرض اشاره، از "*" استفاده کنید.

کاربردهای رایج (کپی/جای‌گذاری):

{  channels: { whatsapp: { groupPolicy: "disabled" } },}

{  channels: {    whatsapp: {      groups: {        "123@g.us": { requireMention: true },        "456@g.us": { requireMention: false },      },    },  },}

{  channels: {    whatsapp: {      groups: { "*": { requireMention: true } },    },  },}

{  channels: {    whatsapp: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],      groups: { "*": { requireMention: true } },    },  },}

فعال‌سازی (فقط مالک)

مالکان گروه می‌توانند فعال‌سازی هر گروه را با یک پیام مستقل تغییر دهند:

• /activation mention
• /activation always

/activation یک فرمان اصلیِ محدود به مالک است و فقط در گفت‌وگوهای گروهی اعمال می‌شود. مالک یعنی فرستنده با commands.ownerAllowFrom مطابقت داشته باشد؛ فهرست‌های allowFrom کانال فقط دسترسی عادی به کانال و فرمان‌ها را کنترل می‌کنند. حالت ذخیره‌شده در کانال‌هایی که آن را بررسی می‌کنند (Google Chat، QQBot، Telegram، WhatsApp)، requireMention آن گروه را نادیده می‌گیرد و مقدمه اعلان سیستمی گروه در همه‌جا حالت فعال را بازتاب می‌دهد.

فیلدهای زمینه

محموله‌های ورودی گروه این موارد را تنظیم می‌کنند:

• ChatType=group
• GroupSubject (اگر مشخص باشد)
• GroupMembers (اگر مشخص باشد)
• WasMentioned (نتیجه محدودسازی بر اساس اشاره)
• موضوعات انجمن Telegram همچنین شامل MessageThreadId و IsForum هستند.

اعلان سیستمی عامل در نخستین نوبت یک نشست گروهی جدید (و پس از تغییر /activation) شامل مقدمه‌ای برای گروه است. این مقدمه به مدل یادآوری می‌کند که مانند یک انسان پاسخ دهد، خطوط خالی را به حداقل برساند، فاصله‌گذاری معمول گفت‌وگو را رعایت کند و از تایپ دنباله‌های تحت‌اللفظی \n خودداری کند. کانال‌هایی که حالت جدول اعلام‌شده آن‌ها جدول‌های بومی یا خام را حفظ نمی‌کند، استفاده از جدول‌های Markdown را نیز توصیه نمی‌کنند. نام گروه‌ها و برچسب‌های شرکت‌کنندگان که از کانال دریافت می‌شوند، به‌صورت فراداده نامطمئنِ حصارگذاری‌شده نمایش داده می‌شوند، نه دستورالعمل‌های سیستمی درون‌خطی.

جزئیات iMessage

• برای مسیریابی یا افزودن به فهرست مجاز، chat_id:<id> را ترجیح دهید.
• فهرست گفت‌وگوها: imsg chats --limit 20.
• پاسخ‌های گروهی همیشه به همان chat_id بازمی‌گردند.

اعلان‌های سیستمی WhatsApp

برای قواعد مرجع اعلان سیستمی WhatsApp، از جمله تفکیک اعلان گروهی و مستقیم، رفتار نویسه عام و معنای لغو تنظیمات در سطح حساب، به WhatsApp مراجعه کنید.

جزئیات WhatsApp

برای رفتار مختص WhatsApp (تزریق تاریخچه و جزئیات مدیریت اشاره)، به پیام‌های گروهی مراجعه کنید.

مرتبط

• گروه‌های پخش
• مسیریابی کانال
• پیام‌های گروهی
• جفت‌سازی