Gruplar

​

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

• 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").

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

​

Görünür yanıtlar

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

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

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

​

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

• 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).

​

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)

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

• 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ı

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

​

Bahsetme geçidi (varsayılan)

{
  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ı

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

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

​

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

• 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.

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

​

Grup izin listeleri

{
  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)

• /activation mention
• /activation always

​

Bağlam alanları

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

​

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

​

WhatsApp ayrıntıları

​

İlgili

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