گروه‌ها

OpenClaw با گفت‌وگوهای گروهی در سطح‌های مختلف به‌صورت یکسان رفتار می‌کند: Discord، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo.

معرفی مقدماتی (۲ دقیقه)

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

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

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

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

جریان سریع (برای یک پیام گروهی چه اتفاقی می‌افتد):

groupPolicy? disabled -> dropgroupPolicy? allowlist -> group allowed? no -> droprequireMention? yes -> mentioned? no -> store for context onlyotherwise -> reply

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

برای اتاق‌های گروهی/کانالی، مقدار پیش‌فرض OpenClaw برای messages.groupChat.visibleReplies برابر "message_tool" است. openclaw doctor --fix این مقدار پیش‌فرض را در پیکربندی‌های کانال‌های پیکربندی‌شده‌ای که آن را ندارند می‌نویسد. یعنی agent همچنان نوبت را پردازش می‌کند و می‌تواند وضعیت حافظه/نشست را به‌روزرسانی کند، اما پاسخ نهایی عادی آن به‌طور خودکار در اتاق ارسال نمی‌شود. برای صحبت کردن به‌صورت قابل مشاهده، agent از message(action=send) استفاده می‌کند.

این پیش‌فرض به مدل/زمان اجرایی‌ای وابسته است که ابزارها را به‌طور قابل اعتماد فراخوانی کند. اگر لاگ‌ها متن assistant را نشان دهند اما didSendViaMessagingTool: false باشد، مدل به‌جای فراخوانی ابزار پیام، به‌صورت خصوصی پاسخ داده است. این شکست ارسال Discord/Slack/Telegram نیست. برای نشست‌های گروهی/کانالی از مدلی استفاده کنید که در فراخوانی ابزار قابل اعتماد باشد، یا messages.groupChat.visibleReplies: "automatic" را تنظیم کنید تا پاسخ‌های نهایی قابل مشاهده قدیمی بازیابی شوند.

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

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

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

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

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

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

Gateway پس از ذخیره فایل، پیکربندی messages را hot-reload می‌کند. فقط زمانی restart کنید که file watching یا reload پیکربندی در deployment غیرفعال باشد.

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

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

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

مشاهده‌پذیری زمینه و allowlist‌ها

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

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

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

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

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

کلیدهای نشست

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

الگو: DMهای شخصی + گروه‌های عمومی (یک agent)

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

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

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

• DMها: ابزارهای کامل (host)
• گروه‌ها: sandbox + ابزارهای محدودشده

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // groups/channels are non-main -> sandboxed        scope: "session", // strongest isolation (one container per group/channel)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // If allow is non-empty, everything else is blocked (deny still wins).        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
• اشکال‌زدایی اینکه چرا یک ابزار مسدود شده است: Sandbox در برابر سیاست ابزار در برابر Elevated
• جزئیات bind mountها: Sandboxing

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

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

سیاست گروه

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

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // numeric Telegram user id (wizard can resolve @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: { allow: true } } },      },    },    slack: {      groupPolicy: "allowlist",      channels: { "#general": { allow: true } },    },    matrix: {      groupPolicy: "allowlist",      groupAllowFrom: ["@owner:example.org"],      groups: {        "!roomId:example.org": { enabled: true },        "#alias:example.org": { enabled: true },      },    },  },}

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

دروازه‌گذاری بر اساس اشاره (پیش‌فرض)

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

پاسخ دادن به پیام ربات، وقتی کانال از فرادادهٔ پاسخ پشتیبانی می‌کند، به‌عنوان اشارهٔ ضمنی محسوب می‌شود. نقل‌قول کردن پیام ربات نیز در کانال‌هایی که فرادادهٔ نقل‌قول را ارائه می‌کنند می‌تواند به‌عنوان اشارهٔ ضمنی محسوب شود. موارد داخلی فعلی شامل Telegram، WhatsApp، Slack، Discord، Microsoft Teams و ZaloUser هستند.

{  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: {    list: [      {        id: "main",        groupChat: {          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],          historyLimit: 50,        },      },    ],  },}

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

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

• tools: مجاز/رد کردن ابزارها برای کل گروه.
• toolsBySender: بازنویسی‌های هر فرستنده درون گروه. از پیشوندهای کلید صریح استفاده کنید: channel:<channelId>:<senderId>، id:<senderId>، e164:<phone>، username:<handle>، name:<displayName> و wildcard "*". شناسه‌های کانال از شناسه‌های کانال متعارف 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

مالک با channels.whatsapp.allowFrom تعیین می‌شود (یا وقتی تنظیم نشده باشد، E.164 خود ربات). دستور را به‌عنوان یک پیام مستقل بفرستید. سطح‌های دیگر در حال حاضر /activation را نادیده می‌گیرند.

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

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

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

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

جزئیات iMessage

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

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

برای قواعد متعارف اعلان سیستم WhatsApp، از جمله حل اعلان گروه و مستقیم، رفتار wildcard و معناشناسی بازنویسی حساب، WhatsApp را ببینید.

جزئیات WhatsApp

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

مرتبط

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