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.6-sol",
        "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
      implicitMentions: {
        replyToBot: true,
        quotedBot: true,
        threadParticipation: true,
      },
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• channels.defaults.groupPolicy: sağlayıcı düzeyindeki groupPolicy ayarlanmamışsa kullanılan 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ılanan/iş parçacığı/geçmiş bağlamının tamamını dahil eder), allowlist (yalnızca izin listesindeki göndericilerden gelen bağlamı dahil eder), allowlist_quote (izin listesiyle aynıdır ancak açık alıntı/yanıt bağlamını korur). Kanal başına geçersiz kılma: channels.<channel>.contextVisibility.
• channels.defaults.implicitMentions: desteklenen hangi gelen olguların bahsetme sayılacağını denetler. replyToBot, quotedBot ve threadParticipation değerlerinin her biri varsayılan olarak true olur ve mevcut davranışı korur. Kanal başına channels.<channel>.implicitMentions veya hesap başına channels.<channel>.accounts.<id>.implicitMentions ile geçersiz kılın; her bayrak hesap -> kanal -> varsayılanlar sırasını bağımsız olarak çözümler. Adlar olumludur: söz konusu olgunun bahsetme geçidini atlamasını durdurmak için bayrağı false olarak ayarlayın. Yerel açık bahsetmelere her zaman izin verilir ve kanal söz konusu olguyu üretmiyorsa bayrağın etkisi olmaz. Güncel üretici matrisi için Bahsetme geçidi bölümüne bakın. Bu ayarlar giden yanıt/iş parçacığı modlarını veya yetkilendirilmiş komut işlemeyi değiştirmez.
• channels.defaults.heartbeat.showOk: sağlıklı kanal durumlarını Heartbeat çıktısına dahil eder (varsayılan false).
• channels.defaults.heartbeat.showAlerts: bozulmuş/hata durumlarını Heartbeat çıktısına dahil eder (varsayılan true).
• channels.defaults.heartbeat.useIndicator: kompakt gösterge biçimli Heartbeat çıktısı oluşturur (varsayılan true).

​

WhatsApp

{
  web: {
    enabled: true,
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" }, // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // mavi tikler (kendi kendine sohbet modunda false)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• type: "acp" içeren üst düzey bindings[] girdileri, WhatsApp DM’leri ve grupları için kalıcı ACP bağlamaları yapılandırır. match.peer.id içinde doğrudan bir E.164 numarası veya WhatsApp grup JID’si kullanın. Alan semantiği ACP Ajanları bölümünde 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: "Yanıtları kısa tut.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Konuya bağlı kal.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git yedeklemesi" },
        { command: "generate", description: "Bir görsel oluştur" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: { mode: "partial" }, // off | partial | block | progress (varsayılan: 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",
      trustedLocalFileRoots: ["/srv/telegram-bot-api-data"],
      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 kullanılır.
• 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ü kullanın; openclaw doctor --fix, yanlışlıkla eklenmiş sondaki /bot<TOKEN> son ekini kaldırır.
• --local modundaki kendi barındırdığınız bir Bot API sunucusu için trustedLocalFileRoots, OpenClaw’un okuyabileceği ana makine yollarını listeler. Sunucu veri birimini OpenClaw ana makinesine bağlayın ve veri kökünü ya da token başına dizini yapılandırın; /var/lib/telegram-bot-api altındaki konteyner yolları bu köklere eşlenir. Diğer mutlak yollar reddedilmeye devam eder.
• İsteğe bağlı channels.telegram.defaultAccount, yapılandırılmış bir hesap kimliğiyle eşleştiğinde varsayılan hesap seçimini geçersiz kılar.
• Çoklu hesap kurulumlarında (2+ hesap kimliği), yedek yönlendirmeyi önlemek için açık bir varsayılan (channels.telegram.defaultAccount veya channels.telegram.accounts.default) ayarlayın; bu eksik veya geçersiz olduğunda openclaw doctor uyarı verir.
• configWrites: false, Telegram tarafından başlatılan yapılandırma yazmalarını engeller (süper grup kimliği taşımaları, /config set|unset).
• type: "acp" içeren üst düzey bindings[] girdileri, forum konuları için kalıcı ACP bağlamaları yapılandırır (match.peer.id içinde standart chatId:topic:topicId kullanın). Alan semantiği ACP Ajanları bölümünde ortaktır.
• Telegram akış önizlemeleri sendMessage + editMessageText kullanır (doğrudan ve grup sohbetlerinde çalışır).
• network.dnsResultOrder, yaygın IPv6 getirme hatalarını önlemek için varsayılan olarak "ipv4first" olur.
• Yeniden deneme ilkesi: Yeniden deneme ilkesi bölümüne bakın.

​

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,
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        chunkMode: "length", // length | newline
        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: channels.discord.token, varsayılan hesap için yedek olarak DISCORD_BOT_TOKEN kullanılır.
• 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 çalışma zamanı anlık görüntüsünde seçilen hesaptan alınır.
• İ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; ön eksiz sayısal kimlikler reddedilir.
• Sunucu kısa adları küçük harflidir ve boşlukların yerine - kullanılır; kanal anahtarları kısa ada dönüştürülmüş adı kullanır (# yoktur). Sunucu kimliklerini tercih edin.
• Bot tarafından oluşturulan 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 oluşturulan gelen mesajları destekleyen kanallar, paylaşılan bot döngüsü korumasını kullanabilir. Temel çift 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ı), başka bir kullanıcıdan veya rolden bahseden ancak bottan bahsetmeyen mesajları kaldırır (@everyone/@here hariç).
• channels.discord.mentionAliases, kararlı giden @handle metnini göndermeden önce Discord kullanıcı kimlikleriyle eşler; böylece geçici dizin önbelleği boş olsa bile bilinen ekip arkadaşlarından 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 olsalar bile uzun mesajları böler.
• channels.discord.suppressEmbeds varsayılan olarak true değerine sahiptir; bu nedenle devre dışı bırakılmadıkça giden URL’ler Discord bağlantı önizlemelerine genişletilmez. Açık embeds yükleri normal şekilde gönderilmeye devam eder; mesaj başına araç çağrıları suppressEmbeds ile bunu geçersiz kılabilir.
• channels.discord.threadBindings, Discord iş parçacığına bağlı yönlendirmeyi denetler:
  • enabled: İş parçacığına 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 hareketsizlik durumunda otomatik odaktan çıkarma için Discord geçersiz kılması (0 devre dışı bırakır)
  • maxAgeHours: Saat cinsinden kesin azami yaş için Discord geçersiz kılması (0 devre dışı bırakır)
  • spawnSessions: sessions_spawn({ thread: true }) ve ACP iş parçacığı oluşturma sırasında otomatik iş parçacığı oluşturma/bağlama anahtarı (varsayılan: true)
  • defaultSpawnContext: İş parçacığına bağlı oluşturmalar için yerel alt ajan bağlamı (varsayılan olarak "fork")
• type: "acp" içeren üst düzey bindings[] girdileri, kanallar ve iş parçacıkları için kalıcı ACP bağlamalarını yapılandırır (match.peer.id içinde kanal/iş parçacığı kimliğini kullanın). Alan semantiği ACP Ajanları bölümünde paylaşılır.
• channels.discord.ui.components.accentColor, Discord bileşenleri v2 kapsayıcılarının vurgu rengini ayarlar.
• channels.discord.agentComponents.ttlMs, gönderilen Discord bileşeni geri çağırmalarının ne kadar süre kayıtlı kalacağını denetler. Varsayılan 1800000 (30 dakika), azami 86400000 (24 saat). Hesap başına geçersiz kılmalar channels.discord.accounts.<accountId>.agentComponents.ttlMs altında bulunur. İş 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ılma + LLM + TTS geçersiz kılmalarını etkinleştirir. Yalnızca metin içeren Discord yapılandırmalarında ses varsayılan olarak kapalıdır; etkinleştirmek 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 (varsayılan true) ve channels.discord.voice.decryptionFailureTolerance (varsayılan 24), @discordjs/voice DAVE seçeneklerine aktarılır.
• channels.discord.voice.connectTimeoutMs, /vc join ve otomatik katılma girişimleri için ilk @discordjs/voice Ready bekleme süresini denetler (varsayılan 30000).
• channels.discord.voice.reconnectGraceMs, OpenClaw bağlantısı kesilmiş bir ses oturumunu yok etmeden önce oturumun yeniden bağlantı sinyallemesine geçmesinin ne kadar sürebileceğini denetler (varsayılan 15000).
• Discord ses oynatımı, başka bir kullanıcının konuşmaya başlama olayıyla kesintiye uğramaz. Geri besleme döngülerini önlemek için OpenClaw, TTS oynatılırken yeni ses yakalamayı yok sayar.
• OpenClaw ayrıca tekrarlanan şifre çözme hatalarından sonra ses oturumundan ayrılıp yeniden katılarak ses alımını kurtarmayı dener.
• channels.discord.streaming, standart akış modu anahtarıdır. Discord varsayılan olarak streaming.mode: "progress" kullanır; böylece araç/iş ilerlemesi düzenlenen tek bir önizleme mesajında görünür. Devre dışı bırakmak için streaming.mode: "off" ayarlayın. Eski düz anahtarlar (streamMode, chunkMode, blockStreaming, draftChunk, blockStreamingCoalesce) artık çalışma zamanında okunmaz; kalıcı yapılandırmayı taşımak için openclaw doctor --fix çalıştırın.
• channels.discord.autoPresence, çalışma zamanı kullanılabilirliğini bot durumuyla eşler (sağlıklı => çevrimiçi, bozulmuş => boşta, tükenmiş => rahatsız etmeyin) ve isteğe bağlı durum metni geçersiz kılmalarına izin verir.
• channels.discord.guilds.<id>.presenceEvents, insan kullanılabilirliği gelişlerini ajan sistem olayları olarak yapılandırılmış tek bir Discord kanalına yönlendirir. Uygun üyelerin channelId öğesini görüntüleyebilmesi gerekir; herkese açık iş parçacıkları üst öğenin görünürlüğünü devralırken özel iş parçacıkları ek olarak üyelik veya Manage Threads gerektirir. users bu kitleyi daha da daraltabilir. Eksiksiz GUILD_CREATE anlık görüntülerinden mevcut çevrimiçi üyeleri başlangıçta doldurur, gözlemlenen çevrimdışından çevrimiçine geçişleri yönlendirir ve daha önce görülmemiş bir üyenin sonraki ilk çevrimiçi sinyalini, anlık görüntüden sonra çevrimiçi mi olduğu yoksa katıldığı mı konusunda iddiada bulunmadan yeni kullanılabilir olarak değerlendirir. Discord’un 75.000 üyelik anlık görüntü sınırının üzerindeki sunucular önce açık bir çevrimdışı güncelleme gerektirir. Kısıtlama ayarları: reconnectSuppressSeconds (sunucu varlık durumu yeniden oluşturulurken yeni bir Gateway oturumundan sonraki sessiz pencere, varsayılan 300, 0 devre dışı bırakır) ve burstLimit/burstWindowSeconds (sunucu başına başarıyla kuyruğa alınan olay hız sınırı, varsayılan olarak 60 saniyelik kayan pencerede 8 olay). Devam ettirilen oturumlar yeniden bağlantı engelleme penceresini başlatmaz. Kullanıcı başına mevcut yeniden karşılama bekleme süresi sekiz saat olarak kalır. channels.discord.intents.presence=true, Discord Developer Portal’daki ayrıcalıklı Presence Intent ve etkinleştirilmiş bir ajan Heartbeat gerektirir.
• channels.discord.dangerouslyAllowNameMatching, değiştirilebilir ad/etiket eşleştirmesini yeniden etkinleştirir (acil durum uyumluluk modu).
• channels.discord.execApprovals: Discord’a özgü yürütme onayı teslimi ve onaylayan yetkilendirmesi.
  • enabled: true, false veya "auto" (varsayılan). Otomatik modda yürütme onayları, onaylayanlar approvers veya commands.ownerAllowFrom üzerinden çözümlenebildiğinde etkinleşir.
  • approvers: Yürütme isteklerini onaylamasına izin verilen Discord kullanıcı kimlikleri. Belirtilmediğinde commands.ownerAllowFrom değerine geri döner.
  • agentFilter: İsteğe bağlı ajan kimliği izin listesi. Tüm ajanların onaylarını iletmek için belirtmeyin.
  • sessionFilter: İsteğe bağlı oturum anahtarı kalıpları (alt dize veya düzenli ifade).
  • target: Onay istemlerinin gönderileceği yer. "dm" (varsayılan), onaylayanların DM’lerine gönderir; "channel", kaynak kanala gönderir; "both", her ikisine de gönderir. Hedef "channel" içerdiğinde düğmeler yalnızca çözümlenen onaylayanlar 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",
      dmPolicy: "pairing",
      allowFrom: ["users/1234567890"],
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• Hizmet hesabı JSON’u: satır içi (serviceAccount) veya dosya tabanlı (serviceAccountFile).
• serviceAccount, doğrudan bir SecretRef kabul eder.
• Ortam değişkeni yedekleri: GOOGLE_CHAT_SERVICE_ACCOUNT veya GOOGLE_CHAT_SERVICE_ACCOUNT_FILE (yalnızca varsayılan hesap).
• Teslim hedefleri için spaces/<spaceId> veya users/<userId> kullanın.
• channels.googlechat.dangerouslyAllowNameMatching, değiştirilebilir e-posta sorumlusu 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: { enabled: true, requireMention: true, allowBots: false },
        "#general": {
          enabled: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Yalnızca kısa yanıtlar ver.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
        initialHistoryLimit: 20,
      },
      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,
      streaming: {
        mode: "partial", // off | partial | block | progress
        chunkMode: "length", // length | newline
        nativeTransport: true, // mode=partial olduğunda Slack yerel akış API'sini kullan
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Socket 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üzeyinde veya hesap başına).
• Kullanıcı kimliği (identity: "user"), yetkilendiren kişi olarak gönderi yayımlar ve okur. Socket Modunda userToken ile birlikte appToken; HTTP modunda ise userToken ile birlikte signingSecret gerektirir. Bot belirteci veya bot kullanıcısı gerekmez. Kullanıcı kapsamları ve olay abonelikleri için Kullanıcı kimliği bölümüne bakın.
• enterpriseOrgInstall: true, bir hesabı Slack Enterprise Grid kuruluş genelindeki olay yoluna dahil eder. Başlangıçta bot belirteci auth.test ile doğrulanır ve yapılandırılan mod Slack’in kurulum kimliğiyle eşleşmediğinde başlangıç başarısız olur. Enterprise DM’leri devre dışı bırakılmalı veya geçerli bir allowFrom: ["*"] ile dmPolicy: "open" kullanılmalıdır. Kanal ve kullanıcı politikaları kararlı Slack kimliklerini kullanmalıdır; değiştirilebilir adlar ve desteklenmeyen kanal ön ekleri başlangıcın başarısız olmasına neden olur. V1 yalnızca doğrudan Socket Modu veya HTTP message ve app_mention olaylarını anında yanıtlarla işler; aktarma, komutlar, etkileşimler, App Home, tepki olayı dinleyicileri, sabitlemeler, eylem araçları, yerel onaylar, bağlamalar, ertelenmiş teslimat ve proaktif gönderimler kullanılamaz. Dinleyici tarafından yönetilen alındı bildirimi, yazma ve durum tepkileri reactions:write ile kullanılabilir olmaya devam eder; gelen tepki bildirimleri ve tepki eylemi araçları kullanılamaz. En az ayrıcalıklı manifest, kurulum iş akışı ve tüm kısıtlamalar için Enterprise Grid kuruluş geneli kurulumlar bölümüne bakın.
• socketMode, Slack SDK Socket Modu aktarım ayarlarını genel 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ğerini kullanır; 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, userTokenSource, userTokenStatus, appTokenStatus ve HTTP modunda signingSecretStatus. configured_unavailable, hesabın SecretRef aracılığıyla yapılandırıldığı ancak geçerli komut/çalışma zamanı yolunun gizli değeri çözemediği anlamına gelir.
• configWrites: false, Slack tarafından başlatılan yapılandırma yazma işlemlerini 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, standart Slack akış modu anahtarıdır (varsayılan "partial"). channels.slack.streaming.nativeTransport, Slack’in yerel akış aktarımını denetler (varsayılan true). Eski streamMode, boolean streaming, chunkMode, blockStreaming, blockStreamingCoalesce ve nativeStreaming değerleri artık çalışma zamanında okunmaz; kalıcı yapılandırmayı streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport} biçimine taşımak için openclaw doctor --fix komutunu çalıştırın.
• unfurlLinks ve unfurlMedia, bot yanıtları için Slack’in chat.postMessage bağlantı ve medya önizleme boolean değerlerini iletir. unfurlLinks varsayılan olarak false değerini kullanır; böylece etkinleştirilmedikçe giden bot bağlantıları satır içinde genişletilmez. unfurlMedia, yapılandırılmadıkça dahil edilmez. Tek bir hesap için üst düzey değeri geçersiz kılmak üzere iki değerden birini channels.slack.accounts.<accountId> konumunda ayarlayın.
• Teslimat hedefleri için user:<id> (DM) veya channel:<id> kullanın.

• Slack yerel akışı ve Slack asistanı tarzındaki “yazıyor…” ileti dizisi durumu, bir yanıt ileti dizisi hedefi gerektirir. Üst düzey DM’ler varsayılan olarak ileti dizisi dışında kalır; bu nedenle ileti dizisi tarzındaki yerel akış/durum önizlemesini göstermek yerine Slack taslak gönderi ve düzenleme önizlemeleri üzerinden akış yapmaya devam edebilirler.
• typingReaction, yanıt işlenirken gelen Slack iletisine geçici bir tepki ekler ve tamamlandığında bunu kaldırır. "hourglass_flowing_sand" gibi bir Slack emoji kısa kodu kullanın.
• channels.slack.execApprovals: Slack’e özgü onay istemcisi teslimatı ve yürütme onaylayıcısı 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’e özgü Plugin onayı teslimatı, Slack kaynaklı oturumlar veya Slack hedefleri için approvals.plugin aracılığıyla da etkinleştirilebilir. Plugin onayları, yürütme onaylayıcılarını değil, allowFrom kaynağındaki Slack Plugin onaylayıcılarını ve varsayılan yönlendirmeyi kullanır.

​

Mattermost

openclaw plugins install @openclaw/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, // isteğe bağlı etkinleştirme
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Ters proxy/genel dağıtımlar için isteğe bağlı açık URL
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      streaming: { chunkMode: "length" },
    },
  },
}

• commands.callbackPath, tam URL değil bir yol (örneğin /api/channels/mattermost/command) olmalıdır.
• commands.callbackUrl, OpenClaw Gateway uç noktasına çözümlenmeli ve Mattermost sunucusundan erişilebilir olmalıdır.
• Yerel eğik çizgi geri çağrılarının kimliği, eğik çizgi komutu kaydı sırasında Mattermost tarafından döndürülen komut başına belirteçlerle 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ı ana makineleri için Mattermost, geri çağrı ana makinesinin/alan adının ServiceSettings.AllowedUntrustedInternalConnections içinde yer almasını gerektirebilir. Tam URL’ler yerine ana makine/alan adı değerlerini kullanın.
• channels.mattermost.configWrites: Mattermost tarafından başlatılan yapılandırma yazma işlemlerine izin verin veya bunları reddedin.
• channels.mattermost.requireMention: kanallarda yanıt vermeden önce @mention gerektirir.
• channels.mattermost.groups.<channelId>.requireMention: kanal başına bahsetme geçidi geçersiz kılma değeri (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", // isteğe bağlı hesap bağlaması
      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 sabitler.
• channels.signal.configWrites: Signal tarafından başlatılan yapılandırma yazma işlemlerine izin verir veya bunları reddeder.
• İ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.
• Mesajlar veritabanına Tam Disk Erişimi gerektirir.
• chat_id:<id> hedeflerini tercih edin. Sohbetleri listelemek için imsg chats --limit 20 kullanın.
• cliPath bir SSH sarmalayıcısını gösterebilir; SCP ile ekleri almak 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, katı ana makine anahtarı denetimi kullanır; bu nedenle aktarma ana makinesinin 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 yazımlarına izin verin veya bunları reddedin.
• channels.imessage.sendTransport: normal giden yanıtlar için tercih edilen imsg RPC gönderim aktarımı. auto (varsayılan), çalışır durumdaysa mevcut sohbetler için IMCore köprüsünü kullanır, ardından AppleScript’e geri döner; bridge özel API ile teslimat gerektirir; applescript genel Mesajlar otomasyon yolunu zorunlu kılar.
• channels.imessage.actions.*: ayrıca imsg status / openclaw channels status --probe tarafından denetlenen özel API eylemlerini etkinleştirin.
• channels.imessage.includeAttachments varsayılan olarak kapalıdır; agent turlarında gelen medya beklemeden önce bunu true olarak ayarlayın.
• Bir köprü/gateway yeniden başlatmasından sonra gelen iletilerin kurtarılması otomatiktir (GUID tekilleştirmesi ve eski birikim için yaş sınırı). Mevcut channels.imessage.catchup.enabled: true yapılandırmaları, kullanımdan kaldırılmış bir uyumluluk profili olarak hâlâ dikkate alınır; catchup varsayılan olarak devre dışıdır.
• channels.imessage.groups: grup kayıt defteri ve grup başına ayarlar. groupPolicy: "allowlist" ile grup iletilerinin kayıt defteri geçidinden geçebilmesi için açık chat_id anahtarlarını veya bir "*" joker karakter girdisini 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 Agent’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ça belirtilen bir HTTP(S) proxy’si üzerinden yönlendirir. Adlandırılmış hesaplar bunu channels.matrix.accounts.<id>.proxy ile geçersiz kılabilir.
• channels.matrix.network.dangerouslyAllowPrivateNetwork, özel/dahili ana sunuculara izin verir. proxy ile bu ağ kabulü 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 autoJoin: "allowlist" öğesini autoJoinAllowlist veya autoJoin: "always" ile ayarlayana kadar davet edilen odalar ve yeni DM tarzı davetler yok sayılır.
• channels.matrix.execApprovals: Matrix’e özgü yürütme onayı teslimatı ve onaylayan yetkilendirmesi.
  • enabled: true, false veya "auto" (varsayılan). Otomatik modda, onaylayanlar approvers veya commands.ownerAllowFrom üzerinden çözümlenebildiğinde yürütme onayları etkinleşir.
  • approvers: yürütme isteklerini onaylamasına izin verilen Matrix kullanıcı kimlikleri (ör. @owner:example.org).
  • agentFilter: isteğe bağlı agent kimliği izin listesi. Tüm agent’ların onaylarını iletmek için bunu atlayın.
  • sessionFilter: isteğe bağlı oturum anahtarı kalıpları (alt dize veya düzenli ifade).
  • 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 gruplandırılacağını denetler: per-user (varsayılan), yönlendirilmiş eşe göre paylaşırken per-room her DM odasını yalıtır.
• Matrix durum yoklamaları ve canlı dizin aramaları, çalışma zamanı trafiğiyle aynı proxy politikasını 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:
      // bkz. /channels/msteams
    },
  },
}

• Burada ele alınan temel anahtar yolları: channels.msteams, channels.msteams.configWrites.
• Tam Teams yapılandırması (kimlik bilgileri, webhook, DM/grup politikası, takım ve 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 ele alınan 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ı (ana makine/bağlantı noktası/TLS/kanallar/izin listeleri/bahsetme geçidi) IRC bölümünde 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 hesap için geçerlidir.
• Temel kanal ayarları, hesap başına geçersiz kılınmadığı sürece tüm hesaplara uygulanır.
• Her hesabı farklı bir agent’a yönlendirmek için bindings[].match.accountId kullanın.
• Tek hesaplı üst düzey kanal yapılandırmasını kullanmaya devam ederken openclaw channels add (veya kanal ilk katılımı) aracılığıyla varsayılan olmayan bir hesap eklerseniz, OpenClaw önce hesap kapsamlı üst düzey tek hesap değerlerini kanal hesap eşlemesine yükseltir; böylece özgün hesap çalışmayı sürdürür. Çoğu kanal bunları channels.<channel>.accounts.default içine taşır; Matrix ise mevcut ve eşleşen adlandırılmış/varsayılan hedefi koruyabilir.
• Mevcut yalnızca kanal kapsamlı bağlamalar (accountId yok) varsayılan hesapla eşleşmeyi sürdürür; hesap kapsamlı bağlamalar isteğe bağlı kalır.
• openclaw doctor --fix, hesap kapsamlı üst düzey tek hesap değerlerini ilgili kanal için seçilen yükseltilmiş hesaba taşıyarak karma şekilleri de onarır. Çoğu kanal accounts.default kullanır; Matrix ise mevcut ve eşleşen adlandırılmış/varsayılan hedefi koruyabilir.

​

Diğer Plugin kanalları

​

Grup sohbeti bahsetme geçidi

• Meta veri bahsetmeleri: Yerel platform @-bahsetmeleri. WhatsApp kendi kendine sohbet modunda yok sayılır.
• Metin kalıpları: agents.entries.*.groupChat.mentionPatterns içindeki güvenli regex kalıpları. Geçersiz kalıplar ve güvenli olmayan iç içe tekrarlar yok sayılır.
• Bahsetme kısıtlaması yalnızca algılama mümkün olduğunda (yerel bahsetmeler veya en az bir kalıp) uygulanır.

{
  messages: {
    visibleReplies: "automatic", // doğrudan/kaynak sohbetleri için eski otomatik nihai yanıtları zorunlu kıl
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // her zaman açık, bahsetme içermeyen oda sohbeti sessiz bağlama dönüşür
      visibleReplies: "message_tool", // isteğe bağlı; görünür oda yanıtları için message(action=send) gerektir
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

DM geçmişi sınırları

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

​

Kendi kendine sohbet modu

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

​

Komutlar (sohbet komutlarını işleme)

{
  commands: {
    native: "auto", // desteklendiğinde yerel komutları kaydet
    nativeSkills: "auto", // desteklendiğinde yerel Skills komutlarını kaydet
    text: true, // sohbet mesajlarındaki /commands ifadelerini ayrıştır
    bash: false, // ! kullanımına izin ver (diğer ad: /bash)
    bashForegroundMs: 2000,
    config: false, // /config kullanımına izin ver
    mcp: false, // /mcp kullanımına izin ver
    plugins: false, // /plugins kullanımına izin ver
    debug: false, // /debug kullanımına izin ver
    restart: true, // /restart + harici SIGUSR1 yeniden başlatma isteklerine izin ver
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

İlgili

• Yapılandırma referansı — üst düzey anahtarlar
• Yapılandırma — ajanlar
• Kanallara genel bakış