Slack

​

選擇傳輸方式

​

Relay 模式

{
  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",
      },
    },
  },
}

​

安裝

openclaw plugins install @openclaw/slack

​

快速設定

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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": "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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": "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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": "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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

​

Socket Mode 傳輸調校

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

• socketMode 在 HTTP Request URL 模式中會被忽略。
• 基礎 channels.slack.socketMode 設定會套用到所有 Slack 帳號，除非被覆寫。個別帳號覆寫使用 channels.slack.accounts.<accountId>.socketMode；因為這是物件覆寫，請包含該帳號所需的每個 socket 調校欄位。
• 只有 clientPingTimeout 有 OpenClaw 預設值（15000）。serverPingTimeout 和 pingPongLoggingEnabled 只有在已設定時才會傳給 Slack SDK。
• Socket Mode 重新啟動退避大約從 2 秒開始，並在大約 30 秒封頂。可復原的啟動、等待啟動與斷線失敗會持續重試，直到頻道停止。永久性的帳號與憑證錯誤，例如驗證無效、token 已撤銷或缺少 scope，會快速失敗，而不是永遠重試。

​

Manifest 與 scope 檢查清單

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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": "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",
        "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"
    }
  }
}

​

其他 manifest 設定

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

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

​

Token 模型

• Socket Mode 需要 botToken + appToken。
• HTTP 模式需要 botToken + signingSecret。
• Relay 模式需要 botToken 加上 relay.url、relay.authToken 和 relay.gatewayId；它不使用 app token 或 signing secret。
• botToken、appToken、signingSecret、relay.authToken 和 userToken 接受純文字 字串或 SecretRef 物件。
• 設定 token 會覆寫 env fallback。
• SLACK_BOT_TOKEN、SLACK_APP_TOKEN 和 SLACK_USER_TOKEN env fallback 各自只套用到預設帳號。
• userToken 預設為唯讀行為（userTokenReadOnly: true）。

• Slack 帳號檢查會追蹤每個憑證的 *Source 和 *Status 欄位（botToken、appToken、signingSecret、userToken）。
• 狀態為 available、configured_unavailable 或 missing。
• configured_unavailable 表示帳號是透過 SecretRef 或其他非行內 secret 來源設定，但目前的命令/執行階段路徑 無法解析實際值。
• 在 HTTP 模式中會包含 signingSecretStatus；在 Socket Mode 中， 必要組合為 botTokenStatus + appTokenStatus。

​

Actions 與 gates

​

存取控制與路由

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

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

​

執行緒、工作階段與回覆標籤

• DM 會路由為 direct；頻道為 channel；MPIM 為 group。
• Slack 路由繫結接受原始對等 ID，以及 Slack 目標格式，例如 channel:C12345678、user:U12345678 和 <@U12345678>。
• 使用預設 session.dmScope=main 時，Slack DM 會合併到代理主工作階段。
• 頻道工作階段：agent:<agentId>:slack:channel:<channelId>。
• 一般頂層頻道訊息會留在各頻道工作階段上，即使 replyToMode 不是 off。
• Slack 執行緒回覆會使用父層 Slack thread_ts 作為工作階段後綴（:thread:<threadTs>），即使已用 replyToMode="off" 停用外送回覆執行緒化。
• 當符合資格的頂層頻道根訊息預期會開始可見的 Slack 執行緒時，OpenClaw 會將其植入 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>，讓根訊息與後續執行緒回覆共用同一個 OpenClaw 工作階段。這適用於 app_mention 事件、明確的機器人或已設定提及模式相符項，以及具有非 off replyToMode 的 requireMention: false 頻道。
• channels.slack.thread.historyScope 預設為 thread；thread.inheritParent 預設為 false。
• channels.slack.thread.initialHistoryLimit 控制新執行緒工作階段開始時要擷取多少既有執行緒訊息（預設 20；設為 0 可停用）。
• channels.slack.thread.requireExplicitMention（預設 false）：當為 true 時，抑制隱含的執行緒提及，使機器人只回應執行緒內明確的 @bot 提及，即使機器人已參與該執行緒。若未設定此項，已由機器人參與的執行緒中的回覆會繞過 requireMention 門檻。

• channels.slack.channels.<id>.replyToMode：Slack 頻道/私人頻道訊息的各頻道覆寫
• channels.slack.replyToMode：off|first|all|batched（預設 off）
• channels.slack.replyToModeByChatType：依 direct|group|channel 設定
• 直接聊天的舊版後備：channels.slack.dm.replyToMode

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

​

Ack 反應

​

表情符號（ackReaction）

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 代理身分表情符號後備（agents.list[].identity.emoji，否則為 "eyes" / 👀）

• Slack 預期使用短代碼（例如 "eyes"）。
• 使用 "" 可停用 Slack 帳號或全域的反應。

​

範圍（messages.ackReactionScope）

• "all"：在 DM 與群組中反應，包括環境聊天室事件。
• "direct"：只在 DM 中反應。
• "group-all"：對每則群組訊息反應，但不包括環境聊天室事件（不含 DM）。
• "group-mentions"（預設）：在群組中反應，但只有在機器人被提及時（或在選擇加入的群組可提及項中）。不包括 DM。
• "off" / "none"：永不反應。

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // react in DMs and groups
  },
}

​

文字串流

• off：停用即時預覽串流。
• partial（預設）：用最新的部分輸出取代預覽文字。
• block：附加分塊預覽更新。
• progress：產生時顯示進度狀態文字，然後傳送最終文字。
• streaming.preview.toolProgress：當草稿預覽啟用時，將工具/進度更新路由到同一則已編輯的預覽訊息（預設：true）。設為 false 可保留獨立的工具/進度訊息。
• streaming.preview.commandText / streaming.progress.commandText：設為 status 可在隱藏原始 command/exec 文字的同時保留精簡的工具進度列（預設：raw）。

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

• 必須有可用的回覆執行緒，原生文字串流與 Slack 助理執行緒狀態才會顯示。執行緒選擇仍遵循 replyToMode。
• 當原生串流不可用或沒有回覆執行緒時，頻道、群組聊天與頂層 DM 根訊息仍可使用一般草稿預覽。
• 頂層 Slack DM 預設保持非執行緒，因此不會顯示 Slack 執行緒樣式的原生串流/狀態預覽；OpenClaw 會改為在 DM 中張貼並編輯草稿預覽。
• 媒體與非文字承載會退回一般傳遞。
• 媒體/錯誤最終訊息會取消待處理的預覽編輯；符合資格的文字/區塊最終訊息只有在可以就地編輯預覽時才會送出。
• 如果串流在回覆中途失敗，OpenClaw 會針對剩餘承載退回一般傳遞。

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

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

• channels.slack.streamMode（replace | status_final | append）是 channels.slack.streaming.mode 的舊版執行階段別名。
• 布林值 channels.slack.streaming 是 channels.slack.streaming.mode 和 channels.slack.streaming.nativeTransport 的舊版執行階段別名。
• 頂層 channels.slack.chunkMode 和 channels.slack.nativeStreaming 是 channels.slack.streaming.chunkMode 和 channels.slack.streaming.nativeTransport 的舊版執行階段別名。
• 執行 openclaw doctor --fix，將已保存的 Slack 串流設定重寫為標準鍵。

​

輸入中反應後備

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

• Slack 預期使用短代碼（例如 "hourglass_flowing_sand"）。
• 反應採盡力而為，並會在回覆或失敗路徑完成後自動嘗試清理。

​

媒體、分塊與傳遞

​

命令與斜線行為

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

/openclaw /help

• Slack 的原生命令自動模式為關閉，因此 commands.native: "auto" 不會啟用 Slack 原生命令。

/help

• 3-5 個足夠短的選項：溢位（”…”）選單
• 超過 100 個選項，且可使用非同步選項篩選：外部選取
• 1-2 個選項，或任何編碼值太長而無法用於選取的選項：按鈕區塊
• 否則（6-100 個選項，或超過 100 個且沒有非同步篩選）：靜態選取選單，每個選單以 100 個選項分塊

/think

​

互動式回覆

{
  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(...)

• 這是 Slack 專用的舊版 UI。其他頻道不會將 Slack Block Kit 指令轉譯為自己的按鈕系統。
• 互動式回呼值是 OpenClaw 產生的不透明權杖，不是代理撰寫的原始值。
• 如果產生的互動式區塊會超過 Slack Block Kit 限制，OpenClaw 會退回使用原始文字回覆，而不是傳送無效的區塊承載。

​

外掛擁有的互動視窗提交

• 將 callback_id 設為 openclaw:<namespace>:<payload>。
• 或保留現有的 callback_id，並將 pluginInteractiveData: "<namespace>:<payload>" 放在互動視窗 private_metadata 中。

​

Slack 中的原生核准

• Exec 和外掛核准可以呈現為 Slack 原生 Block Kit 提示。
• channels.slack.execApprovals.* 仍是原生 exec 核准用戶端的啟用與 DM/頻道路由設定。
• Exec 核准 DM 使用 channels.slack.execApprovals.approvers 或 commands.ownerAllowFrom。
• 當 Slack 已作為原始工作階段的原生核准用戶端啟用，或 approvals.plugin 路由到原始 Slack 工作階段或 Slack 目標時，外掛核准會使用 Slack 原生按鈕。
• 外掛核准 DM 使用來自 channels.slack.allowFrom、具名帳戶 allowFrom 或帳戶預設路由的 Slack 外掛核准者。
• 仍會強制執行核准者授權：僅限 exec 的核准者不能核准外掛請求，除非他們同時也是外掛核准者。

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers（選用；可行時退回使用 commands.ownerAllowFrom）
• channels.slack.execApprovals.target（dm | channel | both，預設：dm）
• agentFilter, sessionFilter

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

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

​

事件與操作行為

• 訊息編輯/刪除會對應為系統事件。
• 執行緒廣播（“Also send to channel” 執行緒回覆）會作為一般使用者訊息處理。
• 表情回應新增/移除事件會對應為系統事件。
• 成員加入/離開、頻道建立/重新命名，以及釘選新增/移除事件會對應為系統事件。
• 啟用 configWrites 時，channel_id_changed 可以遷移頻道設定鍵。
• 頻道主題/用途中繼資料會被視為不受信任的脈絡，且可注入路由脈絡。
• 適用時，執行緒開頭訊息和初始執行緒歷史脈絡植入會由已設定的寄件者允許清單篩選。
• 區塊動作、捷徑和互動視窗互動會發出結構化的 Slack interaction: ... 系統事件，並帶有豐富承載欄位：
  • 區塊動作：選取值、標籤、選擇器值，以及 workflow_* 中繼資料
  • 全域捷徑：回呼和執行者中繼資料，路由到執行者的直接工作階段
  • 訊息捷徑：回呼、執行者、頻道、執行緒，以及所選訊息脈絡
  • 互動視窗 view_submission 和 view_closed 事件，包含已路由頻道中繼資料和表單輸入

​

設定參考

​

疑難排解

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

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

openclaw pairing list slack

​

附件視覺參考

​

支援的媒體類型

​

入站管線

1. OpenClaw 使用機器人權杖從 Slack 的私有 URL 下載檔案。
2. 檔案在成功時寫入媒體儲存區。
3. 下載的媒體路徑和內容類型會加入入站脈絡。
4. 具備影像能力的模型/工具路徑可以使用該脈絡中的影像附件。
5. 非影像檔案仍可作為檔案中繼資料或媒體參照，供可處理它們的工具使用。

​

執行緒根附件繼承

• 如果回覆本身沒有直接媒體，且包含的根訊息有檔案，Slack 可以將根檔案補齊為執行緒起始脈絡。
• 根檔案只會在建立或重設執行緒工作階段時補齊。後續僅文字回覆會重用既有工作階段脈絡，不會將根檔案作為新媒體重新附加。
• 直接回覆附件優先於根訊息附件。
• 只有檔案且沒有文字的根訊息會以附件預留位置表示，讓後備流程仍可包含其檔案。

​

多附件處理

• 每個附件都會透過媒體管線獨立處理。
• 已下載的媒體參照會彙整到訊息脈絡中。
• 處理順序遵循事件酬載中的 Slack 檔案順序。
• 一個附件下載失敗不會封鎖其他附件。

​

大小、下載與模型限制

• 大小上限：預設每個檔案 20 MB。可透過 channels.slack.mediaMaxMb 設定。
• 下載失敗：Slack 無法提供的檔案、過期 URL、無法存取的檔案、過大的檔案，以及 Slack 驗證/登入 HTML 回應都會被略過，而不是回報為不支援的格式。
• 視覺模型：當目前作用中的回覆模型支援視覺時，影像分析會使用該模型；否則使用 agents.defaults.imageModel 設定的影像模型。

​

已知限制

​

相關文件

• 媒體理解管線
• PDF 工具

​

相關