OpenClaw 接入 Slack：Bot 配置、频道监听与工作区 Agent 路由

OpenClaw 支持 Slack 作为消息频道，让你在工作中随时通过 Slack 与 AI 助手对话，并能将不同频道或用户路由到不同的 Agent。

前置条件#

• 一个 Slack 工作区的管理员权限
• 运行中的 OpenClaw Gateway

第一步：创建 Slack App#

1. 访问 api.slack.com/apps
2. 点击 Create New App -> From scratch
3. 命名（如 OpenClaw）并选择工作区

第二步：配置 Bot 权限#

在 OAuth & Permissions -> Bot Token Scopes 中添加：

第三步：开启 Socket Mode#

在 Socket Mode 页面开启，并生成 App-Level Token（以 xapp- 开头）。这让 OpenClaw 通过 WebSocket 接收事件，无需公开的 Webhook URL。

第四步：开启 Event Subscriptions#

在 Event Subscriptions 中：

1. 开启 Events
2. 在 Subscribe to bot events 中添加：
   • app_mention
   • message.im
   • message.channels（如需频道消息）
   • message.groups（如需私有频道消息）

第五步：将 Bot 安装到工作区#

OAuth & Permissions -> 点击 Install to Workspace -> 获取 Bot User OAuth Token（以 xoxb- 开头）。

第六步：配置 OpenClaw#

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-your-bot-token",
      "appToken": "xapp-your-app-token",
      "dmPolicy": "pairing",
      "workspaces": {
        "YOUR_WORKSPACE_ID": {
          "requireMention": false,
          "users": ["YOUR_USER_ID"]
        }
      }
    }
  }
}

openclaw gateway restart

第七步：完成配对#

在 Slack 中向 Bot 发送私信，Bot 会回复配对码：

openclaw pairing list slack
openclaw pairing approve slack CODE

频道独立会话#

OpenClaw 为每个 Slack 频道创建独立会话，你可以在工作区创建 #coding、#research、#home 等频道，每个频道有独立的对话历史和上下文。

基于频道的 Agent 路由#

{
  "bindings": [
    {
      "agentId": "coding",
      "match": {
        "channel": "slack",
        "workspaceId": "WORKSPACE_ID",
        "channelId": "CODING_CHANNEL_ID"
      }
    },
    {
      "agentId": "main",
      "match": {
        "channel": "slack"
      }
    }
  ]
}

#coding 频道的消息路由到 coding Agent，其他频道路由到 main Agent。

多工作区支持#

{
  "channels": {
    "slack": {
      "accounts": {
        "work": {
          "botToken": "xoxb-work-token",
          "appToken": "xapp-work-token"
        },
        "personal": {
          "botToken": "xoxb-personal-token",
          "appToken": "xapp-personal-token"
        }
      }
    }
  }
}

requireMention 配置#

• requireMention: true（默认）：只响应 @ 了 Bot 的消息
• requireMention: false：响应所有频道消息（适合私人工作区）

常见问题#

Bot 不响应频道消息？检查 Event Subscriptions 中是否添加了 message.channels，以及 Bot 是否加入了该频道。

Socket Mode 连接断开？检查 App-Level Token 是否有效，运行 openclaw gateway restart。

来源：OpenClaw 官方文档 | 整理自 docs.openclaw.ai