Slack

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Socket Mode または HTTP Request URLs の選択

​

クイックセットアップ

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > slack.socket.patch.json5 <<'JSON5'
{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
    },
  },
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

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

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
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
      webhookPath: "/slack/events",
    },
  },
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

​

Socket Mode トランスポート調整

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

​

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

​

追加のマニフェスト設定

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

​

トークンモデル

• Socket Mode には botToken + appToken が必要です。
• HTTP モードには botToken + signingSecret が必要です。
• botToken、appToken、signingSecret、userToken はプレーンテキスト 文字列または SecretRef オブジェクトを受け付けます。
• 設定トークンは env フォールバックを上書きします。
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env フォールバックはデフォルトアカウントにのみ適用されます。
• userToken（xoxp-...）は設定専用（env フォールバックなし）で、デフォルトは読み取り専用動作（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 ルートバインディングは、raw ピア ID に加えて、channel:C12345678、user:U12345678、<@U12345678> などの Slack ターゲット形式を受け付けます。
• デフォルトの session.dmScope=main では、Slack DM はエージェントのメインセッションに集約されます。
• チャンネルセッション: agent:<agentId>:slack:channel:<channelId>。
• スレッド返信は、該当する場合にスレッドセッションサフィックス（:thread:<threadTs>）を作成できます。
• OpenClaw が明示的なメンションを要求せずにトップレベルメッセージを処理するチャンネルでは、off 以外の replyToMode により、処理された各 root が agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> にルーティングされるため、表示される Slack スレッドは最初のターンから 1 つの OpenClaw セッションに対応します。
• channels.slack.thread.historyScope のデフォルトは thread です。thread.inheritParent のデフォルトは false です。
• channels.slack.thread.initialHistoryLimit は、新しいスレッドセッション開始時に取得される既存スレッドメッセージ数を制御します（デフォルト 20。無効にするには 0 を設定）。
• channels.slack.thread.requireExplicitMention（デフォルト false）: true の場合、暗黙的なスレッドメンションを抑制し、bot がすでにスレッドに参加している場合でも、スレッド内の明示的な @bot メンションにのみ応答します。これがない場合、bot 参加済みスレッド内の返信は requireMention ゲートをバイパスします。

• 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 リアクション

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• エージェント ID の絵文字フォールバック（agents.list[].identity.emoji、それ以外は ”👀”）

• Slack はショートコード（例: "eyes"）を想定します。
• Slack アカウントまたはグローバルでリアクションを無効にするには "" を使用します。

​

テキストストリーミング

• off: ライブプレビューストリーミングを無効にします。
• partial（デフォルト）: プレビューテキストを最新の部分出力で置き換えます。
• block: チャンク化されたプレビュー更新を追加します。
• progress: 生成中に進行状況テキストを表示し、その後最終テキストを送信します。
• streaming.preview.toolProgress: ドラフトプレビューが有効な場合、ツール/進行状況更新を同じ編集済みプレビューメッセージにルーティングします（デフォルト: true）。別々のツール/進行状況メッセージを維持するには false を設定します。
• streaming.preview.commandText / streaming.progress.commandText: raw command/exec テキストを隠しながらコンパクトなツール進行状況行を維持するには 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.streamMode (replace | status_final | append) は、channels.slack.streaming.mode のレガシーランタイムエイリアスです。
• boolean channels.slack.streaming は、channels.slack.streaming.mode と channels.slack.streaming.nativeTransport のレガシーランタイムエイリアスです。
• レガシー channels.slack.nativeStreaming は、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

• 最大 5 個のオプション: ボタンブロック
• 6〜100 個のオプション: 静的選択メニュー
• 100 個を超えるオプション: インタラクティビティオプションハンドラーが利用可能な場合、非同期オプションフィルタリング付き外部選択
• Slack 制限を超過: エンコードされたオプション値はボタンにフォールバックします

/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]]

• これは Slack 固有の UI です。他のチャンネルは Slack Block Kit ディレクティブを独自のボタンシステムに変換しません。
• インタラクティブコールバック値は、エージェントが作成した生の値ではなく、OpenClaw が生成した不透明トークンです。
• 生成されたインタラクティブブロックが Slack Block Kit の制限を超える場合、OpenClaw は無効なブロックペイロードを送信する代わりに、元のテキスト返信にフォールバックします。

​

Slack での実行承認

• 実行承認はネイティブ DM/チャンネルルーティングに channels.slack.execApprovals.* を使用します。
• Plugin 承認は、リクエストがすでに Slack に届いていて、承認 ID 種別が plugin: の場合、同じ Slack ネイティブボタンサーフェス経由で引き続き解決できます。
• 承認者の認可は引き続き強制されます。承認者として識別されたユーザーだけが Slack 経由でリクエストを承認または拒否できます。

• 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 イベント。ルーティングされたチャンネルメタデータとフォーム入力を含みます

​

設定リファレンス

​

トラブルシューティング

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

openclaw pairing list slack

​

添付ファイルビジョンリファレンス

​

サポートされるメディアタイプ

​

受信パイプライン

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

​

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

• 返信自体に直接メディアがなく、含まれるルートメッセージにファイルがある場合、Slack はルートファイルをスレッド開始コンテキストとしてハイドレートできます。
• 直接返信の添付ファイルは、ルートメッセージの添付ファイルより優先されます。
• ファイルのみでテキストがないルートメッセージは添付ファイルプレースホルダーで表されるため、フォールバックはそのファイルを引き続き含められます。

​

複数添付ファイルの処理

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

​

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

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

​

既知の制限

​

関連ドキュメント

• メディア理解パイプライン
• PDF ツール
• エピック: #51349 — Slack 添付ファイルビジョンの有効化
• 回帰テスト: #51353
• ライブ検証: #51354

​

関連