Slack

Üretime hazır; Slack uygulama entegrasyonları üzerinden DM’ler ve kanallar için kullanılabilir. Varsayılan mod Socket Mode’dur; HTTP Request URL’leri de desteklenir.

# Socket Mode veya HTTP Request URL’lerini seçme

Her iki aktarım da üretime hazırdır ve mesajlaşma, eğik çizgi komutları, App Home ve etkileşimlilik için özellik denkliğine ulaşır. Özelliklere göre değil, dağıtım şekline göre seçim yapın.

# Hızlı kurulum

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"emoji:read",
"files:read",
"files:write",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"mpim:history",
"mpim:read",
"mpim:write",
"pins:read",
"pins:write",
"reactions:read",
"reactions:write",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > slack.socket.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "socket",
appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"emoji:read",
"files:read",
"files:write",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"mpim:history",
"mpim:read",
"mpim:write",
"pins:read",
"pins:write",
"reactions:read",
"reactions:write",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "http",
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
webhookPath: "/slack/events",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Socket Mode aktarım ayarı

OpenClaw, Socket Mode için Slack SDK istemci pong zaman aşımını varsayılan olarak 15 saniyeye ayarlar. Aktarım ayarlarını yalnızca çalışma alanına veya ana makineye özgü ayar gerektiğinde geçersiz kılın:

{
  channels: {
    slack: {
      mode: "socket",
      socketMode: {
        clientPingTimeout: 20000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
    },
  },
}

Bunu yalnızca Slack websocket pong/sunucu ping zaman aşımlarını günlüğe yazan veya bilinen event-loop açlığı olan ana makinelerde çalışan Socket Mode çalışma alanları için kullanın. clientPingTimeout, SDK bir istemci ping’i gönderdikten sonraki pong bekleme süresidir; serverPingTimeout, Slack sunucu ping’leri için bekleme süresidir. Uygulama mesajları ve olayları aktarım canlılığı sinyalleri değil, uygulama durumu olarak kalır.

# Manifest ve kapsam kontrol listesi

Temel Slack uygulama manifesti Socket Mode ve HTTP Request URLs için aynıdır. Yalnızca settings bloğu (ve slash komutu url) farklıdır.

Temel manifest (Socket Mode varsayılanı):

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

HTTP Request URLs modu için settings bölümünü HTTP varyantıyla değiştirin ve her slash komutuna url ekleyin. Herkese açık URL gereklidir:

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

# Ek manifest ayarları

Yukarıdaki varsayılanları genişleten farklı özellikleri kullanıma sunun.

Varsayılan manifest, Slack App Home Home sekmesini etkinleştirir ve app_home_opened olayına abone olur. Bir çalışma alanı üyesi Home sekmesini açtığında OpenClaw, views.publish ile güvenli bir varsayılan Home görünümü yayımlar; konuşma yükü veya özel yapılandırma dahil edilmez. Messages sekmesi Slack DM’leri için etkin kalır.

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]"
},
{
"command": "/reset",
"description": "Reset the current session"
},
{
"command": "/compact",
"description": "Compact the session context",
"usage_hint": "[instructions]"
},
{
"command": "/stop",
"description": "Stop the current run"
},
{
"command": "/session",
"description": "Manage thread-binding expiry",
"usage_hint": "idle <duration|off> or max-age <duration|off>"
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": "<level>"
},
{
"command": "/verbose",
"description": "Toggle verbose output",
"usage_hint": "on|off|full"
},
{
"command": "/fast",
"description": "Show or set fast mode",
"usage_hint": "[status|on|off]"
},
{
"command": "/reasoning",
"description": "Toggle reasoning visibility",
"usage_hint": "[on|off|stream]"
},
{
"command": "/elevated",
"description": "Toggle elevated mode",
"usage_hint": "[on|off|ask|full]"
},
{
"command": "/exec",
"description": "Show or set exec defaults",
"usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
},
{
"command": "/help",
"description": "Show the short help summary"
},
{
"command": "/commands",
"description": "Show the generated command catalog"
},
{
"command": "/tools",
"description": "Show what the current agent can use right now",
"usage_hint": "[compact|verbose]"
},
{
"command": "/agentstatus",
"description": "Show runtime status, including provider usage/quota when available"
},
{
"command": "/tasks",
"description": "List active/recent background tasks for the current session"
},
{
"command": "/context",
"description": "Explain how context is assembled",
"usage_hint": "[list|detail|json]"
},
{
"command": "/whoami",
"description": "Show your sender identity"
},
{
"command": "/skill",
"description": "Run a skill by name",
"usage_hint": "<name> [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]",
"url": "https://gateway-host.example.com/slack/events"
},
{
"command": "/help",
"description": "Show the short help summary",
"url": "https://gateway-host.example.com/slack/events"
}
]
}

# Token modeli

• Socket Mode için botToken + appToken gereklidir.
• HTTP modu botToken + signingSecret gerektirir.
• botToken, appToken, signingSecret ve userToken düz metin dizeleri ya da SecretRef nesnelerini kabul eder.
• Yapılandırma tokenları env yedeğini geçersiz kılar.
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env yedeği yalnızca varsayılan hesap için geçerlidir.
• userToken (xoxp-...) yalnızca yapılandırmayla verilir (env yedeği yoktur) ve varsayılan olarak salt okunur davranışı kullanır (userTokenReadOnly: true).

Durum anlık görüntüsü davranışı:

• Slack hesap incelemesi, kimlik bilgisi başına *Source ve *Status alanlarını (botToken, appToken, signingSecret, userToken) izler.
• Durum available, configured_unavailable veya missing olur.
• configured_unavailable, hesabın SecretRef veya başka bir satır içi olmayan gizli kaynak üzerinden yapılandırıldığı, ancak geçerli komut/çalışma zamanı yolunun gerçek değeri çözemediği anlamına gelir.
• HTTP modunda signingSecretStatus dahil edilir; Socket Mode içinde gerekli çift botTokenStatus + appTokenStatus değerleridir.

# Eylemler ve geçitler

Slack eylemleri channels.slack.actions.* ile denetlenir.

Geçerli Slack araçlarında kullanılabilir eylem grupları:

Geçerli Slack ileti eylemleri send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info ve emoji-list içerir. download-file, gelen dosya yer tutucularında gösterilen Slack dosya kimliklerini kabul eder ve görüntüler için görüntü önizlemeleri ya da diğer dosya türleri için yerel dosya meta verileri döndürür.

# Erişim denetimi ve yönlendirme

# İş parçacıkları, oturumlar ve yanıt etiketleri

• DM’ler direct olarak; kanallar channel olarak; MPIM’ler group olarak yönlendirilir.
• Slack rota bağlamaları ham eş kimliklerini ve channel:C12345678, user:U12345678 ve <@U12345678> gibi Slack hedef biçimlerini kabul eder.
• Varsayılan session.dmScope=main ile Slack DM’leri ajan ana oturumunda birleşir.
• Kanal oturumları: agent:<agentId>:slack:channel:<channelId>.
• İş parçacığı yanıtları, uygulanabilir olduğunda iş parçacığı oturum sonekleri (:thread:<threadTs>) oluşturabilir.
• channels.slack.thread.historyScope varsayılanı thread; thread.inheritParent varsayılanı false olur.
• channels.slack.thread.initialHistoryLimit, yeni bir iş parçacığı oturumu başladığında kaç mevcut iş parçacığı iletisinin getirileceğini denetler (varsayılan 20; devre dışı bırakmak için 0 ayarlayın).
• channels.slack.thread.requireExplicitMention (varsayılan false): true olduğunda örtük iş parçacığı bahsetmelerini bastırır, böylece bot iş parçacığında zaten yer almış olsa bile yalnızca iş parçacıkları içindeki açık @bot bahsetmelerine yanıt verir. Bu olmadan, botun yer aldığı bir iş parçacığındaki yanıtlar requireMention geçidini atlar.

Yanıt iş parçacığı denetimleri:

• channels.slack.replyToMode: off|first|all|batched (varsayılan off)
• channels.slack.replyToModeByChatType: direct|group|channel başına
• doğrudan sohbetler için eski yedek: channels.slack.dm.replyToMode

El ile yanıt etiketleri desteklenir:

• [[reply_to_current]]
• [[reply_to:<id>]]

# Onay tepkileri

ackReaction, OpenClaw gelen bir iletiyi işlerken bir onay emojisi gönderir.

Çözümleme sırası:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• ajan kimliği emoji yedeği (agents.list[].identity.emoji, yoksa "👀")

Notlar:

• Slack kısa kodlar bekler (örneğin "eyes").
• Slack hesabı veya genel olarak tepkiyi devre dışı bırakmak için "" kullanın.

# Metin akışı

channels.slack.streaming canlı önizleme davranışını denetler:

• off: canlı önizleme akışını devre dışı bırakır.
• partial (varsayılan): önizleme metnini en son kısmi çıktı ile değiştirir.
• block: parçalı önizleme güncellemeleri ekler.
• progress: üretim sırasında ilerleme durumu metnini gösterir, ardından son metni gönderir.
• streaming.preview.toolProgress: taslak önizleme etkin olduğunda araç/ilerleme güncellemelerini aynı düzenlenen önizleme iletisine yönlendirir (varsayılan: true). Ayrı araç/ilerleme iletileri tutmak için false olarak ayarlayın.
• streaming.preview.commandText / streaming.progress.commandText: ham komut/exec metnini gizlerken kompakt araç-ilerleme satırlarını korumak için status olarak ayarlayın (varsayılan: raw).

Ham komut/exec metnini gizlerken kompakt ilerleme satırlarını koruyun:

{
  "channels": {
    "slack": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

channels.slack.streaming.nativeTransport, channels.slack.streaming.mode partial olduğunda Slack yerel metin akışını denetler (varsayılan: true).

• Yerel metin akışının ve Slack asistan iş parçacığı durumunun görünmesi için bir yanıt iş parçacığı kullanılabilir olmalıdır. İş parçacığı seçimi yine de replyToMode izler.
• Kanal, grup sohbeti ve üst düzey DM kökleri, yerel akış kullanılamadığında veya yanıt iş parçacığı olmadığında normal taslak önizlemeyi hâlâ kullanabilir.
• Üst düzey Slack DM’leri varsayılan olarak iş parçacığı dışında kalır, bu yüzden Slack’in iş parçacığı tarzı yerel akış/durum önizlemesini göstermez; OpenClaw bunun yerine DM içinde bir taslak önizleme gönderir ve düzenler.
• Medya ve metin dışı yükler normal teslimata geri döner.
• Medya/hata sonları bekleyen önizleme düzenlemelerini iptal eder; uygun metin/blok sonları yalnızca önizlemeyi yerinde düzenleyebildiğinde boşaltılır.
• Akış yanıtın ortasında başarısız olursa OpenClaw, kalan yükler için normal teslimata geri döner.

Slack yerel metin akışı yerine taslak önizlemeyi kullanın:

{
  channels: {
    slack: {
      streaming: {
        mode: "partial",
        nativeTransport: false,
      },
    },
  },
}

Eski anahtarlar:

• channels.slack.streamMode (replace | status_final | append), channels.slack.streaming.mode için eski bir çalışma zamanı takma adıdır.
• boolean channels.slack.streaming, channels.slack.streaming.mode ve channels.slack.streaming.nativeTransport için eski bir çalışma zamanı takma adıdır.
• eski channels.slack.nativeStreaming, channels.slack.streaming.nativeTransport için bir çalışma zamanı takma adıdır.
• Kalıcı Slack akış yapılandırmasını kanonik anahtarlara yeniden yazmak için openclaw doctor --fix çalıştırın.

# Yazıyor tepkisi yedek davranışı

typingReaction, OpenClaw bir yanıtı işlerken gelen Slack mesajına geçici bir tepki ekler, ardından çalışma tamamlandığında bunu kaldırır. Bu, varsayılan bir "yazıyor..." durum göstergesi kullanan konu yanıtları dışında en kullanışlıdır.

Çözümleme sırası:

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

Notlar:

• Slack kısa kodlar bekler (örneğin "hourglass_flowing_sand").
• Tepki en iyi çabayla uygulanır ve yanıt ya da hata yolu tamamlandıktan sonra temizlik otomatik olarak denenir.

# Medya, parçalama ve teslim

# Komutlar ve slash davranışı

Slash komutları Slack içinde tek bir yapılandırılmış komut veya birden çok yerel komut olarak görünür. Komut varsayılanlarını değiştirmek için channels.slack.slashCommand yapılandırın:

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

/openclaw /help

Yerel komutlar Slack uygulamanızda ek manifest ayarları gerektirir ve bunun yerine genel yapılandırmalarda channels.slack.commands.native: true veya commands.native: true ile etkinleştirilir.

• Yerel komut otomatik modu Slack için kapalıdır, bu nedenle commands.native: "auto" Slack yerel komutlarını etkinleştirmez.

/help

Yerel argüman menüleri, seçilen bir seçenek değerini göndermeden önce bir onay modalı gösteren uyarlanabilir bir işleme stratejisi kullanır:

• en fazla 5 seçenek: düğme blokları
• 6-100 seçenek: statik seçim menüsü
• 100'den fazla seçenek: etkileşim seçenek işleyicileri kullanılabilir olduğunda asenkron seçenek filtrelemeli harici seçim
• Slack sınırları aşıldı: kodlanmış seçenek değerleri düğmelere geri döner

/think

Slash oturumları agent:<agentId>:slack:slash:<userId> gibi yalıtılmış anahtarlar kullanır ve komut yürütmelerini CommandTargetSessionKey kullanarak hedef konuşma oturumuna yönlendirmeye devam eder.

# Etkileşimli yanıtlar

Slack, aracı tarafından yazılmış etkileşimli yanıt denetimlerini işleyebilir, ancak bu özellik varsayılan olarak devre dışıdır.

Genel olarak etkinleştirin:

{
  channels: {
    slack: {
      capabilities: {
        interactiveReplies: true,
      },
    },
  },
}

Veya yalnızca bir Slack hesabı için etkinleştirin:

{
  channels: {
    slack: {
      accounts: {
        ops: {
          capabilities: {
            interactiveReplies: true,
          },
        },
      },
    },
  },
}

Etkinleştirildiğinde, aracılar yalnızca Slack'e özgü yanıt yönergeleri yayabilir:

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

Bu yönergeler Slack Block Kit'e derlenir ve tıklamaları veya seçimleri mevcut Slack etkileşim olayı yolu üzerinden geri yönlendirir.

Notlar:

• Bu Slack'e özgü bir kullanıcı arayüzüdür. Diğer kanallar Slack Block Kit yönergelerini kendi düğme sistemlerine çevirmez.
• Etkileşimli callback değerleri, aracı tarafından yazılmış ham değerler değil, OpenClaw tarafından oluşturulan opak token'lardır.
• Oluşturulan etkileşimli bloklar Slack Block Kit sınırlarını aşacaksa OpenClaw geçersiz bir blok payload'ı göndermek yerine özgün metin yanıtına geri döner.

# Slack içinde Exec onayları

Slack, Web kullanıcı arayüzüne veya terminale geri dönmek yerine etkileşimli düğmeler ve etkileşimlerle yerel bir onay istemcisi gibi davranabilir.

• Exec onayları, yerel DM/kanal yönlendirmesi için channels.slack.execApprovals.* kullanır.
• Plugin onayları, istek zaten Slack'e düştüğünde ve onay id türü plugin: olduğunda aynı Slack yerel düğme yüzeyi üzerinden hâlâ çözümlenebilir.
• Onaylayan yetkilendirmesi yine uygulanır: yalnızca onaylayan olarak tanımlanan kullanıcılar Slack üzerinden istekleri onaylayabilir veya reddedebilir.

Bu, diğer kanallarla aynı paylaşılan onay düğmesi yüzeyini kullanır. Slack uygulama ayarlarınızda interactivity etkinleştirildiğinde, onay istemleri doğrudan konuşmada Block Kit düğmeleri olarak işlenir. Bu düğmeler bulunduğunda birincil onay kullanıcı deneyimi onlardır; OpenClaw yalnızca araç sonucu sohbet onaylarının kullanılamadığını veya tek yolun manuel onay olduğunu söylediğinde manuel bir /approve komutu eklemelidir.

Yapılandırma yolu:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (isteğe bağlı; mümkün olduğunda commands.ownerAllowFrom değerine geri döner)
• channels.slack.execApprovals.target (dm | channel | both, varsayılan: dm)
• agentFilter, sessionFilter

Slack, enabled ayarlanmamış veya "auto" olduğunda ve en az bir onaylayan çözümlendiğinde yerel Exec onaylarını otomatik olarak etkinleştirir. Slack'i yerel onay istemcisi olarak açıkça devre dışı bırakmak için enabled: false ayarlayın. Onaylayanlar çözümlendiğinde yerel onayları zorla açmak için enabled: true ayarlayın.

Açık Slack Exec onay yapılandırması olmadan varsayılan davranış:

{
  commands: {
    ownerAllowFrom: ["slack:U12345678"],
  },
}

Açık Slack yerel yapılandırması yalnızca onaylayanları geçersiz kılmak, filtre eklemek veya kaynak sohbet teslimine katılmak istediğinizde gerekir:

{
  channels: {
    slack: {
      execApprovals: {
        enabled: true,
        approvers: ["U12345678"],
        target: "both",
      },
    },
  },
}

Paylaşılan approvals.exec iletimi ayrıdır. Bunu yalnızca Exec onay istemlerinin başka sohbetlere veya açık bant dışı hedeflere de yönlendirilmesi gerektiğinde kullanın. Paylaşılan approvals.plugin iletimi de ayrıdır; Slack yerel düğmeleri, bu istekler zaten Slack'e düştüğünde Plugin onaylarını hâlâ çözümler.

Aynı sohbet /approve, komutları zaten destekleyen Slack kanallarında ve DM'lerinde de çalışır. Tam onay iletimi modeli için Exec onayları bölümüne bakın.

# Olaylar ve operasyonel davranış

• Mesaj düzenlemeleri/silmeleri sistem olaylarına eşlenir.
• Konu yayınları ("Kanala da gönder" konu yanıtları) normal kullanıcı mesajları olarak işlenir.
• Tepki ekleme/kaldırma olayları sistem olaylarına eşlenir.
• Üye katılma/ayrılma, kanal oluşturulma/yeniden adlandırılma ve pin ekleme/kaldırma olayları sistem olaylarına eşlenir.
• channel_id_changed, configWrites etkinleştirildiğinde kanal yapılandırma anahtarlarını taşıyabilir.
• Kanal konu/amaç meta verileri güvenilmeyen bağlam olarak ele alınır ve yönlendirme bağlamına enjekte edilebilir.
• Konu başlatıcısı ve ilk konu geçmişi bağlam tohumlaması, uygulanabilir olduğunda yapılandırılmış gönderici izin listeleriyle filtrelenir.
• Blok eylemleri ve modal etkileşimleri, zengin payload alanlarıyla yapılandırılmış Slack interaction: ... sistem olayları yayar:
  • blok eylemleri: seçilen değerler, etiketler, seçici değerleri ve workflow_* meta verileri
  • yönlendirilmiş kanal meta verileri ve form girdileriyle modal view_submission ve view_closed olayları

# Yapılandırma referansı

Birincil referans: Yapılandırma referansı - Slack.

# Sorun giderme

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

# Ek görsel referansı

Slack, Slack dosya indirmeleri başarılı olduğunda ve boyut sınırları izin verdiğinde indirilen medyayı ajan turuna ekleyebilir. Görüntü dosyaları medya anlama yolundan geçirilebilir veya doğrudan görsel yetenekli bir yanıt modeline aktarılabilir; diğer dosyalar, görüntü girdisi olarak ele alınmak yerine indirilebilir dosya bağlamı olarak tutulur.

# Desteklenen medya türleri

# Gelen işlem hattı

Dosya ekleri olan bir Slack mesajı geldiğinde:

1. OpenClaw, bot belirtecini (xoxb-...) kullanarak dosyayı Slack'in özel URL'sinden indirir.
2. Başarı durumunda dosya medya deposuna yazılır.
3. İndirilen medya yolları ve içerik türleri gelen bağlama eklenir.
4. Görüntü yetenekli model/araç yolları bu bağlamdaki görüntü eklerini kullanabilir.
5. Görüntü olmayan dosyalar, bunları işleyebilen araçlar için dosya meta verisi veya medya referansları olarak kullanılabilir kalır.

# Konu kökü eki devralma

Bir mesaj bir konu içinde geldiğinde (thread_ts üst öğesi olduğunda):

• Yanıtın kendisinde doğrudan medya yoksa ve dahil edilen kök mesajda dosyalar varsa, Slack kök dosyaları konu başlatıcı bağlamı olarak yükleyebilir.
• Doğrudan yanıt ekleri, kök mesaj eklerine göre önceliklidir.
• Yalnızca dosyaları olan ve metni olmayan bir kök mesaj, geri dönüşün dosyalarını yine de içerebilmesi için bir ek yer tutucusuyla temsil edilir.

# Çoklu ek işleme

Tek bir Slack mesajı birden çok dosya eki içerdiğinde:

• Her ek, medya işlem hattından bağımsız olarak geçirilir.
• İndirilen medya referansları mesaj bağlamında toplanır.
• İşleme sırası, olay yükündeki Slack dosya sırasını izler.
• Bir ekin indirilmesindeki hata diğerlerini engellemez.

# Boyut, indirme ve model sınırları

• Boyut sınırı: Dosya başına varsayılan 20 MB. channels.slack.mediaMaxMb üzerinden yapılandırılabilir.
• İndirme hataları: Slack'in sunamadığı dosyalar, süresi dolmuş URL'ler, erişilemeyen dosyalar, aşırı büyük dosyalar ve Slack kimlik doğrulama/oturum açma HTML yanıtları, desteklenmeyen biçimler olarak bildirilmek yerine atlanır.
• Görsel modeli: Görüntü analizi, görseli desteklediğinde etkin yanıt modelini veya agents.defaults.imageModel konumunda yapılandırılan görüntü modelini kullanır.

# Bilinen sınırlar

# İlgili belgeler

• Medya anlama işlem hattı
• PDF aracı
• Epik: #51349 — Slack eklerinde görsel etkinleştirme
• Regresyon testleri: #51353
• Canlı doğrulama: #51354

# İlgili