Yapılandırma — kanallar

​

Kanallar

​

DM ve grup erişimi

​

Kanal model geçersiz kılmaları

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-5.5",
        "user:U12345": "openai/gpt-5.4-mini",
      },
      telegram: {
        "-1001234567890": "openai/gpt-5.4-mini",
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
        "123456789": "openai/gpt-4.1",
      },
    },
  },
}

​

Kanal varsayılanları ve Heartbeat

{
  channels: {
    defaults: {
      groupPolicy: "allowlist", // open | allowlist | disabled
      contextVisibility: "all", // all | allowlist | allowlist_quote
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• channels.defaults.groupPolicy: sağlayıcı düzeyinde groupPolicy ayarlanmamışsa yedek grup ilkesi.
• channels.defaults.contextVisibility: tüm kanallar için varsayılan ek bağlam görünürlüğü modu. Değerler: all (varsayılan, alıntılanmış/konu/geçmiş bağlamının tümünü dahil eder), allowlist (yalnızca izin listesindeki gönderenlerden gelen bağlamı dahil eder), allowlist_quote (izin listesiyle aynı, ancak açık alıntı/yanıt bağlamını korur). Kanal başına geçersiz kılma: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: sağlıklı kanal durumlarını Heartbeat çıktısına dahil et.
• channels.defaults.heartbeat.showAlerts: bozulmuş/hata durumlarını Heartbeat çıktısına dahil et.
• channels.defaults.heartbeat.useIndicator: kompakt gösterge tarzı Heartbeat çıktısı oluştur.

​

WhatsApp

{
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      chunkMode: "length", // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• type: "acp" içeren üst düzey bindings[] girişleri, WhatsApp DM’leri ve grupları için kalıcı ACP bağlamalarını yapılandırır. match.peer.id içinde E.164 doğrudan numara veya WhatsApp grup JID’si kullanın. Alan semantiği ACP Ajanları içinde ortaktır.

{
  channels: {
    whatsapp: {
      accounts: {
        default: {},
        personal: {},
        biz: {
          // authDir: "~/.openclaw/credentials/whatsapp/biz",
        },
      },
    },
  },
}

​

Telegram

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "your-bot-token",
      dmPolicy: "pairing",
      allowFrom: ["tg:123456789"],
      groups: {
        "*": { requireMention: true },
        "-1001234567890": {
          allowFrom: ["@admin"],
          systemPrompt: "Keep answers brief.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Stay on topic.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: "partial", // off | partial | block | progress (default: partial)
      actions: { reactions: true, sendMessage: true },
      reactionNotifications: "own", // off | own | all
      mediaMaxMb: 100,
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
      network: {
        autoSelectFamily: true,
        dnsResultOrder: "ipv4first",
      },
      apiRoot: "https://api.telegram.org",
      proxy: "socks5://localhost:9050",
      webhookUrl: "https://example.com/telegram-webhook",
      webhookSecret: "secret",
      webhookPath: "/telegram-webhook",
    },
  },
}

• Bot tokeni: channels.telegram.botToken veya channels.telegram.tokenFile (yalnızca normal dosya; sembolik bağlantılar reddedilir), varsayılan hesap için yedek olarak TELEGRAM_BOT_TOKEN.
• apiRoot yalnızca Telegram Bot API köküdür. https://api.telegram.org/bot<TOKEN> değil, https://api.telegram.org veya kendi barındırdığınız/proxy kökünüzü kullanın; openclaw doctor --fix yanlışlıkla eklenmiş sondaki /bot<TOKEN> son ekini kaldırır.
• İsteğe bağlı channels.telegram.defaultAccount, yapılandırılmış bir hesap id’siyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.
• Çok hesaplı kurulumlarda (2+ hesap id’si), yedek yönlendirmeyi önlemek için açık bir varsayılan (channels.telegram.defaultAccount veya channels.telegram.accounts.default) ayarlayın; openclaw doctor bu eksik veya geçersiz olduğunda uyarır.
• configWrites: false, Telegram tarafından başlatılan yapılandırma yazmalarını engeller (süper grup ID geçişleri, /config set|unset).
• type: "acp" içeren üst düzey bindings[] girişleri, forum konuları için kalıcı ACP bağlamalarını yapılandırır (match.peer.id içinde kanonik chatId:topic:topicId kullanın). Alan semantiği ACP Ajanları içinde ortaktır.
• Telegram akış önizlemeleri sendMessage + editMessageText kullanır (doğrudan ve grup sohbetlerinde çalışır).
• Yeniden deneme ilkesi: bkz. Yeniden deneme ilkesi.

​

Discord

{
  channels: {
    discord: {
      enabled: true,
      token: "your-bot-token",
      mediaMaxMb: 100,
      allowBots: false,
      actions: {
        reactions: true,
        stickers: true,
        polls: true,
        permissions: true,
        messages: true,
        threads: true,
        pins: true,
        search: true,
        memberInfo: true,
        roleInfo: true,
        roles: false,
        channelInfo: true,
        voiceStatus: true,
        events: true,
        moderation: false,
      },
      replyToMode: "off", // off | first | all | batched
      dmPolicy: "pairing",
      allowFrom: ["1234567890", "123456789012345678"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },
      guilds: {
        "123456789012345678": {
          slug: "friends-of-openclaw",
          requireMention: false,
          ignoreOtherMentions: true,
          reactionNotifications: "own",
          users: ["987654321098765432"],
          channels: {
            general: { allow: true },
            help: {
              allow: true,
              requireMention: true,
              users: ["987654321098765432"],
              skills: ["docs"],
              systemPrompt: "Short answers only.",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      suppressEmbeds: true,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          toolProgress: true,
        },
      },
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSessions: true,
        defaultSpawnContext: "fork",
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        connectTimeoutMs: 30000,
        reconnectGraceMs: 15000,
        tts: {
          provider: "openai",
          openai: { voice: "alloy" },
        },
      },
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["987654321098765432"],
        agentFilter: ["default"],
        sessionFilter: ["discord:"],
        target: "dm", // dm | channel | both
        cleanupAfterResolve: false,
      },
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

• Token: varsayılan hesap için yedek olarak DISCORD_BOT_TOKEN ile channels.discord.token.
• Açık bir Discord token sağlayan doğrudan giden çağrılar, çağrı için bu token’ı kullanır; hesap yeniden deneme/ilke ayarları yine etkin runtime anlık görüntüsündeki seçili hesaptan gelir.
• İsteğe bağlı channels.discord.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.
• Teslim hedefleri için user:<id> (DM) veya channel:<id> (sunucu kanalı) kullanın; yalın sayısal kimlikler reddedilir.
• Sunucu slug’ları küçük harflidir ve boşluklar - ile değiştirilir; kanal anahtarları slug’lanmış adı kullanır (# yok). Sunucu kimliklerini tercih edin.
• Bot tarafından yazılmış mesajlar varsayılan olarak yok sayılır. allowBots: true bunları etkinleştirir; yalnızca bottan bahseden bot mesajlarını kabul etmek için allowBots: "mentions" kullanın (kendi mesajları yine filtrelenir).
• Bot tarafından yazılmış gelen mesajları destekleyen kanallar paylaşılan bot döngüsü korumasını kullanabilir. Temel eş bütçeleri için channels.defaults.botLoopProtection ayarlayın, ardından yalnızca bir yüzey farklı sınırlara ihtiyaç duyduğunda kanalı veya hesabı geçersiz kılın.
• channels.discord.guilds.<id>.ignoreOtherMentions (ve kanal geçersiz kılmaları), bottan bahsetmeden başka bir kullanıcıdan veya rolden bahseden mesajları düşürür (@everyone/@here hariç).
• channels.discord.mentionAliases, göndermeden önce kararlı giden @handle metnini Discord kullanıcı kimlikleriyle eşler; böylece bilinen ekip arkadaşlarından geçici dizin önbelleği boşken bile deterministik olarak bahsedilebilir. Hesap başına geçersiz kılmalar channels.discord.accounts.<accountId>.mentionAliases altında bulunur.
• maxLinesPerMessage (varsayılan 17), 2000 karakterin altında olsa bile uzun mesajları böler.
• channels.discord.suppressEmbeds varsayılan olarak true değerindedir; bu nedenle giden URL’ler devre dışı bırakılmadıkça Discord bağlantı önizlemelerine genişlemez. Açık embeds yükleri yine normal şekilde gönderilir; mesaj başına araç çağrıları suppressEmbeds ile geçersiz kılabilir.
• channels.discord.threadBindings, Discord konuya bağlı yönlendirmeyi denetler:
  • enabled: konuya bağlı oturum özellikleri için Discord geçersiz kılması (/focus, /unfocus, /agents, /session idle, /session max-age ve bağlı teslim/yönlendirme)
  • idleHours: saat cinsinden etkinliksizlikte otomatik odaktan çıkarma için Discord geçersiz kılması (0 devre dışı bırakır)
  • maxAgeHours: saat cinsinden katı azami yaş için Discord geçersiz kılması (0 devre dışı bırakır)
  • spawnSessions: sessions_spawn({ thread: true }) ve ACP konu üretme otomatik konu oluşturma/bağlama için anahtar (varsayılan: true)
  • defaultSpawnContext: konuya bağlı üretimler için yerel alt aracı bağlamı (varsayılan olarak "fork")
• type: "acp" içeren üst düzey bindings[] girdileri, kanallar ve konular için kalıcı ACP bağlamalarını yapılandırır (match.peer.id içinde kanal/konu kimliğini kullanın). Alan semantiği ACP Aracıları içinde paylaşılır.
• channels.discord.ui.components.accentColor, Discord bileşenleri v2 kapsayıcıları için vurgu rengini ayarlar.
• channels.discord.agentComponents.ttlMs, gönderilen Discord bileşen geri çağırmalarının ne kadar süre kayıtlı kalacağını denetler. Varsayılan 1800000 (30 dakika), azami değer 86400000 (24 saat) ve hesap başına geçersiz kılmalar channels.discord.accounts.<accountId>.agentComponents.ttlMs altında bulunur. Daha uzun değerler eski düğmeleri/seçimleri/formları daha uzun süre kullanılabilir tutar, bu nedenle iş akışına uyan en kısa TTL’yi tercih edin.
• channels.discord.voice, Discord ses kanalı konuşmalarını ve isteğe bağlı otomatik katılım + LLM + TTS geçersiz kılmalarını etkinleştirir. Yalnızca metin Discord yapılandırmaları sesi varsayılan olarak kapalı bırakır; dahil olmak için channels.discord.voice.enabled=true ayarlayın.
• channels.discord.voice.model, Discord ses kanalı yanıtları için kullanılan LLM modelini isteğe bağlı olarak geçersiz kılar.
• channels.discord.voice.daveEncryption ve channels.discord.voice.decryptionFailureTolerance, @discordjs/voice DAVE seçeneklerine olduğu gibi aktarılır (varsayılan olarak true ve 24).
• channels.discord.voice.connectTimeoutMs, /vc join ve otomatik katılım denemeleri için başlangıç @discordjs/voice Ready beklemesini denetler (varsayılan olarak 30000).
• channels.discord.voice.reconnectGraceMs, bağlantısı kesilen bir ses oturumunun OpenClaw onu yok etmeden önce yeniden bağlantı sinyallemesine girmesi için ne kadar süre alabileceğini denetler (varsayılan olarak 15000).
• Discord ses oynatımı başka bir kullanıcının konuşmaya başlama olayı tarafından kesilmez. Geri bildirim döngülerinden kaçınmak için OpenClaw, TTS oynatılırken yeni ses yakalamayı yok sayar.
• OpenClaw ayrıca tekrarlanan şifre çözme hatalarından sonra bir ses oturumundan ayrılıp yeniden katılarak ses alma kurtarması dener.
• channels.discord.streaming, kanonik akış modu anahtarıdır. Discord varsayılan olarak streaming.mode: "progress" kullanır; böylece araç/iş ilerlemesi tek bir düzenlenmiş önizleme mesajında görünür. Bunu devre dışı bırakmak için streaming.mode: "off" ayarlayın. Eski streamMode ve boolean streaming değerleri runtime takma adları olarak kalır; kalıcı yapılandırmayı yeniden yazmak için openclaw doctor --fix çalıştırın.
• channels.discord.autoPresence, runtime kullanılabilirliğini bot varlığına eşler (healthy => online, degraded => idle, exhausted => dnd) ve isteğe bağlı durum metni geçersiz kılmalarına izin verir.
• channels.discord.dangerouslyAllowNameMatching, değiştirilebilir ad/etiket eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu).
• channels.discord.execApprovals: Discord’a özgü exec onayı teslimi ve onaylayıcı yetkilendirmesi.
  • enabled: true, false veya "auto" (varsayılan). Otomatik modda exec onayları, onaylayıcılar approvers veya commands.ownerAllowFrom üzerinden çözümlenebildiğinde etkinleşir.
  • approvers: exec isteklerini onaylamasına izin verilen Discord kullanıcı kimlikleri. Atlandığında commands.ownerAllowFrom değerine geri döner.
  • agentFilter: isteğe bağlı aracı kimliği izin listesi. Tüm aracılar için onayları iletmek üzere atlayın.
  • sessionFilter: isteğe bağlı oturum anahtarı örüntüleri (alt dize veya regex).
  • target: onay istemlerinin nereye gönderileceği. "dm" (varsayılan) onaylayıcı DM’lerine gönderir, "channel" kaynak kanala gönderir, "both" ikisine de gönderir. Hedef "channel" içerdiğinde düğmeler yalnızca çözümlenmiş onaylayıcılar tarafından kullanılabilir.
  • cleanupAfterResolve: true olduğunda onay, ret veya zaman aşımından sonra onay DM’lerini siler.

​

Google Chat

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url", // app-url | project-number
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890",
      dm: {
        enabled: true,
        policy: "pairing",
        allowFrom: ["users/1234567890"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• Hizmet hesabı JSON: satır içi (serviceAccount) veya dosya tabanlı (serviceAccountFile).
• Hizmet hesabı SecretRef de desteklenir (serviceAccountRef).
• Ortam yedekleri: GOOGLE_CHAT_SERVICE_ACCOUNT veya GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Teslim hedefleri için spaces/<spaceId> veya users/<userId> kullanın.
• channels.googlechat.dangerouslyAllowNameMatching, değiştirilebilir e-posta yetkili kimliği eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu).

​

Slack

{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      socketMode: {
        clientPingTimeout: 15000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
      dmPolicy: "pairing",
      allowFrom: ["U123", "U456", "*"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
      channels: {
        C123: { allow: true, requireMention: true, allowBots: false },
        "#general": {
          allow: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Short answers only.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
      },
      actions: {
        reactions: true,
        messages: true,
        pins: true,
        memberInfo: true,
        emojiList: true,
      },
      slashCommand: {
        enabled: true,
        name: "openclaw",
        sessionPrefix: "slack:slash",
        ephemeral: true,
      },
      typingReaction: "hourglass_flowing_sand",
      unfurlLinks: false,
      unfurlMedia: false,
      textChunkLimit: 4000,
      chunkMode: "length",
      streaming: {
        mode: "partial", // off | partial | block | progress
        nativeTransport: true, // use Slack native streaming API when mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Soket modu hem botToken hem de appToken gerektirir (varsayılan hesap ortam geri dönüşü için SLACK_BOT_TOKEN + SLACK_APP_TOKEN).
• HTTP modu botToken ile birlikte signingSecret gerektirir (kök düzeyde veya hesap başına).
• socketMode, Slack SDK Soket Modu taşıma ayarlarını herkese açık Bolt alıcı API’sine iletir. Bunu yalnızca ping/pong zaman aşımı veya eski websocket davranışını araştırırken kullanın. clientPingTimeout varsayılan olarak 15000 değerindedir; serverPingTimeout ve pingPongLoggingEnabled yalnızca yapılandırıldığında iletilir.
• botToken, appToken, signingSecret ve userToken düz metin dizelerini veya SecretRef nesnelerini kabul eder.
• Slack hesap anlık görüntüleri, kimlik bilgisi başına kaynak/durum alanlarını gösterir; örneğin botTokenSource, botTokenStatus, appTokenStatus ve HTTP modunda signingSecretStatus. configured_unavailable, hesabın SecretRef üzerinden yapılandırıldığı ancak mevcut komut/çalışma zamanı yolunun gizli değerini çözemediği anlamına gelir.
• configWrites: false, Slack tarafından başlatılan yapılandırma yazmalarını engeller.
• İsteğe bağlı channels.slack.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.
• channels.slack.streaming.mode, kanonik Slack akış modu anahtarıdır. channels.slack.streaming.nativeTransport, Slack’in yerel akış taşımasını kontrol eder. Eski streamMode, boolean streaming ve nativeStreaming değerleri çalışma zamanı takma adları olarak kalır; kalıcı yapılandırmayı yeniden yazmak için openclaw doctor --fix çalıştırın.
• unfurlLinks ve unfurlMedia, bot yanıtları için Slack’in chat.postMessage bağlantı ve medya genişletme boolean değerlerini iletir. unfurlLinks varsayılan olarak false değerindedir; böylece etkinleştirilmedikçe giden bot bağlantıları satır içinde genişletilmez. unfurlMedia, yapılandırılmadıkça atlanır. Bir hesap için üst düzey değeri geçersiz kılmak üzere herhangi bir değeri channels.slack.accounts.<accountId> altında ayarlayın.
• Teslim hedefleri için user:<id> (DM) veya channel:<id> kullanın.

• Slack yerel akışı ve Slack asistan tarzı “yazıyor…” thread durumu, bir yanıt thread hedefi gerektirir. Üst düzey DM’ler varsayılan olarak thread dışında kalır; bu yüzden thread tarzı yerel akış/durum önizlemesini göstermek yerine Slack taslak gönder-ve-düzenle önizlemeleri üzerinden akış yapmaya devam edebilirler.
• typingReaction, bir yanıt çalışırken gelen Slack mesajına geçici bir tepki ekler, ardından tamamlandığında kaldırır. "hourglass_flowing_sand" gibi bir Slack emoji kısa kodu kullanın.
• channels.slack.execApprovals: Slack-yerel onay istemcisi teslimi ve exec onaylayıcı yetkilendirmesi. Discord ile aynı şema: enabled (true/false/"auto"), approvers (Slack kullanıcı kimlikleri), agentFilter, sessionFilter ve target ("dm", "channel" veya "both"). Plugin onayları, Slack Plugin onaylayıcıları çözümlendiğinde Slack kaynaklı istekler için bu yerel istemci yolunu kullanabilir; Slack-yerel Plugin onay teslimi, Slack kaynaklı oturumlar veya Slack hedefleri için approvals.plugin üzerinden de etkinleştirilebilir. Plugin onayları, exec onaylayıcıları değil, allowFrom ve varsayılan yönlendirmeden gelen Slack Plugin onaylayıcılarını kullanır.

​

Mattermost

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
      chatmode: "oncall", // oncall | onmessage | onchar
      oncharPrefixes: [">", "!"],
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
      commands: {
        native: true, // opt-in
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Optional explicit URL for reverse-proxy/public deployments
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      chunkMode: "length",
    },
  },
}

• commands.callbackPath tam URL değil, bir yol olmalıdır (örneğin /api/channels/mattermost/command).
• commands.callbackUrl, OpenClaw Gateway uç noktasına çözümlenmeli ve Mattermost sunucusundan erişilebilir olmalıdır.
• Yerel slash geri çağrıları, slash komutu kaydı sırasında Mattermost tarafından döndürülen komut başına token’larla doğrulanır. Kayıt başarısız olursa veya hiçbir komut etkinleştirilmezse, OpenClaw geri çağrıları Unauthorized: invalid command token. ile reddeder.
• Özel/tailnet/dahili geri çağrı host’ları için Mattermost, ServiceSettings.AllowedUntrustedInternalConnections değerinin geri çağrı host’unu/etki alanını içermesini gerektirebilir. Tam URL’ler değil, host/etki alanı değerlerini kullanın.
• channels.mattermost.configWrites: Mattermost tarafından başlatılan yapılandırma yazmalarına izin ver veya reddet.
• channels.mattermost.requireMention: kanallarda yanıt vermeden önce @mention gerektir.
• channels.mattermost.groups.<channelId>.requireMention: kanal başına mention kapısı geçersiz kılması (varsayılan için "*").
• İsteğe bağlı channels.mattermost.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.

​

Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // optional account binding
      dmPolicy: "pairing",
      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      configWrites: true,
      reactionNotifications: "own", // off | own | all | allowlist
      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      historyLimit: 50,
    },
  },
}

• channels.signal.account: kanal başlangıcını belirli bir Signal hesap kimliğine sabitle.
• channels.signal.configWrites: Signal tarafından başlatılan yapılandırma yazmalarına izin ver veya reddet.
• İsteğe bağlı channels.signal.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.

​

iMessage

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
      remoteHost: "user@gateway-host",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],
      historyLimit: 50,
      includeAttachments: false,
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      mediaMaxMb: 16,
      service: "auto",
      sendTransport: "auto",
      region: "US",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
    },
  },
}

• İsteğe bağlı channels.imessage.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.
• Messages DB için Full Disk Access gerektirir.
• chat_id:<id> hedeflerini tercih edin. Sohbetleri listelemek için imsg chats --limit 20 kullanın.
• cliPath bir SSH sarmalayıcısına işaret edebilir; SCP ek alma işlemi için remoteHost (host veya user@host) ayarlayın.
• attachmentRoots ve remoteAttachmentRoots, gelen ek yollarını sınırlar (varsayılan: /Users/*/Library/Messages/Attachments).
• SCP sıkı host anahtarı denetimi kullanır; bu yüzden relay host anahtarının ~/.ssh/known_hosts içinde zaten bulunduğundan emin olun.
• channels.imessage.configWrites: iMessage tarafından başlatılan yapılandırma yazmalarına izin ver veya reddet.
• channels.imessage.sendTransport: normal giden yanıtlar için tercih edilen imsg RPC gönderme taşıması. auto (varsayılan), çalışıyorsa mevcut sohbetler için IMCore köprüsünü kullanır, ardından AppleScript’e geri döner; bridge özel API teslimi gerektirir; applescript herkese açık Messages otomasyon yolunu zorlar.
• channels.imessage.actions.*: imsg status / openclaw channels status --probe tarafından da kapılanan özel API eylemlerini etkinleştir.
• channels.imessage.includeAttachments varsayılan olarak kapalıdır; aracı turlarında gelen medya beklemeden önce bunu true olarak ayarlayın.
• Köprü/gateway yeniden başlatmasından sonra gelen kurtarma otomatiktir (GUID tekilleştirme artı eski backlog yaş sınırı). Mevcut channels.imessage.catchup.enabled: true yapılandırmaları, kullanımdan kaldırılmış bir uyumluluk profili olarak hâlâ onurlandırılır.
• channels.imessage.groups: grup kayıt defteri ve grup başına ayarlar. groupPolicy: "allowlist" ile grup mesajlarının kayıt defteri kapısından geçebilmesi için açık chat_id anahtarları veya "*" joker girişi yapılandırın.
• type: "acp" içeren üst düzey bindings[] girdileri, iMessage konuşmalarını kalıcı ACP oturumlarına bağlayabilir. match.peer.id içinde normalleştirilmiş bir tanıtıcı veya açık sohbet hedefi (chat_id:*, chat_guid:*, chat_identifier:*) kullanın. Paylaşılan alan semantiği: ACP Aracıları.

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

​

Matrix

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
      encryption: true,
      initialSyncLimit: 20,
      defaultAccount: "ops",
      accounts: {
        ops: {
          name: "Ops",
          userId: "@ops:example.org",
          accessToken: "syt_ops_xxx",
        },
        alerts: {
          userId: "@alerts:example.org",
          password: "secret",
          proxy: "http://127.0.0.1:7891",
        },
      },
    },
  },
}

• Belirteç kimlik doğrulaması accessToken kullanır; parola kimlik doğrulaması userId + password kullanır.
• channels.matrix.proxy, Matrix HTTP trafiğini açık bir HTTP(S) proxy üzerinden yönlendirir. Adlandırılmış hesaplar bunu channels.matrix.accounts.<id>.proxy ile geçersiz kılabilir.
• channels.matrix.network.dangerouslyAllowPrivateNetwork, özel/dahili homeserver’lara izin verir. proxy ve bu ağ katılımı birbirinden bağımsız denetimlerdir.
• channels.matrix.defaultAccount, çok hesaplı kurulumlarda tercih edilen hesabı seçer.
• channels.matrix.autoJoin varsayılan olarak off değerindedir; bu nedenle davet edilen odalar ve yeni DM tarzı davetler, autoJoinAllowlist ile autoJoin: "allowlist" veya autoJoin: "always" ayarlanana kadar yok sayılır.
• channels.matrix.execApprovals: Matrix’e özgü exec onayı teslimi ve onaylayıcı yetkilendirmesi.
  • enabled: true, false veya "auto" (varsayılan). Otomatik modda, onaylayıcılar approvers veya commands.ownerAllowFrom üzerinden çözümlenebildiğinde exec onayları etkinleşir.
  • approvers: Exec isteklerini onaylamasına izin verilen Matrix kullanıcı kimlikleri (örn. @owner:example.org).
  • agentFilter: İsteğe bağlı ajan kimliği izin listesi. Tüm ajanlar için onayları iletmek üzere atlayın.
  • sessionFilter: İsteğe bağlı oturum anahtarı desenleri (alt dize veya regex).
  • target: Onay istemlerinin nereye gönderileceği. "dm" (varsayılan), "channel" (kaynak oda) veya "both".
  • Hesap başına geçersiz kılmalar: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope, Matrix DM’lerinin oturumlarda nasıl gruplanacağını denetler: per-user (varsayılan) yönlendirilen eşe göre paylaşır, per-room ise her DM odasını yalıtır.
• Matrix durum yoklamaları ve canlı dizin aramaları, çalışma zamanı trafiğiyle aynı proxy ilkesini kullanır.
• Tam Matrix yapılandırması, hedefleme kuralları ve kurulum örnekleri Matrix içinde belgelenmiştir.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // see /channels/msteams
    },
  },
}

• Burada kapsanan temel anahtar yolları: channels.msteams, channels.msteams.configWrites.
• Tam Teams yapılandırması (kimlik bilgileri, Webhook, DM/grup ilkesi, ekip başına/kanal başına geçersiz kılmalar) Microsoft Teams içinde belgelenmiştir.

​

IRC

{
  channels: {
    irc: {
      enabled: true,
      dmPolicy: "pairing",
      configWrites: true,
      nickserv: {
        enabled: true,
        service: "NickServ",
        password: "${IRC_NICKSERV_PASSWORD}",
        register: false,
        registerEmail: "bot@example.com",
      },
    },
  },
}

• Burada kapsanan temel anahtar yolları: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• İsteğe bağlı channels.irc.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.
• Tam IRC kanal yapılandırması (host/port/TLS/kanallar/izin listeleri/bahsetme geçidi) IRC içinde belgelenmiştir.

​

Çoklu hesap (tüm kanallar)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• accountId atlandığında default kullanılır (CLI + yönlendirme).
• Ortam belirteçleri yalnızca varsayılan hesaba uygulanır.
• Temel kanal ayarları, hesap başına geçersiz kılınmadıkça tüm hesaplara uygulanır.
• Her hesabı farklı bir ajana yönlendirmek için bindings[].match.accountId kullanın.
• Tek hesaplı üst düzey kanal yapılandırmasındayken openclaw channels add (veya kanal başlangıç kurulumu) ile varsayılan olmayan bir hesap eklerseniz OpenClaw, özgün hesabın çalışmaya devam etmesi için hesap kapsamlı üst düzey tek hesap değerlerini önce kanal hesap haritasına yükseltir. Çoğu kanal bunları channels.<channel>.accounts.default içine taşır; Matrix bunun yerine mevcut eşleşen adlandırılmış/varsayılan hedefi koruyabilir.
• Mevcut yalnızca kanal bağlamaları (accountId yok) varsayılan hesapla eşleşmeye devam eder; hesap kapsamlı bağlamalar isteğe bağlı kalır.
• openclaw doctor --fix, hesap kapsamlı üst düzey tek hesap değerlerini o kanal için seçilen yükseltilmiş hesaba taşıyarak karma şekilleri de onarır. Çoğu kanal accounts.default kullanır; Matrix bunun yerine mevcut eşleşen adlandırılmış/varsayılan hedefi koruyabilir.

​

Diğer Plugin kanalları

​

Grup sohbeti bahsetme geçidi

• Metadata bahsetmeleri: Yerel platform @-bahsetmeleri. WhatsApp self-chat modunda yok sayılır.
• Metin desenleri: agents.list[].groupChat.mentionPatterns içindeki güvenli regex desenleri. Geçersiz desenler ve güvenli olmayan iç içe yineleme yok sayılır.
• Bahsetme geçidi yalnızca algılama mümkün olduğunda uygulanır (yerel bahsetmeler veya en az bir desen).

{
  messages: {
    visibleReplies: "automatic", // force old automatic final replies for direct/source chats
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // always-on unmentioned room chatter becomes quiet context
      visibleReplies: "message_tool", // opt-in; require message(action=send) for visible room replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

DM geçmiş sınırları

{
  channels: {
    telegram: {
      dmHistoryLimit: 30,
      dms: {
        "123456789": { historyLimit: 50 },
      },
    },
  },
}

​

Self-chat modu

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },
      },
    ],
  },
}

​

Komutlar (sohbet komutu işleme)

{
  commands: {
    native: "auto", // register native commands when supported
    nativeSkills: "auto", // register native skill commands when supported
    text: true, // parse /commands in chat messages
    bash: false, // allow ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // allow /config
    mcp: false, // allow /mcp
    plugins: false, // allow /plugins
    debug: false, // allow /debug
    restart: true, // allow /restart + gateway restart tool
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

İlgili

• Yapılandırma başvurusu — üst düzey anahtarlar
• Yapılandırma — aracılar
• Kanallara genel bakış