Slack

​

Wybór transportu

​

Tryb przekaźnikowy

{
  channels: {
    slack: {
      mode: "relay",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      relay: {
        url: "wss://router.example.com/gateway/ws",
        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },
        gatewayId: "team-gateway",
      },
    },
  },
}

​

Instalacje obejmujące całą organizację Enterprise Grid

​

Socket Mode

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      enterpriseOrgInstall: true,
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

Adresy URL żądań HTTP

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      enterpriseOrgInstall: true,
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      signingSecret: {
        source: "env",
        provider: "default",
        id: "SLACK_SIGNING_SECRET",
      },
      webhookPath: "/slack/events",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

Instalacja

openclaw plugins install @openclaw/slack

​

Szybka konfiguracja

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Łącznik Slack dla 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw łączy wątki asystenta Slack z agentami OpenClaw.",
      "suggested_prompts": [
        { "title": "Co potrafisz?", "message": "W czym możesz mi pomóc?" },
        {
          "title": "Podsumuj ten kanał",
          "message": "Podsumuj ostatnią aktywność na tym kanale."
        },
        { "title": "Przygotuj odpowiedź", "message": "Pomóż mi przygotować odpowiedź." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Wyślij wiadomość do 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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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": "Łącznik Slack dla 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw łączy wątki asystenta Slack z agentami OpenClaw.",
      "suggested_prompts": [
        { "title": "Co potrafisz?", "message": "W czym możesz mi pomóc?" },
        {
          "title": "Podsumuj ten kanał",
          "message": "Podsumuj ostatnią aktywność na tym kanale."
        },
        { "title": "Przygotuj odpowiedź", "message": "Pomóż mi przygotować odpowiedź." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Wyślij wiadomość do 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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

export SLACK_APP_TOKEN=slack-app-token-example
export SLACK_BOT_TOKEN=slack-bot-token-example
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=slack-app-token-example
SLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Łącznik Slack dla 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw łączy wątki asystenta Slack z agentami OpenClaw.",
      "suggested_prompts": [
        { "title": "Co potrafisz?", "message": "W czym możesz mi pomóc?" },
        {
          "title": "Podsumuj ten kanał",
          "message": "Podsumuj ostatnią aktywność na tym kanale."
        },
        { "title": "Przygotuj odpowiedź", "message": "Pomóż mi przygotować odpowiedź." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Wyślij wiadomość do 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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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": "Łącznik Slack dla 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw łączy wątki asystenta Slack z agentami OpenClaw.",
      "suggested_prompts": [
        { "title": "Co potrafisz?", "message": "W czym możesz mi pomóc?" },
        {
          "title": "Podsumuj ten kanał",
          "message": "Podsumuj ostatnią aktywność na tym kanale."
        },
        { "title": "Przygotuj odpowiedź", "message": "Pomóż mi przygotować odpowiedź." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Wyślij wiadomość do 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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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=slack-bot-token-example
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

​

Dostrajanie transportu Socket Mode

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

• socketMode jest ignorowany w trybie HTTP Request URL.
• Podstawowe ustawienia channels.slack.socketMode mają zastosowanie do wszystkich kont Slack, o ile nie zostaną nadpisane. Nadpisania dla poszczególnych kont używają channels.slack.accounts.<accountId>.socketMode; ponieważ jest to nadpisanie obiektu, należy uwzględnić każde pole dostrajania połączenia, które ma być używane przez dane konto.
• Tylko clientPingTimeout ma wartość domyślną OpenClaw (15000). serverPingTimeout i pingPongLoggingEnabled są przekazywane do Slack SDK tylko wtedy, gdy zostały skonfigurowane.
• Opóźnienie ponownego uruchomienia Socket Mode zaczyna się od około 2 sekund i jest ograniczone do około 30 sekund. Możliwe do odzyskania błędy uruchamiania, oczekiwania na uruchomienie i rozłączenia są ponawiane do czasu zatrzymania kanału. Trwałe błędy konta i danych uwierzytelniających, takie jak nieprawidłowe uwierzytelnianie, unieważnione tokeny lub brakujące zakresy, powodują natychmiastowe niepowodzenie zamiast ponawiania w nieskończoność.

​

Lista kontrolna manifestu i zakresów

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Łącznik Slack dla 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw łączy wątki asystenta Slack z agentami OpenClaw.",
      "suggested_prompts": [
        { "title": "Co potrafisz?", "message": "W czym możesz mi pomóc?" },
        {
          "title": "Podsumuj ten kanał",
          "message": "Podsumuj ostatnią aktywność na tym kanale."
        },
        { "title": "Przygotuj odpowiedź", "message": "Pomóż mi przygotować odpowiedź." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Wyślij wiadomość do 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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Wyślij wiadomość do 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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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"
    }
  }
}

​

Dodatkowe ustawienia manifestu

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Rozpocznij nową sesję",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "Zresetuj bieżącą sesję"
    },
    {
      "command": "/compact",
      "description": "Skompaktuj kontekst sesji",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "Zatrzymaj bieżące uruchomienie"
    },
    {
      "command": "/session",
      "description": "Zarządzaj wygaśnięciem powiązania wątku",
      "usage_hint": "idle <duration|off> lub max-age <duration|off>"
    },
    {
      "command": "/think",
      "description": "Ustaw poziom myślenia",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "Przełącz szczegółowe dane wyjściowe",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "Pokaż lub ustaw tryb szybki",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "Przełącz widoczność rozumowania",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "Przełącz tryb podwyższonych uprawnień",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "Pokaż lub ustaw wartości domyślne wykonywania",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/approve",
      "description": "Zatwierdź lub odrzuć oczekujące prośby o zatwierdzenie",
      "usage_hint": "<id> <decision>"
    },
    {
      "command": "/model",
      "description": "Pokaż lub ustaw model",
      "usage_hint": "[name|#|status]"
    },
    {
      "command": "/models",
      "description": "Wyświetl dostawców/modele",
      "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
    },
    {
      "command": "/help",
      "description": "Pokaż krótkie podsumowanie pomocy"
    },
    {
      "command": "/commands",
      "description": "Pokaż wygenerowany katalog poleceń"
    },
    {
      "command": "/tools",
      "description": "Pokaż, z czego bieżący agent może teraz korzystać",
      "usage_hint": "[compact|verbose]"
    },
    {
      "command": "/agentstatus",
      "description": "Pokaż stan środowiska uruchomieniowego, w tym wykorzystanie/limit dostawcy, jeśli są dostępne"
    },
    {
      "command": "/tasks",
      "description": "Wyświetl aktywne/niedawne zadania w tle dla bieżącej sesji"
    },
    {
      "command": "/context",
      "description": "Wyjaśnij sposób składania kontekstu",
      "usage_hint": "[list|detail|json]"
    },
    {
      "command": "/whoami",
      "description": "Pokaż tożsamość nadawcy"
    },
    {
      "command": "/skill",
      "description": "Uruchom umiejętność według nazwy",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "Zadaj pytanie poboczne bez zmiany kontekstu sesji",
      "usage_hint": "<question>"
    },
    {
      "command": "/side",
      "description": "Zadaj pytanie poboczne bez zmiany kontekstu sesji",
      "usage_hint": "<question>"
    },
    {
      "command": "/usage",
      "description": "Steruj stopką wykorzystania lub pokaż podsumowanie kosztów",
      "usage_hint": "off|tokens|full|cost"
    }
  ]
}

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Rozpocznij nową sesję",
      "usage_hint": "[model]",
      "url": "https://gateway-host.example.com/slack/events"
    },
    {
      "command": "/help",
      "description": "Pokaż krótkie podsumowanie pomocy",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

​

Model tokenów

• botToken + appToken są wymagane w trybie Socket Mode.
• Tryb HTTP wymaga botToken + signingSecret.
• Tryb przekaźnika wymaga botToken oraz relay.url, relay.authToken i relay.gatewayId; nie używa tokenu aplikacji ani sekretu podpisywania.
• botToken, appToken, signingSecret, relay.authToken i userToken akceptują ciągi tekstowe w postaci jawnej lub obiekty SecretRef.
• Tokeny konfiguracji zastępują wartości rezerwowe ze środowiska.
• Wartości rezerwowe zmiennych środowiskowych SLACK_BOT_TOKEN, SLACK_APP_TOKEN i SLACK_USER_TOKEN mają zastosowanie wyłącznie do konta domyślnego.
• userToken domyślnie działa tylko do odczytu (userTokenReadOnly: true).

• Inspekcja konta Slack śledzi dla każdego poświadczenia pola *Source i *Status (botToken, appToken, signingSecret, userToken).
• Stan to available, configured_unavailable lub missing.
• configured_unavailable oznacza, że konto skonfigurowano za pomocą SecretRef lub innego źródła sekretu niewprowadzonego bezpośrednio, ale bieżąca ścieżka polecenia/środowiska uruchomieniowego nie mogła rozpoznać rzeczywistej wartości.
• W trybie HTTP uwzględniany jest signingSecretStatus; w trybie Socket Mode wymagana para to botTokenStatus + appTokenStatus.

​

Akcje i bramki

​

Kontrola dostępu i trasowanie

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { enabled: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { enabled: true, requireMention: true },
      },
    },
  },
}

​

Wątki, sesje i znaczniki odpowiedzi

• Wiadomości prywatne są kierowane jako direct; kanały jako channel; MPIM jako group.
• Powiązania tras Slack akceptują nieprzetworzone identyfikatory elementów równorzędnych oraz formy celów Slack, takie jak channel:C12345678, user:U12345678 i <@U12345678>.
• Przy domyślnym ustawieniu session.dmScope=main wiadomości prywatne Slack są łączone z główną sesją agenta.
• Sesje kanałów: agent:<agentId>:slack:channel:<channelId>.
• Zwykłe wiadomości najwyższego poziomu w kanale pozostają w sesji przypisanej do kanału, nawet gdy replyToMode ma wartość inną niż off.
• Odpowiedzi w wątkach Slack używają nadrzędnego thread_ts Slack jako sufiksu sesji (:thread:<threadTs>), nawet gdy tworzenie wątków odpowiedzi wychodzących jest wyłączone przez replyToMode="off".
• OpenClaw inicjuje kwalifikujący się główny wpis kanału w agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>, gdy oczekuje się, że ten wpis rozpocznie widoczny wątek Slack, dzięki czemu wpis główny i późniejsze odpowiedzi w wątku współdzielą jedną sesję OpenClaw. Dotyczy to zdarzeń app_mention, jawnych dopasowań wzorców wzmianki o bocie lub skonfigurowanych wzorców wzmianek oraz kanałów requireMention: false z ustawieniem replyToMode innym niż off.
• Domyślna wartość channels.slack.thread.historyScope to thread; domyślna wartość thread.inheritParent to false.
• channels.slack.thread.initialHistoryLimit określa liczbę istniejących wiadomości wątku pobieranych przy rozpoczynaniu nowej sesji wątku (domyślnie 20; ustawienie 0 wyłącza tę funkcję).
• channels.slack.thread.requireExplicitMention (domyślnie false): gdy ustawiono true, pomija niejawne wzmianki w wątkach, dzięki czemu bot odpowiada wyłącznie na jawne wzmianki @bot wewnątrz wątków, nawet jeśli wcześniej uczestniczył w danym wątku. Bez tego odpowiedzi w wątku, w którym uczestniczył bot, omijają kontrolę requireMention.

• channels.slack.channels.<id>.replyToMode: nadpisanie dla poszczególnych kanałów dotyczące wiadomości w kanałach i kanałach prywatnych Slack
• channels.slack.replyToMode: off|first|all|batched (domyślnie off)
• channels.slack.replyToModeByChatType: dla każdego direct|group|channel
• starsze ustawienie zastępcze dla czatów bezpośrednich: channels.slack.dm.replyToMode

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

​

Reakcje potwierdzające

​

Emoji (ackReaction)

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• zastępcze emoji tożsamości agenta (agents.list[].identity.emoji, w przeciwnym razie "eyes" / 👀)

• Slack oczekuje krótkich kodów (na przykład "eyes").
• Aby wyłączyć reakcję dla konta Slack lub globalnie, należy użyć "".

​

Zakres (messages.ackReactionScope)

• "all": reaguj w wiadomościach prywatnych i grupach, w tym na zdarzenia otoczenia w pomieszczeniu.
• "direct": reaguj tylko w wiadomościach prywatnych.
• "group-all": reaguj na każdą wiadomość grupową z wyjątkiem zdarzeń otoczenia w pomieszczeniu (bez wiadomości prywatnych).
• "group-mentions" (domyślnie): reaguj w grupach, ale tylko wtedy, gdy bot jest wspomniany (lub w elementach grupowych obsługujących wzmianki, które wyraziły zgodę). Wiadomości prywatne są wykluczone.
• "off" / "none": nigdy nie reaguj.

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // reaguj w wiadomościach prywatnych i grupach
  },
}

​

Strumieniowanie tekstu

• off: wyłącz strumieniowanie podglądu na żywo.
• partial (domyślnie): zastępuj tekst podglądu najnowszym częściowym wynikiem.
• block: dołączaj fragmentaryczne aktualizacje podglądu.
• progress: wyświetlaj tekst stanu postępu podczas generowania, a następnie wyślij tekst końcowy.
• streaming.preview.toolProgress: gdy podgląd wersji roboczej jest aktywny, kieruj aktualizacje narzędzi i postępu do tej samej edytowanej wiadomości podglądu (domyślnie: true). Ustaw false, aby zachować oddzielne wiadomości narzędzi i postępu.
• streaming.preview.commandText / streaming.progress.commandText: ustaw status, aby zachować zwięzłe wiersze postępu narzędzi, jednocześnie ukrywając nieprzetworzony tekst poleceń i wykonania (domyślnie: raw).

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

• Aby natywne strumieniowanie tekstu i stan wątku asystenta Slack były widoczne, musi być dostępny wątek odpowiedzi. Wybór wątku nadal podlega replyToMode.
• Kanały, czaty grupowe i główne wpisy wiadomości prywatnych nadal mogą używać zwykłego podglądu wersji roboczej, gdy natywne strumieniowanie jest niedostępne lub nie istnieje wątek odpowiedzi.
• Wiadomości prywatne najwyższego poziomu Slack domyślnie pozostają poza wątkami, dlatego nie wyświetlają natywnego podglądu strumienia ani stanu w stylu wątku Slack; zamiast tego OpenClaw publikuje i edytuje podgląd wersji roboczej w wiadomości prywatnej.
• Multimedia i ładunki inne niż tekstowe korzystają ze zwykłego sposobu dostarczania.
• Końcowe multimedia lub błędy anulują oczekujące edycje podglądu; kwalifikujące się końcowe treści tekstowe lub blokowe są zatwierdzane tylko wtedy, gdy można edytować podgląd w miejscu.
• Jeśli strumieniowanie nie powiedzie się w trakcie odpowiedzi, OpenClaw przechodzi na zwykłe dostarczanie pozostałych ładunków.

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

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          nativeTaskCards: true,
          render: "rich",
        },
      },
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) jest starszym aliasem channels.slack.streaming.mode.
• wartość logiczna channels.slack.streaming jest starszym aliasem channels.slack.streaming.mode i channels.slack.streaming.nativeTransport.
• klucze najwyższego poziomu channels.slack.chunkMode i channels.slack.nativeStreaming są starszymi aliasami channels.slack.streaming.chunkMode i channels.slack.streaming.nativeTransport.
• Starsze aliasy nie są odczytywane w czasie działania; należy uruchomić openclaw doctor --fix, aby przepisać zapisaną konfigurację strumieniowania Slack na klucze kanoniczne.

​

Zastępcza reakcja pisania

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

• Slack oczekuje krótkich kodów (na przykład "hourglass_flowing_sand").
• Reakcja jest podejmowana w miarę możliwości, a próba jej usunięcia następuje automatycznie po zakończeniu odpowiedzi lub ścieżki błędu.

​

Wprowadzanie głosowe

• Dyktowanie głosowe w Slackbot działa w prywatnej konwersacji użytkownika ze Slackbot. Slack przekształca nagranie w monit Slackbot, ale nie udostępnia aplikacjom Slack innych firm pliku audio, zdarzenia dyktowania, monitu ani znacznika źródła danych wejściowych za pośrednictwem Events API. Plugin Slack OpenClaw nie może go włączyć ani odbierać.
• Klipy audio Slack to pliki przechowywane w Slack, które można publikować w wiadomości prywatnej OpenClaw, kanale lub wątku. OpenClaw pobiera dostępny klip przy użyciu tokenu bota, normalizuje metadane MIME klipu ze Slack i przekazuje go do współdzielonego potoku transkrypcji dźwięku. Zalecany manifest aplikacji zawiera wymagany zakres files:read.

​

Multimedia, dzielenie i dostarczanie

​

Polecenia i działanie ukośnika

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

/openclaw /help

• Automatyczny tryb poleceń natywnych jest wyłączony dla Slack, dlatego commands.native: "auto" nie włącza natywnych poleceń Slack.

/help

• 3–5 wystarczająco krótkich opcji: menu przepełnienia („…”)
• więcej niż 100 opcji, gdy dostępne jest asynchroniczne filtrowanie opcji: wybór zewnętrzny
• 1–2 opcje lub dowolna opcja, której zakodowana wartość jest zbyt długa dla pola wyboru: bloki przycisków
• w pozostałych przypadkach (6–100 opcji lub więcej niż 100 bez filtrowania asynchronicznego): statyczne menu wyboru, dzielone po 100 opcji na menu

/think

​

Natywne wykresy

{
  "blocks": [
    {
      "type": "chart",
      "chartType": "bar",
      "title": "Przychody kwartalne",
      "categories": ["I kw.", "II kw."],
      "series": [{ "name": "Przychody", "values": [120, 145] }],
      "xLabel": "Kwartał"
    }
  ]
}

• tytuł i opcjonalne etykiety osi: 50 znaków
• wykres kołowy: 1–12 dodatnich segmentów
• wykres liniowy/słupkowy/warstwowy: 1–12 serii o unikatowych nazwach i 1–20 wspólnych kategorii
• etykiety segmentów, kategorii i serii: 20 znaków
• każda seria musi zawierać po jednej skończonej wartości dla każdej kategorii; wartości wykresów innych niż kołowe mogą być ujemne

​

Natywne tabele

{
  "blocks": [
    {
      "type": "table",
      "caption": "Otwarty lejek",
      "headers": ["Konto", "Etap", "ARR"],
      "rows": [
        ["Acme", "Wygrana", 125000],
        ["Globex", "Weryfikacja", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

• 1–20 kolumn
• 1–100 wierszy danych oraz wiersz nagłówka
• taka sama liczba komórek w każdym wierszu
• maksymalnie 10 000 znaków łącznie we wszystkich komórkach tabel w jednej wiadomości

​

Odpowiedzi interaktywne

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

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

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

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

• To starszy interfejs użytkownika specyficzny dla Slacka. Inne kanały nie tłumaczą dyrektyw Slack Block Kit na własne systemy przycisków.
• Wartości interaktywnych wywołań zwrotnych to wygenerowane przez OpenClaw nieprzezroczyste tokeny, a nie nieprzetworzone wartości utworzone przez agenta.
• Jeśli wygenerowane interaktywne bloki przekroczyłyby limity Slack Block Kit, OpenClaw zamiast wysyłać nieprawidłowy ładunek bloków używa pierwotnej odpowiedzi tekstowej.

​

Przesyłanie formularzy modalnych obsługiwane przez plugin

• Ustaw callback_id na openclaw:<namespace>:<payload>.
• Można też zachować istniejące callback_id i umieścić pluginInteractiveData: "<namespace>:<payload>" w private_metadata formularza modalnego.

​

Natywne zatwierdzenia w Slacku

• Zatwierdzenia wykonania i pluginów mogą być wyświetlane jako natywne monity Slack Block Kit.
• channels.slack.execApprovals.* nadal odpowiada za włączanie natywnego klienta zatwierdzania wykonania oraz konfigurację routingu wiadomości prywatnych/kanałów.
• Wiadomości prywatne dotyczące zatwierdzania wykonania używają channels.slack.execApprovals.approvers lub commands.ownerAllowFrom.
• Zatwierdzenia pluginów używają natywnych przycisków Slacka, gdy Slack jest włączony jako natywny klient zatwierdzania dla sesji źródłowej albo gdy approvals.plugin kieruje do źródłowej sesji Slacka lub miejsca docelowego w Slacku.
• Wiadomości prywatne dotyczące zatwierdzania pluginów korzystają z osób zatwierdzających pluginy Slacka z channels.slack.allowFrom, allowFrom nazwanego konta lub domyślnej trasy konta.
• Autoryzacja osoby zatwierdzającej jest nadal wymuszana: osoby uprawnione tylko do zatwierdzania wykonania nie mogą zatwierdzać żądań pluginów, chyba że są również osobami zatwierdzającymi pluginy.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opcjonalne; w miarę możliwości używa awaryjnie commands.ownerAllowFrom)
• channels.slack.execApprovals.target (dm | channel | both, domyślnie: dm)
• agentFilter, sessionFilter

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

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

​

Zdarzenia i zachowanie operacyjne

• Edycje/usunięcia wiadomości są mapowane na zdarzenia systemowe.
• Transmisje wątku (odpowiedzi w wątku z opcją „Also send to channel”) są przetwarzane jako zwykłe wiadomości użytkownika.
• Zdarzenia dodania/usunięcia reakcji są mapowane na zdarzenia systemowe.
• Dołączenie/opuszczenie przez członka, utworzenie/zmiana nazwy kanału oraz dodanie/usunięcie przypięcia są mapowane na zdarzenia systemowe.
• Opcjonalne odpytywanie o obecność może zmapować zaobserwowane przejście ludzkiego uczestnika z away do active na ostatnio aktywną kwalifikującą się sesję Slacka tego uczestnika. Domyślnie jest wyłączone.
• channel_id_changed może migrować klucze konfiguracji kanałów, gdy włączone jest configWrites.
• Metadane tematu/celu kanału są traktowane jako niezaufany kontekst i mogą zostać wstrzyknięte do kontekstu routingu.
• Wiadomość rozpoczynająca wątek i początkowe zasilanie kontekstu historią wątku są w stosownych przypadkach filtrowane według skonfigurowanych list dozwolonych nadawców.
• Działania bloków, skróty i interakcje z formularzami modalnymi emitują ustrukturyzowane zdarzenia systemowe Slack interaction: ... z rozbudowanymi polami ładunku:
  • działania bloków: wybrane wartości, etykiety, wartości selektorów i metadane workflow_*
  • skróty globalne: metadane wywołania zwrotnego i wykonawcy, kierowane do bezpośredniej sesji wykonawcy
  • skróty wiadomości: kontekst wywołania zwrotnego, wykonawcy, kanału, wątku i wybranej wiadomości
  • zdarzenia formularzy modalnych view_submission i view_closed z kierowanymi metadanymi kanału i danymi wejściowymi formularza

​

Zdarzenia obecności

{
  channels: {
    slack: {
      presenceEvents: { mode: "auto" },
      channels: {
        C0123456789: { presenceEvents: { mode: "on" } },
        C0987654321: { presenceEvents: { mode: "off" } },
      },
    },
  },
}

• off (domyślnie): brak czasomierza obecności i wywołań API Slacka.
• auto: monitoruje wiadomości prywatne, MPIM-y i wątki Slacka aktywne w ciągu ostatnich 24 godzin, z maksymalnie 8 zaobserwowanymi ludzkimi uczestnikami. Sesje kanałów najwyższego poziomu są wykluczone.
• on: monitoruje te same rozmowy bez limitu uczestników i uwzględnia sesje kanałów najwyższego poziomu. Należy użyć nadpisania dla kanału, aby wymusić lub wyłączyć monitorowanie jednego kanału.

​

Dokumentacja konfiguracji

​

Rozwiązywanie problemów

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

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

openclaw pairing list slack

​

Informacje o załącznikach multimedialnych

​

Obsługiwane typy multimediów

​

Potok danych przychodzących

1. OpenClaw pobiera plik z prywatnego adresu URL Slack przy użyciu tokenu bota.
2. Po pomyślnym pobraniu plik zostaje zapisany w magazynie multimediów.
3. Ścieżki pobranych multimediów i typy zawartości są dodawane do kontekstu danych przychodzących.
4. Klipy audio są kierowane do współdzielonego potoku transkrypcji; ścieżki modeli i narzędzi obsługujących obrazy mogą korzystać z załączników obrazów z tego samego kontekstu.
5. Pozostałe pliki są dostępne jako metadane plików lub odwołania do multimediów dla narzędzi, które potrafią je obsłużyć.

​

Dziedziczenie załączników z wiadomości głównej wątku

• Jeśli sama odpowiedź nie zawiera bezpośrednich multimediów, a dołączona wiadomość główna zawiera pliki, Slack może załadować pliki wiadomości głównej jako kontekst wiadomości rozpoczynającej wątek.
• Pliki wiadomości głównej są ładowane wyłącznie podczas inicjowania nowej lub zresetowanej sesji wątku. Późniejsze odpowiedzi zawierające tylko tekst ponownie wykorzystują istniejący kontekst sesji i nie dołączają ponownie plików wiadomości głównej jako nowych multimediów.
• Bezpośrednie załączniki odpowiedzi mają pierwszeństwo przed załącznikami wiadomości głównej.
• Wiadomość główna zawierająca wyłącznie pliki i bez tekstu jest reprezentowana przez symbol zastępczy załącznika, dzięki czemu mechanizm rezerwowy może nadal uwzględnić jej pliki.

​

Obsługa wielu załączników

• Każdy załącznik jest przetwarzany niezależnie przez potok multimediów.
• Odwołania do pobranych multimediów są agregowane w kontekście wiadomości.
• Kolejność przetwarzania odpowiada kolejności plików Slack w ładunku zdarzenia.
• Niepowodzenie pobierania jednego załącznika nie blokuje pozostałych.

​

Limity rozmiaru, pobierania i modeli

• Limit rozmiaru: domyślnie 20 MB na plik. Można go skonfigurować za pomocą channels.slack.mediaMaxMb.
• Limit transkrypcji audio: tools.media.audio.maxBytes obowiązuje również, gdy pobrany plik jest wysyłany do dostawcy transkrypcji lub CLI.
• Niepowodzenia pobierania: pliki, których Slack nie może udostępnić, wygasłe adresy URL, niedostępne pliki, pliki przekraczające limit rozmiaru oraz odpowiedzi HTML uwierzytelniania/logowania Slack są pomijane zamiast zgłaszania ich jako nieobsługiwanych formatów.
• Model rozpoznawania obrazu: analiza obrazów używa aktywnego modelu odpowiedzi, jeśli obsługuje on rozpoznawanie obrazu, lub modelu obrazu skonfigurowanego w agents.defaults.imageModel.

​

Znane ograniczenia

​

Powiązana dokumentacja

• Potok rozpoznawania multimediów
• Audio i notatki głosowe
• Narzędzie PDF

​

Powiązane