رویدادهای محیطی اتاق

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

برای گفت‌وگوهای گروهی همیشه‌فعال، این حالت توصیه‌شده است: messages.groupChat.unmentionedInbound: "room_event" را با messages.groupChat.visibleReplies: "message_tool" ترکیب کنید. زمانی از آن استفاده کنید که عامل باید گوش بدهد، تصمیم بگیرد چه زمانی پاسخ مفید است، و از الگوی قدیمی پرامپت برای پاسخ دادن با NO_REPLY پرهیز کند.

در حال حاضر پشتیبانی می‌شود: کانال‌های سرور Discord، کانال‌ها و کانال‌های خصوصی Slack، پیام‌های مستقیم چندنفره Slack، و گروه‌ها یا ابرگروه‌های Telegram. سایر کانال‌های گروهی رفتار گروهی موجود خود را حفظ می‌کنند، مگر اینکه صفحه کانال آن‌ها بگوید از رویدادهای محیطی اتاق پشتیبانی می‌کنند.

راه‌اندازی پیشنهادی

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

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },}

سپس خود اتاق را با غیرفعال کردن الزام اشاره برای آن اتاق، همیشه‌فعال پیکربندی کنید. کانال همچنان باید توسط groupPolicy معمول خود، فهرست مجاز اتاق، و فهرست مجاز فرستنده اجازه داشته باشد.

پس از ذخیره پیکربندی، Gateway تنظیمات messages را به‌صورت داغ بازبارگذاری می‌کند. فقط زمانی راه‌اندازی مجدد کنید که پایش فایل یا بازبارگذاری پیکربندی غیرفعال باشد.

چه چیزی تغییر می‌کند

با messages.groupChat.unmentionedInbound: "room_event":

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

رویدادهای اتاق از تحویل نمایان سخت‌گیرانه استفاده می‌کنند. متن نهایی دستیار خصوصی است. عامل باید برای ارسال در اتاق message(action=send) را فراخوانی کند.

مثال Discord

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    discord: {      groupPolicy: "allowlist",      guilds: {        "<DISCORD_SERVER_ID>": {          requireMention: false,          users: ["<YOUR_DISCORD_USER_ID>"],        },      },    },  },}

وقتی فقط یک کانال باید محیطی باشد، از پیکربندی Discord برای هر کانال استفاده کنید:

{  channels: {    discord: {      guilds: {        "<DISCORD_SERVER_ID>": {          channels: {            "<DISCORD_CHANNEL_ID_OR_NAME>": {              allow: true,              requireMention: false,            },          },        },      },    },  },}

مثال Slack

فهرست‌های مجاز کانال Slack ابتدا بر شناسه تکیه دارند. از شناسه‌های کانال مانند C12345678 استفاده کنید، نه #channel-name.

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    slack: {      groupPolicy: "allowlist",      channels: {        "<SLACK_CHANNEL_ID>": {          allow: true,          requireMention: false,        },      },    },  },}

مثال Telegram

برای گروه‌های Telegram، ربات باید بتواند پیام‌های عادی گروه را ببیند. اگر requireMention: false است، حالت حریم خصوصی BotFather را غیرفعال کنید یا از راه‌اندازی دیگری برای Telegram استفاده کنید که کل ترافیک گروه را به ربات تحویل می‌دهد.

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    telegram: {      groups: {        "<TELEGRAM_GROUP_CHAT_ID>": {          groupPolicy: "open",          requireMention: false,        },      },    },  },}

شناسه‌های گروه Telegram معمولا اعداد منفی مانند -1001234567890 هستند. chat.id را از openclaw logs --follow بخوانید، یک پیام گروهی را به یک ربات کمک‌کننده شناسه فوروارد کنید، یا Bot API getUpdates را بررسی کنید.

سیاست اختصاصی عامل

وقتی چند عامل یک اتاق را به اشتراک می‌گذارند اما فقط یکی باید گفت‌وگوی بدون اشاره مستقیم را به‌عنوان زمینه محیطی در نظر بگیرد، از یک بازنویسی عامل استفاده کنید:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },  agents: {    list: [      {        id: "main",        groupChat: {          unmentionedInbound: "room_event",          mentionPatterns: ["@openclaw", "openclaw"],        },      },    ],  },}

مقدار اختصاصی عامل در agents.list[].groupChat.unmentionedInbound مقدار messages.groupChat.unmentionedInbound را برای آن عامل بازنویسی می‌کند.

حالت‌های پاسخ نمایان

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

برای اتاق‌های محیطی همیشه‌فعال، همچنان messages.groupChat.visibleReplies: "message_tool" توصیه می‌شود، به‌ویژه با مدل‌های نسل جدید و قابل‌اعتماد در ابزارها مانند GPT 5.5. این حالت به عامل اجازه می‌دهد با فراخوانی ابزار پیام تصمیم بگیرد چه زمانی صحبت کند. اگر مدل بدون فراخوانی ابزار، متن نهایی برگرداند، OpenClaw آن متن نهایی را خصوصی نگه می‌دارد و فراداده تحویل سرکوب‌شده را ثبت می‌کند.

رویدادهای اتاق حتی وقتی سایر درخواست‌های گروهی از پاسخ‌های خودکار استفاده می‌کنند سخت‌گیرانه باقی می‌مانند. رویدادهای محیطی اتاق بدون اشاره مستقیم همچنان برای خروجی نمایان به message(action=send) نیاز دارند.

تاریخچه

messages.groupChat.historyLimit پیش‌فرض سراسری تاریخچه گروه را کنترل می‌کند. کانال‌ها می‌توانند آن را با channels.<channel>.historyLimit بازنویسی کنند، و برخی کانال‌ها از محدودیت‌های تاریخچه برای هر حساب نیز پشتیبانی می‌کنند.

برای غیرفعال کردن زمینه تاریخچه گروه، historyLimit: 0 را تنظیم کنید.

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

عیب‌یابی

اگر اتاق وضعیت تایپ یا مصرف توکن را نشان می‌دهد اما پیام نمایانی وجود ندارد:

1. تأیید کنید اتاق توسط فهرست مجاز کانال و فهرست مجاز فرستنده اجازه دارد.
2. تأیید کنید requireMention: false در سطح اتاقی که انتظار دارید تنظیم شده است.
3. بررسی کنید آیا messages.groupChat.unmentionedInbound یا بازنویسی عامل "room_event" است.
4. لاگ‌ها را برای فراداده بار نهایی سرکوب‌شده یا didSendViaMessagingTool: false بررسی کنید.
5. برای درخواست‌های عادی گروه، اگر می‌خواهید پاسخ‌های نهایی به‌صورت خودکار ارسال شوند، messages.groupChat.visibleReplies: "automatic" را نگه دارید یا بازگردانید. برای اتاق‌های محیطی که از message_tool استفاده می‌کنند، از مدل/زمان‌اجرایی استفاده کنید که ابزارها را قابل‌اعتماد فراخوانی می‌کند.

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

اگر اتاق‌های محیطی Slack فعال نمی‌شوند، تأیید کنید کلید کانال همان شناسه کانال Slack است و برنامه برای نوع آن اتاق دامنه موردنیاز channels:history یا groups:history را دارد.

مرتبط

• گروه‌ها
• Discord
• Slack
• Telegram
• عیب‌یابی کانال
• مرجع پیکربندی کانال