Community translations by veiseule.ai — Help improve them on Crowdin
Skip to main content

Slack

Socket mode (default)

Mabilis na setup (baguhan)

  1. Gumawa ng Slack app at i-enable ang Socket Mode.
  2. Gumawa ng App Token (xapp-...) at Bot Token (xoxb-...).
  3. Itakda ang mga token para sa OpenClaw at simulan ang gateway.

Minimal na config:

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

Setup

  1. Gumawa ng Slack app (From scratch) sa https://api.slack.com/apps.
    1. Socket Mode → i-toggle sa on. Pagkatapos ay pumunta sa Basic Information → App-Level Tokens → Generate Token and Scopes na may scope na connections:write. Kopyahin ang App Token (xapp-...).
  3. OAuth & Permissions → idagdag ang mga bot token scope (gamitin ang manifest sa ibaba). Click Install to Workspace. Copy the Bot User OAuth Token (xoxb-...).
  4. Optional: OAuth & Permissions → add User Token Scopes (see the read-only list below). Reinstall the app and copy the User OAuth Token (xoxp-...).
  5. Event Subscriptions → i-enable ang events at mag-subscribe sa: - message.* (kasama ang edits/deletes/thread broadcasts) - app_mention - reaction_added, reaction_removed - member_joined_channel, member_left_channel - channel_rename - pin_added, pin_removed
  6. I-invite ang bot sa mga channel na gusto mong mabasa nito.
  7. Slash Commands → gumawa ng /openclaw kung ginagamit mo ang channels.slack.slashCommand. If you enable native commands, add one slash command per built-in command (same names as /help). Ang Native ay naka-off bilang default para sa Slack maliban kung itakda mo ang channels.slack.commands.native: true (ang global na commands.native ay "auto" na iniiwang naka-off ang Slack).
  8. App Home → i-enable ang Messages Tab para makapag-DM ang mga user sa bot.

Gamitin ang manifest sa ibaba para manatiling naka-sync ang scopes at events.

Suporta sa multi-account: gamitin ang channels.slack.accounts na may per-account na mga token at opsyonal na name. See gateway/configuration for the shared pattern.

OpenClaw config (Socket mode)

Itakda ang mga token via env vars (inirerekomenda):

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

O via config:

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

User token (opsyonal)

OpenClaw can use a Slack user token (xoxp-...) for read operations (history, pins, reactions, emoji, member info). Bilang default, nananatili itong read-only: nagbabasa mas pinipili ang user token kapag mayroon, at ang pagsusulat ay gumagamit pa rin ng bot token maliban kung hayagan kang mag-opt in. Even with userTokenReadOnly: false, the bot token stays preferred for writes when it is available.

Ang mga user token ay kino-configure sa config file (walang suporta sa env var). For multi-account, set channels.slack.accounts.<id>.userToken.

Halimbawa na may bot + app + user tokens:

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
      userToken: "xoxp-...",
    },
  },
}

Halimbawa na may tahasang itinakda ang userTokenReadOnly (pinapayagan ang user token writes):

{
  channels: {
    slack: {
      enabled: true,
      appToken: "xapp-...",
      botToken: "xoxb-...",
      userToken: "xoxp-...",
      userTokenReadOnly: false,
    },
  },
}

Paggamit ng token

  • Mga read operation (history, reactions list, pins list, emoji list, member info, search) ay mas pinipili ang user token kapag naka-configure, kung hindi ay ang bot token.
  • Write operations (send/edit/delete messages, add/remove reactions, pin/unpin, file uploads) use the bot token by default. Kung userTokenReadOnly: false at walang available na bot token, babalik ang OpenClaw sa user token.

History context

  • Kinokontrol ng channels.slack.historyLimit (o channels.slack.accounts.*.historyLimit) kung ilang pinakahuling mensahe ng channel/group ang isinasama sa prompt.
  • Falls back to messages.groupChat.historyLimit. Itakda sa 0 para i-disable (default 50).

HTTP mode (Events API)

Gamitin ang HTTP webhook mode kapag ang iyong Gateway ay naaabot ng Slack sa pamamagitan ng HTTPS (karaniwan para sa mga server deployment). Ginagamit ng HTTP mode ang Events API + Interactivity + Slash Commands na may iisang shared request URL.

Setup (HTTP mode)

  1. Gumawa ng Slack app at i-disable ang Socket Mode (opsyonal kung HTTP lang ang gagamitin).
  2. Basic Information → kopyahin ang Signing Secret.
  3. OAuth & Permissions → i-install ang app at kopyahin ang Bot User OAuth Token (xoxb-...).
  4. Event Subscriptions → i-enable ang events at itakda ang Request URL sa webhook path ng iyong gateway (default /slack/events).
  5. Interactivity & Shortcuts → i-enable at itakda ang parehong Request URL.
  6. Slash Commands → itakda ang parehong Request URL para sa iyong mga command.

Halimbawang request URL: https://gateway-host/slack/events

OpenClaw config (minimal)

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

Multi-account HTTP mode: set channels.slack.accounts.<id>.mode = "http" and provide a unique webhookPath per account so each Slack app can point to its own URL.

Manifest (opsyonal)

Use this Slack app manifest to create the app quickly (adjust the name/command if you want). Include the user scopes if you plan to configure a user token.

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": false
    },
    "app_home": {
      "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": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "groups:read",
        "groups:write",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "users:read",
        "app_mentions:read",
        "reactions:read",
        "reactions:write",
        "pins:read",
        "pins:write",
        "emoji:read",
        "commands",
        "files:read",
        "files:write"
      ],
      "user": [
        "channels:history",
        "channels:read",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "users:read",
        "reactions:read",
        "pins:read",
        "emoji:read",
        "search:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "reaction_added",
        "reaction_removed",
        "member_joined_channel",
        "member_left_channel",
        "channel_rename",
        "pin_added",
        "pin_removed"
      ]
    }
  }
}

If you enable native commands, add one slash_commands entry per command you want to expose (matching the /help list). Override with channels.slack.commands.native.

Scopes (kasalukuyan vs opsyonal)

Slack's Conversations API is type-scoped: you only need the scopes for the conversation types you actually touch (channels, groups, im, mpim). See https://docs.slack.dev/apis/web-api/using-the-conversations-api/ for the overview.

Bot token scopes (kinakailangan)

User token scopes (opsyonal, read-only bilang default)

Idagdag ang mga ito sa User Token Scopes kung iko-configure mo ang channels.slack.userToken.

  • 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

Hindi kailangan sa ngayon (ngunit posibleng sa hinaharap)

Config

Slack uses Socket Mode only (no HTTP webhook server). Provide both tokens:

{
  "slack": {
    "enabled": true,
    "botToken": "xoxb-...",
    "appToken": "xapp-...",
    "groupPolicy": "allowlist",
    "dm": {
      "enabled": true,
      "policy": "pairing",
      "allowFrom": ["U123", "U456", "*"],
      "groupEnabled": false,
      "groupChannels": ["G123"],
      "replyToMode": "all"
    },
    "channels": {
      "C123": { "allow": true, "requireMention": true },
      "#general": {
        "allow": true,
        "requireMention": true,
        "users": ["U123"],
        "skills": ["search", "docs"],
        "systemPrompt": "Keep answers short."
      }
    },
    "reactionNotifications": "own",
    "reactionAllowlist": ["U123"],
    "replyToMode": "off",
    "actions": {
      "reactions": true,
      "messages": true,
      "pins": true,
      "memberInfo": true,
      "emojiList": true
    },
    "slashCommand": {
      "enabled": true,
      "name": "openclaw",
      "sessionPrefix": "slack:slash",
      "ephemeral": true
    },
    "textChunkLimit": 4000,
    "mediaMaxMb": 20
  }
}

Maaari ring ibigay ang mga token via env vars:

  • SLACK_BOT_TOKEN
  • SLACK_APP_TOKEN

Ang mga ack reaction ay kinokontrol sa buong sistema sa pamamagitan ng messages.ackReaction + messages.ackReactionScope. Use messages.removeAckAfterReply to clear the ack reaction after the bot replies.

Limits

  • Ang outbound text ay hina-hati sa channels.slack.textChunkLimit (default 4000).
  • Opsyonal na newline chunking: itakda ang channels.slack.chunkMode="newline" para hatiin sa mga blank line (mga hangganan ng talata) bago ang length chunking.
  • Ang media uploads ay may limit na channels.slack.mediaMaxMb (default 20).

Reply threading

Bilang default, sumasagot ang OpenClaw sa pangunahing channel. Gamitin ang channels.slack.replyToMode upang kontrolin ang awtomatikong threading:

Mode Behavior
off Default. Reply in main channel. Mag-thread lamang kung ang nag-trigger na mensahe ay nasa isang thread na.
first Ang unang sagot ay papunta sa thread (sa ilalim ng nag-trigger na mensahe), ang mga kasunod na sagot ay papunta sa pangunahing channel. Kapaki-pakinabang para mapanatiling nakikita ang konteksto habang iniiwasan ang kalat ng mga thread.
all Lahat ng sagot ay papunta sa thread. Keeps conversations contained but may reduce visibility.

Nalalapat ang mode sa parehong auto-replies at agent tool calls (slack sendMessage).

Per-chat-type threading

Maaari kang mag-configure ng magkakaibang threading behavior kada uri ng chat sa pamamagitan ng pagtatakda ng channels.slack.replyToModeByChatType:

{
  channels: {
    slack: {
      replyToMode: "off", // default for channels
      replyToModeByChatType: {
        direct: "all", // DMs always thread
        group: "first", // group DMs/MPIM thread first reply
      },
    },
  },
}

Mga sinusuportahang chat type:

  • direct: 1:1 DMs (Slack im)
  • group: group DMs / MPIMs (Slack mpim)
  • channel: standard channels (public/private)

Precedence:

  1. replyToModeByChatType.<chatType>
  2. replyToMode
  3. Provider default (off)

Ang legacy na channels.slack.dm.replyToMode ay tinatanggap pa rin bilang fallback para sa direct kapag walang chat-type override na nakatakda.

Mga halimbawa:

I-thread ang DMs lang:

{
  channels: {
    slack: {
      replyToMode: "off",
      replyToModeByChatType: { direct: "all" },
    },
  },
}

I-thread ang group DMs pero panatilihin ang channels sa root:

{
  channels: {
    slack: {
      replyToMode: "off",
      replyToModeByChatType: { group: "first" },
    },
  },
}

Gawing thread ang channels, panatilihin ang DMs sa root:

{
  channels: {
    slack: {
      replyToMode: "first",
      replyToModeByChatType: { direct: "off", group: "off" },
    },
  },
}

Manual threading tags

Para sa mas detalyadong kontrol, gamitin ang mga tag na ito sa mga response ng agent:

  • [[reply_to_current]] — mag-reply sa nag-trigger na mensahe (simulan/ipagpatuloy ang thread).
  • [[reply_to:<id>]] — mag-reply sa isang partikular na message id.

Sessions + routing

  • Ang DMs ay nagbabahagi ng main session (tulad ng WhatsApp/Telegram).
  • Ang mga channel ay tumutugma sa agent:<agentId>:slack:channel:<channelId> sessions.
  • Ang Slash commands ay gumagamit ng agent:<agentId>:slack:slash:<userId> sessions (maaaring i-configure ang prefix via channels.slack.slashCommand.sessionPrefix).
  • Kung hindi ibinigay ng Slack ang channel_type, ini-infer ito ng OpenClaw mula sa channel ID prefix (D, C, G) at nagde-default sa channel para panatilihing stable ang mga session key.
  • Ang native command registration ay gumagamit ng commands.native (global default "auto" → naka-off ang Slack) at maaaring i-override kada workspace gamit ang channels.slack.commands.native. Text commands require standalone /... messages and can be disabled with commands.text: false. Ang mga Slack slash command ay pinamamahalaan sa Slack app at hindi awtomatikong inaalis. Gamitin ang commands.useAccessGroups: false upang lampasan ang mga access-group check para sa mga command.
  • Buong listahan ng command + config: Slash commands

DM security (pairing)

  • Default: channels.slack.dm.policy="pairing" — ang mga hindi kilalang DM sender ay nakakakuha ng pairing code (nag-e-expire pagkalipas ng 1 oras).
  • I-approve via: openclaw pairing approve slack <code>.
  • Para payagan ang kahit sino: itakda ang channels.slack.dm.policy="open" at channels.slack.dm.allowFrom=["*"].
  • channels.slack.dm.allowFrom accepts user IDs, @handles, or emails (resolved at startup when tokens allow). The wizard accepts usernames and resolves them to ids during setup when tokens allow.

Group policy

  • Kinokontrol ng channels.slack.groupPolicy ang paghawak sa channel (open|disabled|allowlist).
  • Ang allowlist ay nangangailangan na mailista ang mga channel sa channels.slack.channels.
  • If you only set SLACK_BOT_TOKEN/SLACK_APP_TOKEN and never create a channels.slack section, the runtime defaults groupPolicy to open. Add channels.slack.groupPolicy, channels.defaults.groupPolicy, or a channel allowlist to lock it down.
  • Tumatanggap ang configure wizard ng mga pangalan ng #channel at nire-resolve ang mga ito sa mga ID kapag posible (public + private); kung may maraming tugma, mas pinipili ang aktibong channel.
  • Sa startup, nire-resolve ng OpenClaw ang mga pangalan ng channel/user sa mga allowlist papunta sa mga ID (kapag pinapayagan ng mga token) at nilo-log ang mapping; ang mga hindi na-resolve na entry ay pinananatili ayon sa pagkakatype.
  • Para payagan ang walang channel, itakda ang channels.slack.groupPolicy: "disabled" (o panatilihing walang laman ang allowlist).

Channel options (channels.slack.channels.<id> or channels.slack.channels.<name>):

  • allow: payagan/itanggi ang channel kapag groupPolicy="allowlist".
  • requireMention: mention gating para sa channel.
  • tools: opsyonal na per-channel tool policy overrides (allow/deny/alsoAllow).
  • toolsBySender: opsyonal na per-sender tool policy overrides sa loob ng channel (ang mga key ay sender ids/@handle/email; suportado ang "*" wildcard).
  • allowBots: payagan ang mga mensaheng authored ng bot sa channel na ito (default: false).
  • users: opsyonal na per-channel user allowlist.
  • skills: skill filter (omit = lahat ng skills, empty = wala).
  • systemPrompt: karagdagang system prompt para sa channel (pinagsasama sa topic/purpose).
  • enabled: itakda ang false para i-disable ang channel.

Delivery targets

Gamitin ang mga ito sa cron/CLI sends:

  • user:<id> para sa DMs
  • channel:<id> para sa mga channel

Tool actions

Maaaring i-gate ang mga Slack tool actions gamit ang channels.slack.actions.*:

Action group Default Mga tala
reactions enabled React + list reactions
messages enabled Basa/padala/edit/delete
pins enabled Pin/unpin/list
memberInfo enabled Impormasyon ng miyembro
emojiList enabled Listahan ng custom emoji

Mga tala sa seguridad

  • Ang writes ay nagde-default sa bot token para manatiling naka-scope ang mga aksyong nagbabago ng state sa mga permiso at identidad ng bot ng app.
  • Ang pagtatakda ng userTokenReadOnly: false ay nagpapahintulot na magamit ang user token para sa mga write operation kapag walang bot token, na nangangahulugang ang mga aksyon ay tumatakbo gamit ang access ng installing user. Ituring ang user token bilang lubhang pribilehiyado at panatilihing mahigpit ang mga action gate at allowlist.
  • Kung i-enable mo ang user-token writes, siguraduhing kasama sa user token ang mga write scopes na inaasahan mo (chat:write, reactions:write, pins:write, files:write) kung hindi ay mabibigo ang mga operasyong iyon.

Pag-troubleshoot

Patakbuhin muna ang ladder na ito:

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

Pagkatapos ay kumpirmahin ang DM pairing state kung kinakailangan:

openclaw pairing list slack

Mga karaniwang pagkabigo:

  • Nakakonekta ngunit walang reply sa channel: naka-block ang channel ng groupPolicy o wala sa channels.slack.channels allowlist.
  • Hindi pinapansin ang DMs: hindi aprubado ang sender kapag channels.slack.dm.policy="pairing".
  • Mga API error (missing_scope, not_in_channel, mga auth failure): kulang o mali ang bot/app tokens o Slack scopes.

Para sa triage flow: /channels/troubleshooting.

Mga tala

  • Ang mention gating ay kinokontrol via channels.slack.channels (itakda ang requireMention sa true); ang agents.list[].groupChat.mentionPatterns (o messages.groupChat.mentionPatterns) ay binibilang din bilang mentions.
  • Multi-agent override: magtakda ng per-agent patterns sa agents.list[].groupChat.mentionPatterns.
  • Ang reaction notifications ay sumusunod sa channels.slack.reactionNotifications (gamitin ang reactionAllowlist na may mode na allowlist).
  • Bot-authored messages are ignored by default; enable via channels.slack.allowBots or channels.slack.channels.<id>.allowBots.
  • Warning: If you allow replies to other bots (channels.slack.allowBots=true or channels.slack.channels.<id>.allowBots=true), prevent bot-to-bot reply loops with requireMention, channels.slack.channels.<id>.users allowlist, at/o malinaw na mga guardrail sa AGENTS.md at SOUL.md.
  • Para sa Slack tool, ang semantics ng reaction removal ay nasa /tools/reactions.
  • Ang mga attachment ay dina-download sa media store kapag pinahihintulutan at nasa ilalim ng size limit.
veiseule.ai — Community translations maintained by John Kelly. Improve translations on Crowdin.