เหตุการณ์แวดล้อมในห้อง

เหตุการณ์ห้องแบบ ambient ช่วยให้ OpenClaw ประมวลผลข้อความพูดคุยในกลุ่มหรือช่องที่ไม่ได้กล่าวถึงเป็นบริบทเงียบได้ เอเจนต์สามารถอัปเดตหน่วยความจำและสถานะเซสชันได้ แต่ห้องจะยังเงียบอยู่ เว้นแต่เอเจนต์จะเรียกเครื่องมือ message อย่างชัดเจน

สำหรับแชตกลุ่มที่เปิดใช้งานตลอดเวลา นี่คือโหมดที่แนะนำ: ใช้ messages.groupChat.unmentionedInbound: "room_event" ร่วมกับ messages.groupChat.visibleReplies: "message_tool" ใช้โหมดนี้เมื่อเอเจนต์ควรฟัง ตัดสินใจเองว่าเมื่อใดการตอบกลับจึงมีประโยชน์ และหลีกเลี่ยงรูปแบบพรอมต์แบบเก่าที่ตอบ NO_REPLY

รองรับในปัจจุบัน: ช่องกิลด์ Discord, ช่อง Slack และช่องส่วนตัว, DM หลายคนของ Slack และกลุ่มหรือซูเปอร์กรุ๊ปของ Telegram ช่องกลุ่มอื่นจะคงพฤติกรรมกลุ่มเดิมไว้ เว้นแต่หน้าช่องของช่องนั้นจะระบุว่ารองรับเหตุการณ์ห้องแบบ ambient

การตั้งค่าที่แนะนำ

ตั้งค่าพฤติกรรมแชตกลุ่มแบบส่วนกลาง:

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

จากนั้นกำหนดค่าห้องเองให้เปิดใช้งานตลอดเวลาโดยปิดการกั้นด้วยการกล่าวถึงสำหรับห้องนั้น ช่องยังต้องได้รับอนุญาตโดย groupPolicy ปกติ รายการอนุญาตของห้อง และรายการอนุญาตของผู้ส่ง

หลังจากบันทึกการกำหนดค่าแล้ว Gateway จะโหลดการตั้งค่า messages ใหม่แบบ hot-reload รีสตาร์ทเฉพาะเมื่อการเฝ้าดูไฟล์หรือการโหลดการกำหนดค่าใหม่ถูกปิดใช้งาน

สิ่งที่เปลี่ยนไป

เมื่อใช้ 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 แบบรายช่องเมื่อมีเพียงช่องเดียวที่ควรเป็น ambient:

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

ตัวอย่าง Slack

รายการอนุญาตช่อง Slack ใช้ ID เป็นหลัก ใช้ ID ช่อง เช่น 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,        },      },    },  },}

ID กลุ่ม Telegram มักเป็นตัวเลขติดลบ เช่น -1001234567890 อ่าน chat.id จาก openclaw logs --follow ส่งต่อข้อความกลุ่มไปยังบอตช่วยดู ID หรือตรวจสอบ Bot API getUpdates

นโยบายเฉพาะเอเจนต์

ใช้การเขียนทับสำหรับเอเจนต์เมื่อมีหลายเอเจนต์ใช้ห้องเดียวกัน แต่มีเพียงเอเจนต์เดียวที่ควรถือว่าข้อความพูดคุยที่ไม่ได้กล่าวถึงเป็นบริบทแบบ ambient:

{  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" สำหรับคำขอของผู้ใช้แบบกลุ่ม/ช่องปกติ คงค่าเริ่มต้นนี้ไว้เมื่อคุณต้องการให้ข้อความสุดท้ายของผู้ช่วยโพสต์อย่างมองเห็นได้โดยไม่ต้องเรียกเครื่องมือข้อความอย่างชัดเจน

สำหรับห้องแบบ ambient ที่เปิดใช้งานตลอดเวลา ยังคงแนะนำให้ใช้ messages.groupChat.visibleReplies: "message_tool" โดยเฉพาะกับโมเดลรุ่นล่าสุดที่เรียกใช้เครื่องมือได้เชื่อถือได้ เช่น GPT 5.5 วิธีนี้ช่วยให้เอเจนต์ตัดสินใจว่าเมื่อใดควรพูดโดยเรียกเครื่องมือข้อความ หากโมเดลส่งคืนข้อความสุดท้ายโดยไม่ได้เรียกเครื่องมือ OpenClaw จะเก็บข้อความสุดท้ายนั้นไว้เป็นส่วนตัวและบันทึกเมทาดาทาการส่งที่ถูกระงับ

เหตุการณ์ห้องยังคงเข้มงวดแม้คำขอกลุ่มอื่นจะใช้การตอบกลับอัตโนมัติ เหตุการณ์ห้อง ambient ที่ไม่ได้กล่าวถึงยังคงต้องใช้ message(action=send) สำหรับเอาต์พุตที่มองเห็นได้

ประวัติ

messages.groupChat.historyLimit ควบคุมค่าเริ่มต้นของประวัติกลุ่มแบบส่วนกลาง ช่องสามารถเขียนทับได้ด้วย channels.<channel>.historyLimit และบางช่องยังรองรับขีดจำกัดประวัติแบบรายบัญชีด้วย

ตั้งค่า historyLimit: 0 เพื่อปิดบริบทประวัติกลุ่ม

ช่องที่รองรับเหตุการณ์ห้องจะเก็บข้อความห้องแบบ ambient ล่าสุดไว้เป็นบริบท Discord จะเก็บประวัติเหตุการณ์ห้องไว้จนกว่าการส่ง Discord ที่มองเห็นได้จะสำเร็จ ดังนั้นบริบทเงียบจะไม่หายไปก่อนการส่งผ่านเครื่องมือข้อความ

การแก้ปัญหา

หากห้องแสดงการพิมพ์หรือการใช้โทเค็นแต่ไม่มีข้อความที่มองเห็นได้:

1. ยืนยันว่าห้องได้รับอนุญาตโดยรายการอนุญาตของช่องและรายการอนุญาตของผู้ส่ง
2. ยืนยันว่า requireMention: false ถูกตั้งไว้ที่ระดับห้องที่คุณคาดไว้
3. ตรวจสอบว่า messages.groupChat.unmentionedInbound หรือการเขียนทับของเอเจนต์เป็น "room_event" หรือไม่
4. ตรวจสอบบันทึกสำหรับเมทาดาทาเพย์โหลดสุดท้ายที่ถูกระงับหรือ didSendViaMessagingTool: false
5. สำหรับคำขอกลุ่มปกติ ให้คงหรือคืนค่า messages.groupChat.visibleReplies: "automatic" หากคุณต้องการให้การตอบกลับสุดท้ายถูกโพสต์โดยอัตโนมัติ สำหรับห้องแบบ ambient ที่ใช้ message_tool ให้ใช้โมเดล/รันไทม์ที่เรียกใช้เครื่องมือได้อย่างเชื่อถือได้

หากห้อง ambient ของ Telegram ไม่ทริกเกอร์เลย ให้ตรวจสอบโหมดความเป็นส่วนตัวของ BotFather และยืนยันว่า Gateway กำลังได้รับข้อความกลุ่มปกติ

หากห้อง ambient ของ Slack ไม่ทริกเกอร์ ให้ตรวจสอบว่าคีย์ช่องเป็น ID ช่อง Slack และแอปมี scope channels:history หรือ groups:history ที่จำเป็นสำหรับประเภทห้องนั้น

ที่เกี่ยวข้อง

• กลุ่ม
• Discord
• Slack
• Telegram
• การแก้ปัญหาช่อง
• ข้อมูลอ้างอิงการกำหนดค่าช่อง