Gruplar

OpenClaw, grup sohbetlerini yüzeyler arasında tutarlı şekilde ele alır: Discord, iMessage, Matrix, Microsoft Teams, QQBot, Signal, Slack, Telegram, WhatsApp, Zalo.

Aracı açıkça görünür bir mesaj göndermedikçe sessiz bağlam sağlaması gereken her zaman açık odalar için bkz. Ortam oda olayları.

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 varsınız, OpenClaw o grubu görebilir ve orada yanıt verebilir.

Varsayılan davranış:

• Gruplar kısıtlıdır (groupPolicy: "allowlist").
• Bahsetme geçidini açıkça devre dışı bırakmadığınız sürece yanıtlar bir bahsetme gerektirir.
• Gruplarda/kanallarda görünür yanıtlar varsayılan olarak message aracını kullanır.

Anlamı: izin listesine alınmış gönderenler OpenClaw'dan bahsederek onu tetikleyebilir.

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

groupPolicy? disabled -> dropgroupPolicy? allowlist -> group allowed? no -> droprequireMention? yes -> mentioned? no -> store for context onlymention/reply/command/DM -> user requestalways-on group chatter -> user request, or room event when configured

Görünür yanıtlar

Normal grup/kanal istekleri için OpenClaw varsayılan olarak messages.groupChat.visibleReplies: "automatic" kullanır. Odayı yalnızca mesaj aracı çıktısına açıkça ayarlamadığınız sürece son asistan metni eski görünür yanıt yolu üzerinden gönderilir.

Paylaşılan bir odada aracının ne zaman konuşacağına message(action=send) çağırarak karar vermesini istiyorsanız messages.groupChat.visibleReplies: "message_tool" kullanın. Bu, GPT 5.5 gibi en yeni nesil, araçlarda güvenilir modellerle desteklenen grup odalarında en iyi şekilde çalışır. Model bu aracı kaçırır ve anlamlı son metin döndürürse OpenClaw bu son metni odaya göndermek yerine özel tutar.

Daha zayıf modeller veya yalnızca araçla teslimatı güvenilir şekilde anlamayan çalışma zamanları için "automatic" kullanın. Otomatik modda aracının son asistan metni görünür kaynak yanıt yoludur; bu yüzden message(action=send) çağrısını tutarlı şekilde yapamayan bir model yine de normal şekilde yanıt verebilir.

Otomatik modda normal metin son yanıtları doğrudan odaya gönderilir. Görünür yanıt dosya, resim veya başka ekler gerektiriyorsa aracı, bunu son metin yanıtından zorla geçirmek yerine ilgili ek için yine message(action=send) kullanabilir.

Etkin araç ilkesi altında mesaj aracı 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 olayları için aynı yalnızca araçla görünür yanıt davranışını genel olarak uygulamak üzere messages.visibleReplies: "message_tool" kullanın. Dahili WebChat doğrudan turları, Pi ve Codex aynı görünür yanıt sözleşmesini alsın diye varsayılan olarak otomatik son yanıt teslimatını kullanır. Görünür çıktı için bilinçli olarak message(action=send) gerektirmek istiyorsanız messages.visibleReplies: "message_tool" ayarlayın. messages.groupChat.visibleReplies grup/kanal odaları için daha özel geçersiz kılma olarak kalır.

Bu, modeli çoğu gizlenme modu turu için NO_REPLY yanıtlamaya zorlayan 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'in sahip olduğu konuşma bağlamaları istisnadır. Bir Plugin bir iş parçacığını bağlayıp gelen turu üstlendiğinde, Plugin'in döndürdüğü yanıt görünür bağlama yanıtıdır; message(action=send) gerektirmez. Bu yanıt özel model son metni değil, Plugin çalışma zamanı çıktısıdır.

Yazıyor göstergeleri doğrudan grup istekleri için hâlâ gönderilir. Ortam her zaman açık oda olayları etkinleştirildiğinde, aracı mesaj aracını çağırmadıkça katı ve sessiz kalır.

Oturumlar varsayılan olarak ayrıntılı araç/ilerleme özetlerini bastırır. Hata ayıklarken geçerli oturum için bu özetleri göstermek üzere /verbose on, yalnızca son yanıt davranışına dönmek için /verbose off kullanın. Aynı ayrıntılı durum doğrudan sohbetler, gruplar, kanallar ve forum konuları genelinde geçerlidir.

Bahsedilmemiş her zaman açık grup sohbetini kullanıcı isteği yerine sessiz oda bağlamı olarak göndermek için Ortam oda olayları kullanın:

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

Varsayılan unmentionedInbound: "user_request" değeridir.

Bahsedilen 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 gitmesini zorunlu kılmak için:

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

Gateway, dosya kaydedildikten sonra messages yapılandırmasını sıcak yeniden yükler. Yalnızca dağıtımda dosya izleme veya yapılandırma yeniden yükleme devre dışıysa yeniden başlatın.

Her kaynak sohbetinde görünür çıktının mesaj aracı üzerinden gitmesini zorunlu kılmak için:

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

Yerel eğik çizgi komutları (Discord, Telegram ve yerel komut desteği olan diğer yüzeyler) visibleReplies: "message_tool" ayarını atlar ve kanalın yerel komut arayüzü beklediği yanıtı alsın diye her zaman görünür şekilde yanıtlar. Bu yalnızca doğrulanmış yerel komut turları için geçerlidir; metin olarak yazılan /... komutları ve sıradan sohbet turları yapılandırılmış grup varsayılanını izlemeye devam eder.

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

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

• Tetikleme yetkilendirmesi: aracıyı kim tetikleyebilir (groupPolicy, groups, groupAllowFrom, kanala özgü izin listeleri).
• Bağlam görünürlüğü: modele hangi ek bağlam enjekte edilir (yanıt metni, alıntılar, iş parçacığı geçmişi, iletilmiş üst veriler).

Varsayılan olarak OpenClaw normal sohbet davranışına öncelik verir ve bağlamı büyük ölçüde alındığı gibi tutar. Bu, izin listelerinin öncelikle eylemleri kimin tetikleyebileceğine karar verdiği, her alıntılanmış veya geçmiş parçacığı için evrensel bir redaksiyon sınırı olmadığı anlamına gelir.

İstiyorsanız...

Yeniden kullanılabilir gönderen izin listeleri için bkz. Erişim grupları.

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 olsun diye grup kimliğine :topic:<threadId> ekler.
• Doğrudan sohbetler ana oturumu kullanır (veya yapılandırılmışsa gönderen başına).
• Grup oturumları için Heartbeat'ler atlanır.

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

Evet — "kişisel" trafiğiniz DM'ler ve "herkese açık" trafiğiniz gruplar ise bu iyi çalışır.

Neden: tek aracı modunda DM'ler genellikle ana oturum anahtarına (agent:main:main) düşerken gruplar her zaman ana olmayan oturum anahtarlarını (agent:main:<channel>:group:<id>) kullanır. mode: "non-main" ile korumalı alanı etkinleştirirseniz bu grup oturumları yapılandırılmış korumalı alan arka ucunda çalışır, ana DM oturumunuz ise ana makinede kalır. Birini seçmezseniz varsayılan arka uç Docker'dır.

Bu size tek bir aracı "beyni" (paylaşılan çalışma alanı + bellek), ama iki yürütme duruşu verir:

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

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

İlgili:

• Yapılandırma anahtarları ve varsayılanlar: Gateway yapılandırması
• Bir aracın neden engellendiğini hata ayıklama: Korumalı Alan ve Araç İlkesi ve Yükseltilmiş
• Bağlama ayrıntıları: Korumalı alan

Görüntüleme etiketleri

• Arayüz etiketleri kullanılabiliyorsa displayName kullanır ve <channel>:<token> olarak biçimlendirilir.
• #room odalar/kanallar için ayrılmıştır; grup sohbetleri g-<slug> kullanır (küçük harf, boşluklar -> -, #@+._- koru).

Grup ilkesi

Grup/oda mesajlarının kanal başına nasıl ele alınacağını denetleyin:

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

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

Bahsetme denetimi (varsayılan)

Grup mesajları, grup başına geçersiz kılınmadıkça bir bahsetme gerektirir. Varsayılanlar, her alt sistemde *.groups."*" altında bulunur.

Bir bot mesajına yanıt vermek, kanal yanıt meta verilerini desteklediğinde örtük bir bahsetme sayılır. Bir bot mesajını alıntılamak da alıntı meta verilerini açığa çıkaran kanallarda örtük bir bahsetme sayılabilir. Geçerli yerleşik durumlar Telegram, WhatsApp, Slack, Discord, Microsoft Teams ve ZaloUser içerir.

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

Yapılandırılmış bahsetme kalıplarını kapsamlandırma

Yapılandırılmış mentionPatterns, regex yedek tetikleyicileridir. Platform yerel bir bot bahsetmesini açığa çıkarmadığında veya openclaw: gibi düz metnin bahsetme sayılmasını istediğinizde bunları kullanın. Yerel platform bahsetmeleri ayrıdır: Discord, Slack, Telegram, Matrix veya başka bir kanal mesajın botu açıkça bahsettiğini kanıtlayabildiğinde, yapılandırılmış regex kalıpları reddedilmiş olsa bile bu yerel bahsetme yine tetikler.

Varsayılan olarak, yapılandırılmış bahsetme kalıpları, kanalın sağlayıcı ve konuşma bilgilerini bahsetme algılamasına ilettiği her yerde uygulanır. Geniş kalıpların her grupta ajanı uyandırmasını önlemek için bunları kanal başına channels.<channel>.mentionPatterns ile 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 dahil edin:

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

Regex bahsetme kalıplarının geniş biçimde uygulanması gerektiğinde varsayılan mode: "allow" değerini kullanın (veya mode değerini atlayın), ardından gürültülü odalarda 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üzeyi kanal yapılandırmaları, kanal birden fazla hesabı desteklediğinde aynı ilkeyi channels.<channel>.accounts.<accountId>.mentionPatterns altında ayarlayabilir. Hesap ilkesi, o hesap için üst düzey kanal ilkesine göre önceliklidir.

Grup/kanal araç 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ğini kısıtlamayı destekler.

• tools: tüm grup için araçlara izin verin/reddedin.
• toolsBySender: grup içinde gönderen başına 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 kanonik OpenClaw kanal kimliklerini kullanır; teams gibi diğer adlar msteams değerine normalleştirilir. Eski öneksiz anahtarlar hâlâ kabul edilir ve yalnızca id: olarak eşleştirilir.

Çözümleme sırası (en özel olan kazanır):

Ö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 grup izin listesi işlevi görür. Varsayılan bahsetme davranışını yine ayarlarken 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 grup başına etkinleştirmeyi açıp kapatabilir:

• /activation mention
• /activation always

Sahip, channels.whatsapp.allowFrom tarafından belirlenir (ayarlanmamışsa botun kendi E.164 numarası kullanılır). Komutu tek başına bir mesaj olarak gönderin. Diğer yüzeyler şu anda /activation öğesini yok sayar.

Bağlam alanları

Gelen grup yükleri şunları ayarlar:

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

Agent sistem istemi, yeni bir grup oturumunun ilk turunda bir grup girişi içerir. Modele bir insan gibi yanıt vermesini, boş satırları en aza indirmesini ve normal sohbet aralığını izlemesini, ayrıca değişmez \n dizileri yazmaktan kaçınmasını hatırlatır. Telegram dışı gruplarda Markdown tabloları da önerilmez; Telegram zengin metin yönergeleri Telegram kanal isteminden gelir. Kanal kaynaklı grup adları ve katılımcı etiketleri, satır içi sistem talimatları olarak değil, kod çiti içindeki güvenilmeyen meta veri olarak işlenir.

iMessage ayrıntıları

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

WhatsApp sistem istemleri

Grup ve doğrudan istem çözümlemesi, joker karakter davranışı ve hesap geçersiz kılma semantiği dahil olmak üzere kanonik WhatsApp sistem istemi kuralları için WhatsApp bölümüne bakın.

WhatsApp ayrıntıları

WhatsApp'a özgü davranış (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