Gruplar

OpenClaw; Discord, iMessage, Matrix, Microsoft Teams, QQBot, Signal, Slack, Telegram, WhatsApp ve Zalo dahil olmak üzere grup destekli kanalların tümünde aynı grup kurallarını uygular.

Temsilci açıkça görünür bir mesaj göndermedikçe sessiz bağlam sağlaması gereken sürekli etkin odalar için Ortam odası etkinlikleri bölümüne bakın.

Başlangıç tanıtımı (2 dakika)

OpenClaw kendi mesajlaşma hesaplarınızda "yaşar". Ayrı bir WhatsApp bot kullanıcısı yoktur: bir grupta siz bulunuyorsanız OpenClaw bu grubu görebilir ve orada yanıt verebilir.

Varsayılan davranış:

• Gruplar kısıtlanmıştır (groupPolicy: "allowlist"); grup gönderenleri izin verilenler listesine eklenene kadar engellenir.
• Bir grup için bahsetme denetimini devre dışı bırakmadığınız sürece yanıtlar bir bahsetme gerektirir.
• Son yanıt metni odaya otomatik olarak gönderilir (visibleReplies: "automatic").

Başka bir deyişle: izin verilenler listesindeki gönderenler, OpenClaw'dan bahsederek onu tetikleyebilir.

Hızlı akış (bir grup mesajına ne olur):

groupPolicy? disabled -> bırakgroupPolicy? allowlist -> gruba izin veriliyor mu? hayır -> bırakrequireMention? evet -> bahsedildi mi? hayır -> yalnızca bağlam için saklabahsetme/yanıt/komut/DM -> kullanıcı isteğisürekli etkin grup konuşması -> kullanıcı isteği veya yapılandırıldığında oda etkinliği

Görünür yanıtlar

Normal grup/kanal isteklerinde OpenClaw varsayılan olarak messages.groupChat.visibleReplies: "automatic" kullanır: son asistan metni görünür yanıt olarak odaya gönderilir.

Paylaşılan bir odada temsilcinin ne zaman konuşacağına message(action=send) çağrısı yaparak karar vermesi gerekiyorsa messages.groupChat.visibleReplies: "message_tool" kullanın. Bu, araçları güvenilir biçimde kullanan modellerle (örneğin GPT-5.6 Sol) en iyi şekilde çalışır. Model aracı kullanmaz ve anlamlı bir son metin döndürürse OpenClaw bu metni odaya göndermek yerine gizli tutar.

Yalnızca araçla teslim talimatını güvenilir biçimde izlemeyen modeller veya çalışma zamanları için "automatic" kullanın: normal son metinler doğrudan odaya gönderilir ve temsilci, son metinle birlikte gönderilemeyen dosyalar, görseller veya diğer ekler için yine de message(action=send) çağrısı yapabilir.

Mesaj aracı etkin araç politikası kapsamında kullanılamıyorsa OpenClaw yanıtı sessizce bastırmak yerine otomatik görünür yanıtlara geri döner. openclaw doctor bu uyumsuzluk hakkında uyarır.

Doğrudan sohbetler ve diğer tüm kaynak etkinlikleri için messages.visibleReplies: "message_tool" aynı yalnızca araç davranışını genel olarak uygular; messages.groupChat.visibleReplies, grup/kanal odaları için daha özel geçersiz kılma olarak kalır. Dahili WebChat doğrudan turları varsayılan olarak otomatik son yanıt teslimini kullanır; böylece Pi ve Codex aynı görünür yanıt sözleşmesini alır.

Yalnızca araç modu, çoğu sessiz izleme modu turunda modeli NO_REPLY yanıtını vermeye zorlama şeklindeki eski kalıbın yerini alır. Yalnızca araç modunda istem bir NO_REPLY sözleşmesi tanımlamaz; görünür hiçbir şey yapmamak, yalnızca mesaj aracını çağırmamak anlamına gelir.

Plugin'e ait konuşma bağlamaları istisnadır. Bir Plugin, bir iş parçacığını bağlayıp gelen turun sahipliğini aldıktan sonra Plugin'in döndürdüğü yanıt görünür bağlama yanıtıdır; message(action=send) gerektirmez. Bu yanıt gizli model son metni değil, Plugin çalışma zamanı çıktısıdır.

Doğrudan grup istekleri için yazıyor göstergeleri yine gönderilir. Etkinleştirildiğinde ortam niteliğindeki sürekli etkin oda etkinlikleri, temsilci mesaj aracını çağırmadıkça kesinlikle sessiz kalır.

Oturumlar varsayılan olarak ayrıntılı araç/ilerleme özetlerini bastırır. Hata ayıklama sırasında geçerli oturum için bunları göstermek üzere /verbose on (veya /verbose full), yalnızca son yanıt davranışına dönmek için /verbose off kullanın. Ayrıntı durumu oturum başınadır ve doğrudan sohbetlerde, gruplarda, kanallarda ve forum konularında aynı şekilde çalışır.

Bahsedilmemiş sürekli etkin grup konuşmalarını kullanıcı istekleri yerine sessiz oda bağlamı olarak göndermek için Ortam odası etkinlikleri özelliğini kullanın:

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

Varsayılan değer unmentionedInbound: "user_request" şeklindedir. Bahsetme içeren mesajlar, komutlar, iptal istekleri ve DM'ler kullanıcı isteği olarak kalır.

Grup/kanal isteklerinde görünür çıktının mesaj aracı üzerinden gönderilmesini zorunlu tutmak için:

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

Bunu her kaynak sohbet için zorunlu tutmak üzere:

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

Gateway, dosya kaydedildikten sonra messages yapılandırma değişikliklerini yeniden başlatılmadan uygular. Yalnızca yapılandırmayı yeniden yükleme devre dışı bırakıldığında (gateway.reload.mode: "off") yeniden başlatın.

Komut turları visibleReplies: "message_tool" ayarını atlar ve her zaman görünür biçimde yanıt verir: yerel eğik çizgi komutları (Discord, Telegram ve yerel komut desteği sunan diğer yüzeyler) ile yetkilendirilmiş metin /... komutlarının ikisi de yanıtlarını kaynak sohbete gönderir. Gruplardaki yetkilendirilmemiş metin /... turları yalnızca mesaj aracı modunda kalır; sıradan sohbet turları yapılandırılan varsayılanı izler.

Bağlam görünürlüğü ve izin verilenler listeleri

Grup güvenliğinde iki farklı denetim kullanılır:

• Tetikleme yetkilendirmesi: temsilciyi kimlerin tetikleyebileceği (groupPolicy, groups, groupAllowFrom, kanala özgü izin verilenler listeleri).
• Bağlam görünürlüğü: modele hangi ek bağlamın eklendiği (yanıt/alıntı metni, iş parçacığı geçmişi, iletilen meta veriler).

OpenClaw varsayılan olarak bağlamı alındığı hâliyle korur: izin verilenler listeleri modelin hangi alıntılanmış veya geçmiş parçacıkları gördüğünü değil, kimlerin eylemleri tetikleyebileceğini belirler. Ek bağlamı da filtrelemek için contextVisibility ayarını belirleyin:

Bunu kanal başına (channels.<channel>.contextVisibility), hesap başına (channels.<channel>.accounts.<accountId>.contextVisibility) veya genel olarak (channels.defaults.contextVisibility) ayarlayın. Ek bağlamı getiren kanallar (Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp), gelen bağlamı oluştururken politikayı uygular; bilinmeyen politika birleşimleri güvenli biçimde başarısız olur ve bağlamı dışarıda bırakır.

Bu modlar yalnızca kanal tarafından sağlanan ek bağlamı filtreler. Araç politikası ve yalnızca sahibin kullanabildiği araç envanteri, istemde temsil edilen her gönderene göre değil, yine geçerli turun kaynak istekte bulunan kişisine göre seçilir. İstekte bulunan kişi kapsamlı denetimler ve istem bağlamı bölümüne bakın.

İstediğiniz...

Yeniden kullanılabilir gönderen izin listeleri için Erişim grupları bölümüne bakın.

Oturum anahtarları

• Grup oturumları agent:<agentId>:<channel>:group:<id> oturum anahtarlarını kullanır (odalar/kanallar agent:<agentId>:<channel>:channel:<id> kullanır).
• Telegram forum konuları, her konunun kendi oturumu olması için grup kimliğine :topic:<threadId> ekler.
• Doğrudan sohbetler ana oturumu kullanır (veya session.dmScope yapılandırılmışsa gönderen başına oturumları).
• Heartbeat'ler yapılandırılan Heartbeat oturumunda çalışır (varsayılan: temsilcinin ana oturumu); grup oturumları kendi Heartbeat'lerini çalıştırmaz.

Kalıp: kişisel DM'ler + herkese açık gruplar (tek temsilci)

Evet — "kişisel" trafiğiniz DM'lerden, "herkese açık" trafiğiniz ise gruplardan oluşuyorsa bu yaklaşım iyi çalışır.

Nedeni: tek temsilci modunda DM'ler genellikle ana oturum anahtarına (agent:main:main) ulaşırken gruplar her zaman ana olmayan oturum anahtarlarını (agent:main:<channel>:group:<id>) kullanır. Korumalı alan kullanımını mode: "non-main" ile etkinleştirirseniz bu grup oturumları yapılandırılan korumalı alan arka ucunda çalışırken ana DM oturumunuz ana makinede kalır. Bir arka uç seçmezseniz varsayılan arka uç Docker'dır.

Böylece tek bir temsilci "beyniniz" (paylaşılan çalışma alanı + bellek), ancak iki farklı yürütme biçiminiz olur:

• DM'ler: tüm araçlar (ana makine)
• Gruplar: korumalı alan + kısıtlı araçlar

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // gruplar/kanallar ana değildir -> korumalı alanda        scope: "session", // en güçlü yalıtım (grup/kanal başına bir kapsayıcı)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // allow boş değilse diğer her şey engellenir (deny yine önceliklidir).        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",          ],        },      },    },  },}

İlgili:

• Yapılandırma anahtarları ve varsayılanlar: Gateway yapılandırması
• Bir aracın neden engellendiğini hata ayıklama: Korumalı Alan ile Araç Politikası ile Yükseltilmiş Yetki Karşılaştırması
• Bağlama noktası ayrıntıları: Korumalı alan kullanımı

Görünen etiketler

• Kullanılabilir olduğunda kullanıcı arabirimi etiketleri displayName değerini, <channel>:<token> biçiminde kullanır.
• #room, odalar/kanallar için ayrılmıştır; grup sohbetleri g-<slug> kullanır (küçük harf, boşluklar -> -, #@+._- değerini koruyun). Çok uzun ve anlaşılmaz kimlikler, tam rota kimliklerini kullanıcı arabirimine sızdırmak yerine kararlı bir belirteç olarak kısaltılır.

Grup politikası

Grup/oda mesajlarının kanal başına nasıl işleneceğini denetleyin:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // sayısal Telegram kullanıcı kimliği (kurulum @username değerini çözümler)    },    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 },      },    },  },}

Hızlı zihinsel model (grup mesajları için değerlendirme sırası):

Bahsetme geçidi (varsayılan)

Grup bazında geçersiz kılınmadığı sürece grup mesajları bir bahsetme gerektirir. Varsayılanlar her alt sistem için *.groups."*" altında bulunur.

Desteklenen örtük bahsetme olguları kanala özgüdür:

Kanal ilgili olguyu ürettiğinde her olgu varsayılan olarak etkinleştirilir. İlgili olgunun bahsetme geçidini atlamasını engellemek için karşılık gelen implicitMentions bayrağını false olarak ayarlayın; yerel açık bahsetmeler bundan etkilenmez. Bir bayrak, ilgili olguyu üretmeyen kanalları etkilemez.

{  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,        },      },    },  },}

Yapılandırılmış bahsetme kalıplarının kapsamı

Yapılandırılmış mentionPatterns, regex geri dönüş tetikleyicileridir. Platform yerel bir bot bahsetmesi sunmadığında veya openclaw: gibi düz metnin bahsetme olarak sayılmasını istediğinizde bunları kullanın. Yerel platform bahsetmeleri ayrıdır: Discord, Slack, Telegram, Matrix, Signal veya başka bir kanal mesajda bottan açıkça bahsedildiğini kanıtlayabildiğinde, yapılandırılmış regex kalıpları reddedilmiş olsa bile bu yerel bahsetme tetiklemeye devam eder.

Varsayılan olarak yapılandırılmış bahsetme kalıpları, kanalın sağlayıcı ve konuşma olgularını bahsetme algılamasına ilettiği her yerde uygulanır. Geniş kapsamlı kalıpların agent'ı her grupta uyandırmasını önlemek için bunları channels.<channel>.mentionPatterns ile kanal bazında kapsamlandırın.

Regex bahsetme kalıplarının bir kanal için varsayılan olarak kapalı olması gerektiğinde mode: "deny" kullanın, ardından belirli odaları allowIn ile etkinleştirin:

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

Regex bahsetme kalıplarının geniş kapsamda uygulanması gerektiğinde varsayılan mode: "allow" değerini kullanın (veya mode değerini atlayın), ardından gürültülü odalarda bunları denyIn ile kapatın:

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

İlke çözümleme:

Bugün desteklenen kapsamlı regex ilkesi:

Hesap düzeyindeki kanal yapılandırmaları, ilgili kanal birden fazla hesabı desteklediğinde aynı ilkeyi channels.<channel>.accounts.<accountId>.mentionPatterns altında ayarlayabilir. Hesap ilkesi, ilgili hesap için üst düzey kanal ilkesine göre önceliklidir.

Grup/kanal aracı kısıtlamaları (isteğe bağlı)

Bazı kanal yapılandırmaları, belirli bir grup/oda/kanal içinde hangi araçların kullanılabileceğinin kısıtlanmasını destekler.

• tools: grubun tamamı için araçlara izin verin/reddedin (allow, alsoAllow, deny; reddetme üstün gelir).
• toolsBySender: grup içinde gönderen bazında geçersiz kılmalar. Açık anahtar önekleri kullanın: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> ve "*" joker karakteri. Kanal kimlikleri, standart OpenClaw kanal kimliklerini kullanır; teams gibi diğer adlar msteams değerine normalleştirilir. Öneksiz eski anahtarlar hâlâ kabul edilir, yalnızca id: olarak eşleştirilir ve kullanımdan kaldırma uyarısı günlüğe kaydedilir.

Çözümleme sırası (en belirgin olan üstün gelir):

Örnek (Telegram):

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

Grup izin listeleri

channels.whatsapp.groups, channels.telegram.groups veya channels.imessage.groups yapılandırıldığında, anahtarlar bir grup izin listesi işlevi görür. Varsayılan bahsetme davranışını ayarlamaya devam ederken tüm gruplara izin vermek için "*" kullanın.

Yaygın amaçlar (kopyala/yapıştır):

{  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 } },    },  },}

Etkinleştirme (yalnızca sahip)

Grup sahipleri, bağımsız bir mesajla grup başına etkinleştirmeyi açıp kapatabilir:

• /activation mention
• /activation always

/activation, sahip denetimine tabi bir çekirdek komuttur ve yalnızca grup sohbetlerinde geçerlidir. Sahip, gönderenin commands.ownerAllowFrom ile eşleşmesi anlamına gelir; kanal allowFrom listeleri yalnızca sıradan kanal ve komut erişimini denetler. Depolanan mod, bunu dikkate alan kanallarda (Google Chat, QQBot, Telegram, WhatsApp) ilgili grubun requireMention değerini geçersiz kılar ve grup sistem istemi girişi her yerde etkin modu yansıtır.

Bağlam alanları

Gelen grup yükleri şunları ayarlar:

• ChatType=group
• GroupSubject (biliniyorsa)
• GroupMembers (biliniyorsa)
• WasMentioned (bahsetme geçidi sonucu)
• Telegram forum konuları ayrıca MessageThreadId ve IsForum içerir.

Ajan sistem istemi, yeni bir grup oturumunun ilk turunda (ve /activation değiştikten sonra) bir grup girişi içerir. Modele bir insan gibi yanıt vermesini, boş satırları en aza indirip normal sohbet aralıklarına uymasını ve değişmez \n dizilerini yazmaktan kaçınmasını hatırlatır. Bildirilen tablo modu yerel veya ham tabloları korumayan kanallar, Markdown tablolarının kullanılmasını da önermez. Kanal kaynaklı grup adları ve katılımcı etiketleri, satır içi sistem talimatları olarak değil, kod çiti içinde güvenilmeyen meta veriler olarak işlenir.

iMessage ayrıntıları

• Yönlendirme veya izin listesine ekleme sırasında chat_id:<id> tercih edin.
• Sohbetleri listeleme: imsg chats --limit 20.
• Grup yanıtları her zaman aynı chat_id öğesine geri gönderilir.

WhatsApp sistem istemleri

Grup ve doğrudan istem çözümleme, joker karakter davranışı ve hesap geçersiz kılma anlamları dâhil olmak üzere standart WhatsApp sistem istemi kuralları için WhatsApp bölümüne bakın.

WhatsApp ayrıntıları

Yalnızca WhatsApp'a özgü davranışlar (geçmiş ekleme, bahsetme işleme ayrıntıları) için Grup mesajları bölümüne bakın.

İlgili

• Yayın grupları
• Kanal yönlendirme
• Grup mesajları
• Eşleştirme