OpenClawSlack工作区怎么接入 OpenClaw团队协作通道搭建指南方法实战案例|Duuu笔记
Slack工作区未与OpenClaw通信,主因是App创建不全、权限缺失或网关未启动;需通过五种方式之一完成接入:一、Slack开发者平台创建App并启用Socket Mode;二、配置Bot Token必要权限范围;三、订阅关键事件并验证网关连接;四、使用配对码轻量接入;五、阿里云镜像一键注入Slack参数。
如果您已完成 OpenClaw 的本地或云端部署,但 Slack 工作区尚未与 OpenClaw 建立通信连接,则可能是由于 Slack App 创建不完整、权限缺失或网关未启动所致。以下是接入 Slack 工作区的多种方法:
一、通过 Slack 官方开发者平台创建 App 并启用 Socket Mode
该方法适用于拥有 Slack 工作区管理权限的用户,可完全自主控制 App 配置与权限范围,确保事件推送与响应链路稳定可靠。
1、访问
https://api.slack.com/apps
,点击右上角 Create New App → 选择 From scratch。
2、输入 App Name(如 OpenClaw-TeamBot),在 Workspace 下拉菜单中选择目标 Slack 工作区。
3、进入 Settings → Socket Mode,开启 Enable Socket Mode 开关。
4、在弹出对话框中为 Token 命名(如
openclaw
-gateway-token),点击 Generate,复制以
xapp-
开头的 App-Level Token 并安全保存。
二、配置必需的 Bot Token 权限范围(Scopes)
缺少关键权限将导致 OpenClaw 在接收消息后无法回复或上传文件,所有权限必须在 OAuth & Permissions 页面中显式添加,不可跳过。
1、进入 Features → OAuth & Permissions → Bot Token Scopes → Add an OAuth Scope。
2、依次添加以下权限:
app_mentions:read
、
channels:history
、
groups:history
、
im:history
、
chat:write
、
files:write
。
3、完成添加后,点击页面右上角 Install to Workspace,授权安装至当前工作区。
三、订阅关键事件类型并验证网关连接
Slack 只有在明确被告知需监听哪些事件时,才会向 OpenClaw Gateway 推送消息;未订阅对应事件将导致机器人静默无响应。
1、进入 Features → Event Subscriptions,开启 Enable Events 开关。
2、在 Subscribe to bot events 区域,添加以下三项:
app_mention
、
message.im
、
message.channels
。
Sheet+
Excel和GoogleSheets表格AI处理工具
下载
3、返回终端,执行
openclaw gateway status
确认服务运行中;若未运行,执行
openclaw gateway start
启动。
4、在 Slack 工作区任意频道中 @ 机器人发送任意文本,观察终端是否输出「连接成功」及事件日志。
四、使用配对码方式完成轻量级快速接入
当已部署 OpenClaw 且 gateway 服务处于运行状态时,该方法无需手动配置 Token 或权限,由系统自动生成临时配对凭证,适合测试环境或临时协作场景。
1、在终端中执行
openclaw gateway pair
,获取 6 位数字配对码。
2、打开 Slack 客户端,在任意频道中向机器人发送消息:
/openclaw pair 123456
(替换为实际配对码)。
3、等待终端提示「配对完成」,随后在 Slack 中发送 @bot 测试消息,确认机器人正常响应。
五、通过阿里云镜像一键完成 Slack 参数注入
针对使用阿里云轻量应用服务器部署 OpenClaw 的用户,该方法利用预置脚本自动填充 Slack 凭证,避免手动编辑配置文件出错,特别适配海外节点直连 Slack 的网络环境。
1、登录阿里云控制台,进入已部署 OpenClaw 的 Lighthouse 实例远程终端。
2、执行
openclaw config
,选择渠道为 Slack,进入交互式配置流程。
3、按提示依次填入:
App-Level Token(xapp-...)
、
Bot User OAuth Token(xoxb-...)
、
Workspace ID
。
4、配置完成后,系统自动重启 gateway 服务,并在终端输出「Slack channel linked」提示。
