O
OpenClaw

Slack 接入

将 OpenClaw 接入 Slack 工作区,让团队成员在频道中直接与 AI 助手协作。

创建 Slack App

1. 创建应用

  1. 访问 Slack API
  2. 点击 "Create New App"
  3. 选择 "From scratch"
  4. 输入应用名称(如:OpenClaw Bot)
  5. 选择要安装的工作区

2. 配置权限

在左侧菜单选择 "OAuth & Permissions",添加以下 Bot Token Scopes:

  • chat:write - 发送消息
  • chat:write.public - 在公共频道发送消息
  • app_mentions:read - 读取 @提及
  • im:history - 读取私信历史
  • im:read - 查看私信
  • im:write - 发送私信

3. 安装应用到工作区

  1. 在 "OAuth & Permissions" 页面,点击 "Install to Workspace"
  2. 确认权限并安装
  3. 复制 "Bot User OAuth Token"(以 xoxb- 开头)

4. 启用事件订阅(可选)

如果要让 Bot 主动响应消息(而非仅通过 @提及):

  1. 开启 "Enable Events"
  2. 配置 Request URL(需要公网可访问的服务器)
  3. 订阅 "message.channels" 和 "message.im" 事件

配置 OpenClaw

编辑配置文件 ~/.openclaw/openclaw.json

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-your-bot-token",
      "allowFrom": ["U1234567890"],
      "workspaces": {
        "*": {
          "requireMention": true,
          "allowedChannels": ["general", "ai-chat"]
        }
      }
    }
  }
}

配置说明

选项说明
botTokenBot User OAuth Token(xoxb-开头)
allowFrom允许的 Slack 用户 ID 列表
workspaces.*.requireMention是否需要 @Bot 才响应
workspaces.*.allowedChannels允许使用的频道名称列表

获取用户 ID

  1. 在 Slack 中点击自己的头像
  2. 选择 "View profile"
  3. 点击 "More"(三个点)
  4. 选择 "Copy member ID"

邀请 Bot 到频道

在频道中发送:

/invite @你的Bot名称

测试

openclaw gateway restart

在 Slack 频道中 @提及 Bot 或发送私信测试。

进阶:Slash Commands

你可以配置 Slack Slash Commands,让用户通过 /命令 快速调用特定功能。

在 Slack API 的 "Slash Commands" 页面添加命令,指向你的 Gateway 地址。