Slack

​

トランスポートの選択

​

リレーモード

{
  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 を使用します。これはオブジェクト上書きであるため、そのアカウントに必要なすべてのソケット調整フィールドを含めてください。
• OpenClaw のデフォルトがあるのは clientPingTimeout（15000）のみです。serverPingTimeout と pingPongLoggingEnabled は、設定された場合にのみ Slack SDK に渡されます。
• Socket Mode の再起動バックオフは約 2 秒から始まり、約 30 秒で上限に達します。回復可能な起動、起動待機、切断の失敗は、チャンネルが停止するまで再試行されます。無効な認証、取り消されたトークン、スコープ不足などの恒久的なアカウントおよび認証情報エラーは、永久に再試行せず、すぐに失敗します。

​

マニフェストとスコープのチェックリスト

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

​

追加のマニフェスト設定

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "新しいセッションを開始",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "現在のセッションをリセット"
    },
    {
      "command": "/compact",
      "description": "セッションコンテキストを圧縮",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "現在の実行を停止"
    },
    {
      "command": "/session",
      "description": "スレッドバインディングの有効期限を管理",
      "usage_hint": "idle <duration|off> または max-age <duration|off>"
    },
    {
      "command": "/think",
      "description": "思考レベルを設定",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "詳細出力を切り替え",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "高速モードを表示または設定",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "推論の可視性を切り替え",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "昇格モードを切り替え",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "exec のデフォルトを表示または設定",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/approve",
      "description": "保留中の承認リクエストを承認または拒否",
      "usage_hint": "<id> <decision>"
    },
    {
      "command": "/model",
      "description": "モデルを表示または設定",
      "usage_hint": "[name|#|status]"
    },
    {
      "command": "/models",
      "description": "プロバイダー/モデルを一覧表示",
      "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
    },
    {
      "command": "/help",
      "description": "短いヘルプ概要を表示"
    },
    {
      "command": "/commands",
      "description": "生成されたコマンドカタログを表示"
    },
    {
      "command": "/tools",
      "description": "現在のエージェントが今すぐ使用できるものを表示",
      "usage_hint": "[compact|verbose]"
    },
    {
      "command": "/agentstatus",
      "description": "利用可能な場合はプロバイダー使用状況/クォータを含むランタイム状態を表示"
    },
    {
      "command": "/tasks",
      "description": "現在のセッションのアクティブ/最近のバックグラウンドタスクを一覧表示"
    },
    {
      "command": "/context",
      "description": "コンテキストの組み立て方法を説明",
      "usage_hint": "[list|detail|json]"
    },
    {
      "command": "/whoami",
      "description": "送信者 ID を表示"
    },
    {
      "command": "/skill",
      "description": "名前で Skills を実行",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "セッションコンテキストを変更せずに補足の質問をする",
      "usage_hint": "<question>"
    },
    {
      "command": "/side",
      "description": "セッションコンテキストを変更せずに補足の質問をする",
      "usage_hint": "<question>"
    },
    {
      "command": "/usage",
      "description": "使用量フッターを制御するか、コスト概要を表示",
      "usage_hint": "off|tokens|full|cost"
    }
  ]
}

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "新しいセッションを開始",
      "usage_hint": "[model]",
      "url": "https://gateway-host.example.com/slack/events"
    },
    {
      "command": "/help",
      "description": "短いヘルプ概要を表示",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

​

トークンモデル

• Socket Mode には botToken + appToken が必要です。
• HTTP モードには botToken + signingSecret が必要です。
• リレーモードには botToken に加えて relay.url、relay.authToken、relay.gatewayId が必要です。アプリトークンや署名シークレットは使用しません。
• botToken、appToken、signingSecret、relay.authToken、userToken はプレーンテキスト文字列または SecretRef オブジェクトを受け入れます。
• 設定トークンは env フォールバックを上書きします。
• SLACK_BOT_TOKEN、SLACK_APP_TOKEN、SLACK_USER_TOKEN の env フォールバックは、それぞれデフォルトアカウントにのみ適用されます。
• userToken はデフォルトで読み取り専用の動作（userTokenReadOnly: true）になります。

• Slack アカウント検査は、認証情報ごとの *Source フィールドと *Status フィールド（botToken、appToken、signingSecret、userToken）を追跡します。
• 状態は available、configured_unavailable、または missing です。
• configured_unavailable は、アカウントが SecretRef または別の非インラインシークレットソースを通じて設定されているが、現在のコマンド/ランタイムパスで 実際の値を解決できなかったことを意味します。
• HTTP モードでは signingSecretStatus が含まれます。Socket Mode では、 必須ペアは botTokenStatus + appTokenStatus です。

​

アクションとゲート

​

アクセス制御とルーティング

{
  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 に加えて、channel:C12345678、user:U12345678、<@U12345678> などの Slack ターゲット形式を受け入れます。
• デフォルトの session.dmScope=main では、Slack DM はエージェントのメインセッションに集約されます。
• チャンネルセッション: agent:<agentId>:slack:channel:<channelId>。
• 通常のトップレベルのチャンネルメッセージは、replyToMode が off 以外の場合でも、チャンネルごとのセッションに残ります。
• Slack スレッド返信では、replyToMode="off" でアウトバウンド返信スレッド化が無効な場合でも、親 Slack thread_ts がセッションサフィックス (:thread:<threadTs>) に使われます。
• OpenClaw は、対象のトップレベルチャンネルルートが表示される Slack スレッドを開始すると予想される場合、そのルートを agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> にシードします。これにより、ルートと後続のスレッド返信が 1 つの OpenClaw セッションを共有します。これは、app_mention イベント、明示的なボットメンションまたは設定済みメンションパターン一致、および replyToMode が off 以外の 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
• エージェント ID の絵文字フォールバック (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 に設定します (デフォルト: 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 の従来ランタイムエイリアスです。
• boolean 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 の従来ランタイムエイリアスです。
• 永続化された Slack ストリーミング設定を正規キーに書き換えるには、openclaw doctor --fix を実行します。

​

入力中リアクションフォールバック

• 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 は無効なブロックペイロードを送信する代わりに元のテキスト返信へフォールバックします。

​

Plugin 所有のモーダル送信

• callback_id を openclaw:<namespace>:<payload> に設定します。
• または、既存の callback_id を維持し、モーダルの private_metadata に pluginInteractiveData: "<namespace>:<payload>" を入れます。

​

Slack のネイティブ承認

• Exec と Plugin の承認は Slack ネイティブの Block Kit プロンプトとしてレンダリングできます。
• channels.slack.execApprovals.* は、ネイティブ exec 承認クライアントの有効化と DM/チャンネルのルーティング設定として残ります。
• Exec 承認 DM は channels.slack.execApprovals.approvers または commands.ownerAllowFrom を使用します。
• Plugin 承認は、Slack が発生元セッションのネイティブ承認クライアントとして有効な場合、または approvals.plugin が発生元の Slack セッションまたは Slack ターゲットへルーティングする場合に、Slack ネイティブボタンを使用します。
• Plugin 承認 DM は、channels.slack.allowFrom、名前付きアカウントの allowFrom、またはアカウントの既定ルートからの Slack Plugin 承認者を使用します。
• 承認者の認可は引き続き適用されます。exec 専用承認者は、Plugin 承認者でもない限り、Plugin リクエストを承認できません。

• 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」スレッド返信）は通常のユーザーメッセージとして処理されます。
• リアクション追加/削除イベントはシステムイベントにマッピングされます。
• メンバー参加/退出、チャンネル作成/名前変更、ピン追加/削除イベントはシステムイベントにマッピングされます。
• channel_id_changed は、configWrites が有効な場合にチャンネル設定キーを移行できます。
• チャンネルトピック/目的メタデータは信頼できないコンテキストとして扱われ、ルーティングコンテキストに注入される場合があります。
• スレッド開始者と初期スレッド履歴コンテキストのシードは、該当する場合、設定済み送信者許可リストでフィルタリングされます。
• ブロックアクション、ショートカット、モーダルインタラクションは、豊富なペイロードフィールドを持つ構造化された Slack interaction: ... システムイベントを発行します。
  • ブロックアクション: 選択値、ラベル、ピッカー値、workflow_* メタデータ
  • グローバルショートカット: コールバックとアクターのメタデータ。アクターの直接セッションへルーティング
  • メッセージショートカット: コールバック、アクター、チャンネル、スレッド、選択されたメッセージのコンテキスト
  • ルーティングされたチャンネルメタデータとフォーム入力を含むモーダル view_submission と view_closed イベント

​

設定リファレンス

​

トラブルシューティング

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

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

openclaw pairing list slack

​

添付ファイルの vision リファレンス

​

対応メディアタイプ

​

Inbound パイプライン

1. OpenClaw は bot トークンを使用して Slack のプライベート URL からファイルをダウンロードします。
2. 成功すると、ファイルはメディアストアに書き込まれます。
3. ダウンロードされたメディアパスとコンテンツタイプが inbound コンテキストに追加されます。
4. 画像対応のモデル/ツールパスは、そのコンテキストの画像添付を使用できます。
5. 画像以外のファイルは、それらを処理できるツール向けにファイルメタデータまたはメディア参照として利用可能なままです。

​

スレッドルート添付ファイルの継承

• 返信自体に直接メディアがなく、含まれているルートメッセージにファイルがある場合、Slack はルートファイルをスレッド開始コンテキストとしてハイドレートできます。
• ルートファイルは、新規またはリセットされたスレッドセッションをシードしている間だけハイドレートされます。以降のテキストのみの返信は既存のセッションコンテキストを再利用し、ルートファイルを新しいメディアとして再添付しません。
• 直接返信の添付ファイルはルートメッセージの添付ファイルより優先されます。
• ファイルのみでテキストがないルートメッセージは、フォールバックがそのファイルを引き続き含められるように、添付ファイルプレースホルダーで表現されます。

​

複数添付ファイルの処理

• 各添付ファイルはメディアパイプラインを通じて個別に処理されます。
• ダウンロードされたメディア参照はメッセージコンテキストに集約されます。
• 処理順序はイベントペイロード内の Slack のファイル順に従います。
• 1 つの添付ファイルのダウンロード失敗が他の添付ファイルをブロックすることはありません。

​

サイズ、ダウンロード、モデルの制限

• サイズ上限: デフォルトはファイルあたり 20 MB です。channels.slack.mediaMaxMb で設定できます。
• ダウンロード失敗: Slack が提供できないファイル、期限切れ URL、アクセスできないファイル、サイズ超過ファイル、Slack 認証/ログイン HTML レスポンスは、未対応形式として報告されるのではなくスキップされます。
• Vision モデル: 画像分析は、vision に対応している場合は有効な返信モデルを使用し、そうでない場合は agents.defaults.imageModel に設定された画像モデルを使用します。

​

既知の制限

​

関連ドキュメント

• メディア理解パイプライン
• PDF ツール

​

関連