Gruplar

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

• Gruplar kısıtlanır (groupPolicy: "allowlist").
• Bahsetme kısıtlamasını açıkça devre dışı bırakmadığınız sürece yanıtlar bahsetme gerektirir.
• Gruplarda/kanallarda normal nihai yanıtlar varsayılan olarak özeldir. Görünür oda çıktısı message aracını kullanır.

groupPolicy? disabled -> drop
groupPolicy? allowlist -> group allowed? no -> drop
requireMention? yes -> mentioned? no -> store for context only
otherwise -> reply

​

Görünür yanıtlar

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

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

​

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

• Tetikleme yetkilendirmesi: aracı 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, konu geçmişi, iletilmiş üst 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ı grup kimliğine :topic:<threadId> ekler, böylece her konunun kendi oturumu olur.
• Doğrudan sohbetler ana oturumu kullanır (veya yapılandırılmışsa gönderen başına).
• Heartbeat’ler grup oturumları için atlanır.

​

Kalıp: kişisel DM’ler + genel gruplar (tek aracı)

• DM’ler: tam araçlar (ana makine)
• Gruplar: sandbox + 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",
          ],
        },
      },
    },
  },
}

• Yapılandırma anahtarları ve varsayılanlar: Gateway yapılandırması
• Bir aracın neden engellendiğini hata ayıklama: Sandbox ve Araç İlkesi ve Elevated
• Bağlama noktası ayrıntıları: Sandbox kullanımı

​

Görünen etiketler

• Kullanıcı arayüzü etiketleri varsa 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

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

​

Bahsetme kapısı (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: {
    list: [
      {
        id: "main",
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],
          historyLimit: 50,
        },
      },
    ],
  },
}

​

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

• tools: tüm grup için araçlara izin ver/araçları reddet.
• 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 takma adlar msteams olarak normalize edilir. Eski öneksiz anahtarlar hâlâ kabul edilir ve yalnızca id: olarak eşleştirilir.

{
  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 kapısı sonucu)
• Telegram forum konuları ayrıca MessageThreadId ve IsForum içerir.

​

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 değerine geri gider.

​

WhatsApp sistem istemleri

​

WhatsApp ayrıntıları

​

İlgili

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