教程

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

OpenClaw 接入 Slack 完整教程：创建 Slack App、配置 Bot 权限（9 个必要 Scope）、开启 Socket Mode、Event Subscriptions 配置、OpenClaw 配置字段、频道独立会话、基于频道的 Agent 路由和多工作区支持。

2026/3/13分钟 阅读ClaudeEagle

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 中添加：

app_mentions:read # 读取 @ 提及 chat:write # 发送消息 chat:write.public # 在未加入的公共频道发消息 channels:history # 读取公共频道历史 groups:history # 读取私有频道历史 im:history # 读取 DM 历史 im:read # 读取 DM 元信息 im:write # 在 DM 中发消息 users:read # 读取用户信息

第三步：开启 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

json
{
  "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"]
        }
      }
    }
  }
}
bash
openclaw gateway restart

第七步：完成配对

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

bash
openclaw pairing list slack
openclaw pairing approve slack CODE

频道独立会话

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

基于频道的 Agent 路由

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

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

多工作区支持

json
{
  "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