---
read_when:
- Slack'i kurma veya Slack soket/HTTP modunda hata ayıklama
summary: Slack kurulumu ve çalışma zamanı davranışı (Soket Modu + HTTP İstek URL'leri)
title: Slack
x-i18n:
generated_at: "2026-05-11T20:21:43Z"
model: gpt-5.5
provider: openai
source_hash: 34e740fd5cb0ca936edce1843316cde17570d77778bdf4fc761cad77c51ee9cf
source_path: channels/slack.md
workflow: 16
---
Üretime hazır Slack uygulama entegrasyonları üzerinden DM'ler ve kanallar için uygundur. Varsayılan mod Socket Mode'dur; HTTP Request URL'leri de desteklenir.
Slack DM'leri varsayılan olarak eşleştirme modunu kullanır.
Yerel komut davranışı ve komut kataloğu.
Kanallar arası tanılama ve onarım playbook'ları.
## Socket Mode veya HTTP Request URL'leri seçme
Her iki aktarım da üretime hazırdır ve mesajlaşma, slash komutları, App Home ve etkileşim için özellik eşitliğine ulaşır. Özelliklere göre değil, dağıtım yapısına göre seçin.
| Konu | Socket Mode (varsayılan) | HTTP Request URL'leri |
| ---------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| Herkese açık Gateway URL'si | Gerekli değil | Gerekli (DNS, TLS, ters proxy veya tünel) |
| Giden ağ | `wss-primary.slack.com` adresine giden WSS erişilebilir olmalıdır | Giden WS yok; yalnızca gelen HTTPS |
| Gerekli token'lar | Bot token'ı (`xoxb-...`) + `connections:write` içeren App-Level Token (`xapp-...`) | Bot token'ı (`xoxb-...`) + Signing Secret |
| Geliştirme dizüstüsü / güvenlik duvarı arkasında | Olduğu gibi çalışır | Herkese açık bir tünel (ngrok, Cloudflare Tunnel, Tailscale Funnel) veya hazırlama Gateway'i gerekir |
| Yatay ölçekleme | Uygulama ve host başına bir Socket Mode oturumu; birden çok Gateway ayrı Slack uygulamaları gerektirir | Durumsuz POST işleyicisi; birden çok Gateway replikası, yük dengeleyici arkasında tek uygulamayı paylaşabilir |
| Tek Gateway'de çoklu hesap | Desteklenir; her hesap kendi WS'sini açar | Desteklenir; kayıtların çakışmaması için her hesabın benzersiz bir `webhookPath` değerine (varsayılan `/slack/events`) ihtiyacı vardır |
| Slash komutu aktarımı | WS bağlantısı üzerinden teslim edilir; `slash_commands[].url` yok sayılır | Slack, `slash_commands[].url` adresine POST gönderir; komutun çalışması için alan gereklidir |
| İstek imzalama | Kullanılmaz (kimlik doğrulama App-Level Token'dır) | Slack her isteği imzalar; OpenClaw `signingSecret` ile doğrular |
| Bağlantı kopmasında kurtarma | Slack SDK otomatik yeniden bağlanır; gateway'in pong zaman aşımı aktarım ayarı uygulanır | Kopacak kalıcı bağlantı yoktur; yeniden denemeler Slack tarafından istek başına yapılır |
Tek Gateway host'ları, geliştirme dizüstüleri ve `*.slack.com` adresine giden bağlantı kurabilen ancak gelen HTTPS kabul edemeyen şirket içi ağlar için **Socket Mode'u seçin**.
Yük dengeleyici arkasında birden çok Gateway replikası çalıştırırken, giden WSS engellenmiş ancak gelen HTTPS izinliyken veya Slack webhook'larını zaten bir ters proxy'de sonlandırıyorsanız **HTTP Request URL'lerini seçin**.
## Hızlı kurulum
[api.slack.com/apps](https://api.slack.com/apps/new) sayfasını açın → **Create New App** → **From a manifest** → çalışma alanınızı seçin → aşağıdaki manifestlerden birini yapıştırın → **Next** → **Create**.
```json Recommended
{
"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"
]
}
}
}
```
```json Minimal
{
"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"
]
}
}
}
```
**Önerilen**, paketle gelen Slack plugin'inin tam özellik kümesiyle eşleşir: App Home, slash komutları, dosyalar, tepkiler, sabitlemeler, grup DM'leri ve emoji/kullanıcı grubu okumaları. Çalışma alanı politikası kapsamları kısıtlıyorsa **Minimal** seçin — DM'leri, kanal/grup geçmişini, bahsetmeleri ve slash komutlarını kapsar ancak dosyaları, tepkileri, sabitlemeleri, grup DM (`mpim:*`), `emoji:read` ve `usergroups:read` kapsamlarını çıkarır. Kapsam başına gerekçe ve ek slash komutları gibi eklemeli seçenekler için [Manifest ve kapsam kontrol listesi](#manifest-and-scope-checklist) bölümüne bakın.
Slack uygulamayı oluşturduktan sonra:
- **Basic Information → App-Level Tokens → Generate Token and Scopes**: `connections:write` ekleyin, kaydedin, `xapp-...` değerini kopyalayın.
- **Install App → Install to Workspace**: `xoxb-...` Bot User OAuth Token'ını kopyalayın.
Önerilen SecretRef kurulumu:
```bash
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
```
Ortam yedeği (yalnızca varsayılan hesap):
```bash
SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...
```
```bash
openclaw gateway
```
[api.slack.com/apps](https://api.slack.com/apps/new) sayfasını açın → **Create New App** → **From a manifest** → çalışma alanınızı seçin → aşağıdaki manifestlerden birini yapıştırın → `https://gateway-host.example.com/slack/events` değerini herkese açık Gateway URL'nizle değiştirin → **Next** → **Create**.
```json Recommended
{
"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"
}
}
}
```
```json Asgari
{
"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"
}
}
}
```
**Önerilen**, birlikte gelen Slack Plugin'inin tam özellik setiyle eşleşir; **Asgari**, kısıtlayıcı çalışma alanları için dosyaları, tepkileri, pinleri, grup DM'lerini (`mpim:*`), `emoji:read` ve `usergroups:read` kapsamlarını çıkarır. Kapsam başına gerekçe için bkz. [Manifest ve kapsam kontrol listesi](#manifest-and-scope-checklist).
Üç URL alanının (`slash_commands[].url`, `event_subscriptions.request_url` ve `interactivity.request_url` / `message_menu_options_url`) tümü aynı OpenClaw uç noktasını gösterir. Slack'in manifest şeması bunların ayrı ayrı adlandırılmasını gerektirir, ancak OpenClaw yük türüne göre yönlendirme yaptığı için tek bir `webhookPath` (varsayılan `/slack/events`) yeterlidir. `slash_commands[].url` olmadan slash komutları HTTP modunda sessizce hiçbir işlem yapmaz.
Slack uygulamayı oluşturduktan sonra:
- **Temel Bilgiler → Uygulama Kimlik Bilgileri**: istek doğrulaması için **Signing Secret** değerini kopyalayın.
- **Uygulamayı Yükle → Çalışma Alanına Yükle**: `xoxb-...` Bot User OAuth Token değerini kopyalayın.
Önerilen SecretRef kurulumu:
```bash
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
```
Çok hesaplı HTTP için benzersiz Webhook yolları kullanın
Kayıtların çakışmaması için her hesaba ayrı bir `webhookPath` (varsayılan `/slack/events`) verin.
```bash
openclaw gateway
```
## Socket Mode aktarım ayarı
OpenClaw, Slack SDK istemcisi pong zaman aşımını Socket Mode için 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:
```json5
{
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 kaydeden veya bilinen olay döngüsü yoksunluğu 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ık 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 komutunun `url` değeri) farklıdır.
Temel manifest (Socket Mode varsayılanı):
```json
{
"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` değerini HTTP varyantıyla değiştirin ve her slash komutuna `url` ekleyin. Genel URL gereklidir:
```json
{
"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.
Birden çok [yerel slash komutu](#commands-and-slash-behavior), nüanslı şekilde yapılandırılmış tek bir komut yerine kullanılabilir:
- `/status` komutu ayrılmış olduğundan `/status` yerine `/agentstatus` kullanın.
- Aynı anda en fazla 25 slash komutu kullanılabilir hale getirilebilir.
Mevcut `features.slash_commands` bölümünüzü [kullanılabilir komutlar](/tr/tools/slash-commands#command-list) alt kümesiyle değiştirin:
```json
{
"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 or max-age "
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": ""
},
{
"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= security= ask= node="
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=|size=|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": " [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": ""
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": ""
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}
```
Yukarıdaki Socket Mode ile aynı `slash_commands` listesini kullanın ve her girdiye `"url": "https://gateway-host.example.com/slack/events"` ekleyin. Örnek:
```json
{
"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"
}
]
}
```
Listedeki her komutta bu `url` değerini tekrarlayın.
Giden mesajların varsayılan Slack uygulaması kimliği yerine etkin ajan kimliğini (özel kullanıcı adı ve simge) kullanmasını istiyorsanız `chat:write.customize` bot kapsamını ekleyin.
Bir emoji simgesi kullanırsanız Slack `:emoji_name:` söz dizimini bekler.
`channels.slack.userToken` yapılandırırsanız tipik okuma kapsamları şunlardır:
- `channels:history`, `groups:history`, `im:history`, `mpim:history`
- `channels:read`, `groups:read`, `im:read`, `mpim:read`
- `users:read`
- `reactions:read`
- `pins:read`
- `emoji:read`
- `search:read` (Slack arama okumalarına bağımlıysanız)
## Token modeli
- Socket Mode için `botToken` + `appToken` gereklidir.
- HTTP modu `botToken` + `signingSecret` gerektirir.
- `botToken`, `appToken`, `signingSecret` ve `userToken` düz metin
dizelerini veya SecretRef nesnelerini kabul eder.
- Yapılandırma token'ları ortam değişkeni yedeğini geçersiz kılar.
- `SLACK_BOT_TOKEN` / `SLACK_APP_TOKEN` ortam değişkeni yedeği yalnızca varsayılan hesap için geçerlidir.
- `userToken` (`xoxp-...`) yalnızca yapılandırma üzerinden verilir (ortam değişkeni yedeği yoktur) ve varsayılan olarak salt okunur davranışa ayarlanır (`userTokenReadOnly: true`).
Durum anlık görüntüsü davranışı:
- Slack hesap incelemesi kimlik bilgisi başına `*Source` ve `*Status`
alanlarını izler (`botToken`, `appToken`, `signingSecret`, `userToken`).
- 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'da
gerekli çift `botTokenStatus` + `appTokenStatus` olur.
Eylemler/dizin okumaları için, yapılandırıldığında kullanıcı token'ı tercih edilebilir. Yazmalar için bot token'ı tercih edilmeye devam eder; kullanıcı token'ı ile yazmalara yalnızca `userTokenReadOnly: false` olduğunda ve bot token'ı kullanılamadığında izin verilir.
## Eylemler ve kapılar
Slack eylemleri `channels.slack.actions.*` tarafından kontrol edilir.
Geçerli Slack araçlarında kullanılabilen eylem grupları:
| Grup | Varsayılan |
| ---------- | ---------- |
| messages | etkin |
| reactions | etkin |
| pins | etkin |
| memberInfo | etkin |
| emojiList | etkin |
Geçerli Slack mesaj 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, diğer dosya türleri için yerel dosya meta verileri döndürür.
## Erişim denetimi ve yönlendirme
`channels.slack.dmPolicy` DM erişimini kontrol eder. `channels.slack.allowFrom` standart DM izin listesidir.
- `pairing` (varsayılan)
- `allowlist`
- `open` (`channels.slack.allowFrom` içinde `"*"` bulunmasını gerektirir)
- `disabled`
DM bayrakları:
- `dm.enabled` (varsayılan true)
- `channels.slack.allowFrom`
- `dm.allowFrom` (eski)
- `dm.groupEnabled` (grup DM'leri varsayılan false)
- `dm.groupChannels` (isteğe bağlı MPIM izin listesi)
Çoklu hesap önceliği:
- `channels.slack.accounts.default.allowFrom` yalnızca `default` hesabına uygulanır.
- Adlandırılmış hesaplar, kendi `allowFrom` değerleri ayarlanmamışsa `channels.slack.allowFrom` değerini devralır.
- Adlandırılmış hesaplar `channels.slack.accounts.default.allowFrom` değerini devralmaz.
Eski `channels.slack.dm.policy` ve `channels.slack.dm.allowFrom` uyumluluk için hâlâ okunur. `openclaw doctor --fix`, erişimi değiştirmeden yapabildiğinde bunları `dmPolicy` ve `allowFrom` öğelerine geçirir.
DM'lerde eşleştirme `openclaw pairing approve slack ` kullanır.
`channels.slack.groupPolicy` kanal işlemeyi kontrol eder:
- `open`
- `allowlist`
- `disabled`
Kanal izin listesi `channels.slack.channels` altında bulunur ve yapılandırma anahtarları olarak **kararlı Slack kanal kimliklerini** (örneğin `C12345678`) kullanmalıdır.
Çalışma zamanı notu: `channels.slack` tamamen eksikse (yalnızca ortam değişkeni kurulumu), çalışma zamanı `groupPolicy="allowlist"` değerine geri döner ve bir uyarı günlüğe yazar (`channels.defaults.groupPolicy` ayarlanmış olsa bile).
Ad/kimlik çözümleme:
- kanal izin listesi girişleri ve DM izin listesi girişleri, token erişimi izin verdiğinde başlangıçta çözümlenir
- çözümlenmemiş kanal adı girişleri yapılandırıldığı gibi tutulur ancak varsayılan olarak yönlendirme için yok sayılır
- gelen yetkilendirme ve kanal yönlendirme varsayılan olarak kimlik önceliklidir; doğrudan kullanıcı adı/slug eşleşmesi `channels.slack.dangerouslyAllowNameMatching: true` gerektirir
Ada dayalı anahtarlar (`#channel-name` veya `channel-name`) `groupPolicy: "allowlist"` altında eşleşmez. Kanal araması varsayılan olarak kimlik önceliklidir; bu nedenle ada dayalı bir anahtar asla başarıyla yönlendirilmez ve o kanaldaki tüm mesajlar sessizce engellenir. Bu, kanal anahtarının yönlendirme için gerekli olmadığı ve ada dayalı bir anahtarın çalışıyor gibi göründüğü `groupPolicy: "open"` davranışından farklıdır.
Anahtar olarak her zaman Slack kanal kimliğini kullanın. Bulmak için: Slack içinde kanala sağ tıklayın → **Bağlantıyı kopyala** — kimlik (`C...`) URL'nin sonunda görünür.
Doğru:
```json5
{
channels: {
slack: {
groupPolicy: "allowlist",
channels: {
C12345678: { allow: true, requireMention: true },
},
},
},
}
```
Yanlış (`groupPolicy: "allowlist"` altında sessizce engellenir):
```json5
{
channels: {
slack: {
groupPolicy: "allowlist",
channels: {
"#eng-my-channel": { allow: true, requireMention: true },
},
},
},
}
```
Kanal mesajları varsayılan olarak bahsetme kapılıdır.
Bahsetme kaynakları:
- açık uygulama bahsetmesi (`<@botId>`)
- bot kullanıcısı ilgili kullanıcı grubunun üyesiyse Slack kullanıcı grubu bahsetmesi (``); `usergroups:read` gerektirir
- bahsetme regex desenleri (`agents.list[].groupChat.mentionPatterns`, yedek `messages.groupChat.mentionPatterns`)
- örtük bota yanıt iş parçacığı davranışı (`thread.requireExplicitMention` `true` olduğunda devre dışı)
Kanal başına kontroller (`channels.slack.channels.`; adlar yalnızca başlangıç çözümlemesi veya `dangerouslyAllowNameMatching` üzerinden):
- `requireMention`
- `users` (izin listesi)
- `allowBots`
- `skills`
- `systemPrompt`
- `tools`, `toolsBySender`
- `toolsBySender` anahtar biçimi: `channel:`, `id:`, `e164:`, `username:`, `name:` veya `"*"` jokeri
(eski öneksiz anahtarlar hâlâ yalnızca `id:` ile eşlenir)
`allowBots`, kanallar ve özel kanallar için temkinlidir: bot tarafından yazılmış oda mesajları yalnızca gönderen bot o odanın `users` izin listesinde açıkça listelenmişse veya `channels.slack.allowFrom` içindeki en az bir açık Slack sahip kimliği şu anda oda üyesiyse kabul edilir. Jokerler ve görünen ad sahip girişleri sahip varlığı koşulunu karşılamaz. Sahip varlığı Slack `conversations.members` kullanır; uygulamanın oda türü için eşleşen okuma kapsamına sahip olduğundan emin olun (genel kanallar için `channels:read`, özel kanallar için `groups:read`). Üye araması başarısız olursa OpenClaw bot tarafından yazılmış oda mesajını düşürür.
## İş 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 oturumuna daraltılır.
- Kanal oturumları: `agent::slack:channel:`.
- İş parçacığı yanıtları, geçerli olduğunda iş parçacığı oturum sonekleri (`:thread:`) oluşturabilir.
- OpenClaw'ın açık bir bahsetme gerektirmeden üst düzey mesajları işlediği kanallarda, `off` olmayan `replyToMode`, işlenen her kökü `agent::slack:channel::thread:` içine yönlendirir; böylece görünen Slack iş parçacığı ilk turdan itibaren tek bir OpenClaw oturumuyla eşleşir.
- `channels.slack.thread.historyScope` varsayılanı `thread`; `thread.inheritParent` varsayılanı `false`.
- `channels.slack.thread.initialHistoryLimit`, yeni bir iş parçacığı oturumu başladığında kaç mevcut iş parçacığı mesajının getirileceğini kontrol eder (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ığına daha önce katılmış olsa bile yalnızca iş parçacıkları içindeki açık `@bot` bahsetmelerine yanıt verir. Bu olmadan, botun katıldığı bir iş parçacığındaki yanıtlar `requireMention` kapısını atlar.
Yanıt iş parçacığı kontrolleri:
- `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`
Elle yanıt etiketleri desteklenir:
- `[[reply_to_current]]`
- `[[reply_to:]]`
`message` aracından açık Slack iş parçacığı yanıtları için Slack'ten iş parçacığı yanıtını üst kanala da yayınlamasını istemek üzere `action: "send"` ile `replyBroadcast: true` ve `threadId` veya `replyTo` ayarlayın. Bu, Slack'in `chat.postMessage` `reply_broadcast` bayrağına eşlenir ve medya yüklemeleri için değil, yalnızca metin veya Block Kit gönderimleri için desteklenir.
Bir `message` araç çağrısı bir Slack iş parçacığı içinde çalıştığında ve aynı kanalı hedeflediğinde, OpenClaw normalde geçerli Slack iş parçacığını `replyToMode` uyarınca devralır. Bunun yerine yeni bir üst kanal mesajını zorlamak için `action: "send"` veya `action: "upload-file"` üzerinde `topLevel: true` ayarlayın. `threadId: null` aynı üst düzey vazgeçme seçeneği olarak kabul edilir.
`replyToMode="off"` Slack'te açık `[[reply_to_*]]` etiketleri dahil **tüm** yanıt iş parçacıklarını devre dışı bırakır. Bu, `"off"` modunda açık etiketlerin hâlâ dikkate alındığı Telegram'dan farklıdır. Slack iş parçacıkları mesajları kanaldan gizlerken Telegram yanıtları satır içinde görünür kalır.
## Onay tepkileri
`ackReaction`, OpenClaw gelen bir mesajı işlerken bir onay emojisi gönderir.
Çözümleme sırası:
- `channels.slack.accounts..ackReaction`
- `channels.slack.ackReaction`
- `messages.ackReaction`
- ajan kimliği emoji yedeği (`agents.list[].identity.emoji`, aksi halde "👀")
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ı kontrol eder:
- `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üncellemelerini ekler.
- `progress`: oluşturma sırasında ilerleme durumu metnini gösterir, ardından son metni gönderir.
- `streaming.preview.toolProgress`: taslak önizleme etkinken araç/ilerleme güncellemelerini aynı düzenlenen önizleme mesajına yönlendirir (varsayılan: `true`). Ayrı araç/ilerleme mesajlarını korumak için `false` 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`).
Kompakt ilerleme satırlarını korurken ham komut/exec metnini gizleyin:
```json
{
"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ı kontrol eder (varsayılan: `true`).
- Yerel metin akışının ve Slack asistan dizisi durumunun görünmesi için bir yanıt dizisi kullanılabilir olmalıdır. Dizi seçimi yine `replyToMode` ayarını izler.
- Kanal, grup sohbeti ve üst düzey DM kökleri, yerel akış kullanılamadığında veya yanıt dizisi olmadığında normal taslak önizlemesini kullanmaya devam edebilir.
- Üst düzey Slack DM'leri varsayılan olarak dizi dışında kalır, bu nedenle Slack'in dizi tarzı yerel akış/durum önizlemesini göstermez; bunun yerine OpenClaw DM içinde bir taslak önizlemesi gönderir ve düzenler.
- Medya ve metin olmayan payload'lar normal teslimata geri döner.
- Medya/hata finalleri bekleyen önizleme düzenlemelerini iptal eder; uygun metin/blok finalleri yalnızca önizlemeyi yerinde düzenleyebildiklerinde boşaltılır.
- Akış yanıtın ortasında başarısız olursa OpenClaw kalan payload'lar için normal teslimata geri döner.
Slack yerel metin akışı yerine taslak önizlemesi kullanın:
```json5
{
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ı kurallı anahtarlara yeniden yazmak için `openclaw doctor --fix` çalıştırın.
## Yazıyor tepkisi yedeği
`typingReaction`, OpenClaw bir yanıtı işlerken gelen Slack mesajına geçici bir tepki ekler, ardından çalışma bittiğinde bunu kaldırır. Bu, varsayılan bir "yazıyor..." durum göstergesi kullanan dizi yanıtlarının dışında en kullanışlıdır.
Çözümleme sırası:
- `channels.slack.accounts..typingReaction`
- `channels.slack.typingReaction`
Notlar:
- Slack kısa kodlar bekler (örneğin `"hourglass_flowing_sand"`).
- Tepki en iyi çabayla uygulanır ve yanıt veya hata yolu tamamlandıktan sonra temizlik otomatik olarak denenir.
## Medya, parçalara ayırma ve teslimat
Slack dosya ekleri, Slack tarafından barındırılan özel URL'lerden indirilir (token ile kimlik doğrulamalı istek akışı) ve getirme başarılı olduğunda ve boyut sınırları izin verdiğinde medya deposuna yazılır. Dosya yer tutucuları Slack `fileId` değerini içerir, böylece ajanlar özgün dosyayı `download-file` ile getirebilir.
İndirmeler sınırlı boşta kalma ve toplam zaman aşımları kullanır. Slack dosyası alma işlemi takılır veya başarısız olursa OpenClaw mesajı işlemeye devam eder ve dosya yer tutucusuna geri döner.
Çalışma zamanı gelen boyut sınırı, `channels.slack.mediaMaxMb` ile geçersiz kılınmadığı sürece varsayılan olarak `20MB` olur.
- metin parçaları `channels.slack.textChunkLimit` kullanır (varsayılan 4000)
- `channels.slack.chunkMode="newline"` paragraf öncelikli bölmeyi etkinleştirir
- dosya gönderimleri Slack yükleme API'lerini kullanır ve dizi yanıtlarını (`thread_ts`) içerebilir
- giden medya sınırı yapılandırıldığında `channels.slack.mediaMaxMb` değerini izler; aksi halde kanal gönderimleri medya pipeline'ındaki MIME türü varsayılanlarını kullanır
Tercih edilen açık hedefler:
- DM'ler için `user:`
- kanallar için `channel:`
Yalnızca metin/blok içeren Slack DM'leri doğrudan kullanıcı ID'lerine gönderi yapabilir; dosya yüklemeleri ve dizili gönderimler önce Slack konuşma API'leri üzerinden DM'yi açar, çünkü bu yollar somut bir konuşma ID'si gerektirir.
## Komutlar ve slash davranışı
Slash komutları Slack'te tek bir yapılandırılmış komut veya birden fazla 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`
```txt
/openclaw /help
```
Yerel komutlar, Slack uygulamanızda [ek manifest ayarları](#additional-manifest-settings) 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.
```txt
/help
```
Yerel argüman menüleri, seçilen 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çenekleri işleyicileri mevcut olduğunda zaman uyumsuz seçenek filtrelemeli harici seçim
- Slack sınırları aşıldı: kodlanmış seçenek değerleri düğmelere geri döner
```txt
/think
```
Slash oturumları `agent::slack:slash:` 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, ajan 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:
```json5
{
channels: {
slack: {
capabilities: {
interactiveReplies: true,
},
},
},
}
```
Ya da yalnızca tek bir Slack hesabı için etkinleştirin:
```json5
{
channels: {
slack: {
accounts: {
ops: {
capabilities: {
interactiveReplies: true,
},
},
},
},
},
}
```
Etkinleştirildiğinde ajanlar yalnızca Slack'e özel 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 OpenClaw tarafından üretilen opak token'lardır, ajan tarafından yazılmış ham değerler değildir.
- Üretilen etkileşimli bloklar Slack Block Kit sınırlarını aşacaksa OpenClaw geçersiz bir blocks payload'ı göndermek yerine özgün metin yanıtına geri döner.
## Slack'te exec onayları
Slack, Web UI veya terminale geri dönmek yerine etkileşimli düğmeler ve etkileşimlerle yerel bir onay istemcisi olarak davranabilir.
- Exec onayları yerel DM/kanal yönlendirmesi için `channels.slack.execApprovals.*` kullanır.
- Plugin onayları, istek zaten Slack'e ulaştığında ve onay id türü `plugin:` olduğunda aynı Slack yerel düğme yüzeyi üzerinden çözümlenmeye devam edebilir.
- Onaylayan yetkilendirmesi hâlâ 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 konuşmanın içinde doğrudan Block Kit düğmeleri olarak işlenir.
Bu düğmeler mevcut olduğunda birincil onay kullanıcı deneyimi bunlardır; OpenClaw,
yalnızca araç sonucu sohbet onaylarının kullanılamadığını veya manuel onayın tek yol olduğunu söylediğinde manuel bir `/approve` komutu içermelidir.
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ı olmadığında varsayılan davranış:
```json5
{
commands: {
ownerAllowFrom: ["slack:U12345678"],
},
}
```
Açık Slack yerel yapılandırması yalnızca onaylayanları geçersiz kılmak, filtre eklemek veya
kaynak sohbet teslimatına dahil olmak istediğinizde gerekir:
```json5
{
channels: {
slack: {
execApprovals: {
enabled: true,
approvers: ["U12345678"],
target: "both",
},
},
},
}
```
Paylaşılan `approvals.exec` yönlendirmesi ayrıdır. 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` yönlendirmesi de
ayrıdır; Slack yerel düğmeleri, bu istekler zaten Slack'e ulaştığında Plugin onaylarını yine de çözümlüyebilir.
Aynı sohbet `/approve`, zaten komutları destekleyen Slack kanallarında ve DM'lerinde de çalışır. Tam onay yönlendirme modeli için [Exec onayları](/tr/tools/exec-approvals) bölümüne bakın.
## Olaylar ve operasyonel davranış
- Mesaj düzenlemeleri/silmeleri sistem olaylarına eşlenir.
- Dizi yayınları ("Kanala da gönder" dizi 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 sabitleme 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 değerlendirilir ve yönlendirme bağlamına enjekte edilebilir.
- Dizi başlatıcı ve ilk dizi geçmişi bağlamı tohumlama, geçerli olduğunda yapılandırılmış gönderen izin listelerine göre 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
- modal `view_submission` ve `view_closed` olayları, yönlendirilmiş kanal meta verileri ve form girdileriyle
## Yapılandırma referansı
Birincil referans: [Yapılandırma referansı - Slack](/tr/gateway/config-channels#slack).
- mod/kimlik doğrulama: `mode`, `botToken`, `appToken`, `signingSecret`, `webhookPath`, `accounts.*`
- DM erişimi: `dm.enabled`, `dmPolicy`, `allowFrom` (eski: `dm.policy`, `dm.allowFrom`), `dm.groupEnabled`, `dm.groupChannels`
- uyumluluk anahtarı: `dangerouslyAllowNameMatching` (acil durum; gerekmedikçe kapalı tutun)
- kanal erişimi: `groupPolicy`, `channels.*`, `channels.*.users`, `channels.*.requireMention`
- dizileme/geçmiş: `replyToMode`, `replyToModeByChatType`, `thread.*`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit`
- teslimat: `textChunkLimit`, `chunkMode`, `mediaMaxMb`, `streaming`, `streaming.nativeTransport`, `streaming.preview.toolProgress`
- önizlemeler: `chat.postMessage` bağlantı/medya önizleme denetimi için `unfurlLinks`, `unfurlMedia`
- operasyonlar/özellikler: `configWrites`, `commands.native`, `slashCommand.*`, `actions.*`, `userToken`, `userTokenReadOnly`
## Sorun giderme
Sırayla kontrol edin:
- `groupPolicy`
- kanal izin listesi (`channels.slack.channels`) — **anahtarlar kanal ID'leri olmalıdır** (`C12345678`), adlar değil (`#channel-name`). Ad tabanlı anahtarlar `groupPolicy: "allowlist"` altında sessizce başarısız olur, çünkü kanal yönlendirmesi varsayılan olarak ID önceliklidir. Bir ID bulmak için: Slack'te kanala sağ tıklayın → **Bağlantıyı kopyala** — URL'nin sonundaki `C...` değeri kanal ID'sidir.
- `requireMention`
- kanal başına `users` izin listesi
Yararlı komutlar:
```bash
openclaw channels status --probe
openclaw logs --follow
openclaw doctor
```
Kontrol edin:
- `channels.slack.dm.enabled`
- `channels.slack.dmPolicy` (veya eski `channels.slack.dm.policy`)
- eşleştirme onayları / izin listesi girdileri
- Slack Assistant DM olayları: `drop message_changed` ifadesinden bahseden ayrıntılı günlükler
genellikle Slack'in mesaj meta verilerinde kurtarılabilir bir insan gönderen olmadan
düzenlenmiş bir Assistant dizisi olayı gönderdiği anlamına gelir
```bash
openclaw pairing list slack
```
Slack uygulama ayarlarında bot + uygulama token'larını ve Socket Mode etkinleştirmesini doğrulayın.
`openclaw channels status --probe --json` çıktısı `botTokenStatus` veya
`appTokenStatus: "configured_unavailable"` gösteriyorsa Slack hesabı
yapılandırılmıştır, ancak geçerli çalışma zamanı SecretRef destekli
değeri çözememiştir.
Doğrulayın:
- imzalama gizli anahtarı
- webhook yolu
- Slack Request URL'leri (Events + Interactivity + Slash Commands)
- HTTP hesabı başına benzersiz `webhookPath`
Hesap anlık görüntülerinde `signingSecretStatus: "configured_unavailable"`
görünürse, HTTP hesabı yapılandırılmıştır ancak mevcut çalışma zamanı
SecretRef destekli imzalama gizli anahtarını çözememiştir.
Hangisini amaçladığınızı doğrulayın:
- Slack'te kayıtlı eşleşen slash komutlarıyla yerel komut modu (`channels.slack.commands.native: true`)
- veya tek slash komutu modu (`channels.slack.slashCommand.enabled: true`)
Ayrıca `commands.useAccessGroups` ile kanal/kullanıcı izin listelerini denetleyin.
## Ek görsel referansı
Slack dosya indirmeleri başarılı olduğunda ve boyut sınırları izin verdiğinde Slack, indirilen medyayı aracı turuna ekleyebilir. Görsel dosyaları medya anlama yolundan geçirilebilir veya doğrudan görsel yetenekli bir yanıt modeline aktarılabilir; diğer dosyalar ise görsel girdisi olarak ele alınmak yerine indirilebilir dosya bağlamı olarak tutulur.
### Desteklenen medya türleri
| Medya türü | Kaynak | Mevcut davranış | Notlar |
| ------------------------------ | -------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| JPEG / PNG / GIF / WebP görselleri | Slack dosya URL'si | İndirilir ve görsel yetenekli işleme için tura eklenir | Dosya başına sınır: `channels.slack.mediaMaxMb` (varsayılan 20 MB) |
| PDF dosyaları | Slack dosya URL'si | İndirilir ve `download-file` veya `pdf` gibi araçlar için dosya bağlamı olarak sunulur | Slack gelen iş akışı PDF'leri otomatik olarak görsel-görüş girdisine dönüştürmez |
| Diğer dosyalar | Slack dosya URL'si | Mümkün olduğunda indirilir ve dosya bağlamı olarak sunulur | İkili dosyalar görsel girdisi olarak ele alınmaz |
| Konu yanıtları | Konu başlatıcı dosyaları | Yanıtta doğrudan medya yoksa kök mesaj dosyaları bağlam olarak doldurulabilir | Yalnızca dosya içeren başlatıcılar bir ek yer tutucusu kullanır |
| Çoklu görsel mesajları | Birden fazla Slack dosyası | Her dosya bağımsız olarak değerlendirilir | Slack işleme, mesaj başına sekiz dosyayla sınırlıdır |
### Gelen iş 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ılı olursa dosya medya deposuna yazılır.
3. İndirilen medya yolları ve içerik türleri gelen bağlama eklenir.
4. Görsel yetenekli model/araç yolları bu bağlamdaki görsel eklerini kullanabilir.
5. Görsel olmayan dosyalar, bunları işleyebilen araçlar için dosya meta verisi veya medya referansı olarak kullanılabilir kalır.
### Konu kökü ek devralma
Bir mesaj bir konuda geldiğinde (`thread_ts` üst öğesine sahipse):
- 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 doldurabilir.
- Doğrudan yanıt ekleri, kök mesaj eklerine göre önceliklidir.
- Yalnızca dosyaları olan ve metni olmayan bir kök mesaj, yedeğin dosyalarını yine de içerebilmesi için bir ek yer tutucusuyla temsil edilir.
### Çoklu ek işleme
Tek bir Slack mesajı birden fazla dosya eki içerdiğinde:
- Her ek medya iş hattından bağımsız olarak geçirilir.
- İndirilen medya referansları mesaj bağlamında birleştirilir.
- İş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` ile yapılandırılabilir.
- **İndirme hataları**: Slack'in sunamadığı dosyalar, süresi dolmuş URL'ler, erişilemeyen dosyalar, büyük boyutlu dosyalar ve Slack kimlik doğrulama/giriş HTML yanıtları desteklenmeyen biçimler olarak bildirilmek yerine atlanır.
- **Görsel modeli**: Görsel analizi, görseli destekliyorsa etkin yanıt modelini veya `agents.defaults.imageModel` konumunda yapılandırılan görsel modelini kullanır.
### Bilinen sınırlar
| Senaryo | Mevcut davranış | Geçici çözüm |
| -------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Süresi dolmuş Slack dosya URL'si | Dosya atlanır; hata gösterilmez | Dosyayı Slack'e yeniden yükleyin |
| Görsel modeli yapılandırılmamış | Görsel ekleri medya referansları olarak saklanır, ancak görsel olarak analiz edilmez | `agents.defaults.imageModel` yapılandırın veya görsel yetenekli bir yanıt modeli kullanın |
| Çok büyük görseller (varsayılan olarak > 20 MB) | Boyut sınırına göre atlanır | Slack izin veriyorsa `channels.slack.mediaMaxMb` değerini artırın |
| İletilmiş/paylaşılmış ekler | Metin ve Slack üzerinde barındırılan görsel/dosya medyası en iyi çabayla işlenir | Doğrudan OpenClaw konusunda yeniden paylaşın |
| PDF ekleri | Dosya/medya bağlamı olarak saklanır, otomatik olarak görsel görüşten geçirilmez | Dosya meta verileri için `download-file` veya PDF analizi için `pdf` aracını kullanın |
### İlgili belgeler
- [Medya anlama iş hattı](/tr/nodes/media-understanding)
- [PDF aracı](/tr/tools/pdf)
- Epic: [#51349](https://github.com/openclaw/openclaw/issues/51349) — Slack ek görsel etkinleştirmesi
- Regresyon testleri: [#51353](https://github.com/openclaw/openclaw/issues/51353)
- Canlı doğrulama: [#51354](https://github.com/openclaw/openclaw/issues/51354)
## İlgili
Bir Slack kullanıcısını Gateway ile eşleştirin.
Kanal ve grup DM davranışı.
Gelen mesajları aracılara yönlendirin.
Tehdit modeli ve sağlamlaştırma.
Yapılandırma düzeni ve öncelik.
Komut kataloğu ve davranışı.