Slack 频道配置

Slack 适合企业和团队协作场景。OpenClaw 使用 Socket Mode（WebSocket）接入 Slack，不需要公网 URL，部署更简单。

预计耗时

完成全部配置约需 25-40 分钟，主要时间花在 Slack App 的权限配置上。

第一步：创建 Slack App

1. 打开 Slack API，点击 Create New App
2. 选择 From scratch
3. 输入 App 名称（如 OpenClaw Bot），选择目标 Workspace
4. 点击 Create App

第二步：启用 Socket Mode

1. 在左侧导航栏，进入 Settings → Socket Mode
2. 开启 Enable Socket Mode
3. 系统会提示你创建一个 App-Level Token，输入名称（如 openclaw-socket）
4. 添加 connections:write scope
5. 点击 Generate，获取 App-Level Token（以 xapp- 开头），妥善保存

保存 Token

xapp- 开头的 App-Level Token 仅在创建时显示一次，请立即复制保存。

第三步：配置 Bot Token Scopes

1. 进入 Features → OAuth & Permissions
2. 在 Bot Token Scopes 区域，添加以下权限：

Scope	用途
chat:write	发送消息
channels:history	读取公共频道消息历史
channels:read	查看公共频道信息
im:write	发送私信
im:history	读取私信历史
im:read	查看私信信息
users:read	获取用户信息
reactions:read	读取消息回应
reactions:write	添加消息回应
files:write	上传文件

第四步：安装到 Workspace

1. 在 OAuth & Permissions 页面顶部，点击 Install to Workspace
2. 在授权页面点击 Allow
3. 获取 Bot User OAuth Token（以 xoxb- 开头），妥善保存

第五步：启用事件订阅

1. 进入 Features → Event Subscriptions
2. 开启 Enable Events
3. 在 Subscribe to bot events 中添加：
   • message.channels — 接收公共频道消息
   • message.im — 接收私信

第六步：配置 OpenClaw

将获取的 Token 写入 openclaw.yaml：

channels:
  slack:
    enabled: true
    appToken: "xapp-1-A0xxxxxxxxx-xxxxxxxxxx-xxxxxxxx"   # App-Level Token
    botToken: "xoxb-xxxxxxxxx-xxxxxxxxx-xxxxxxxxxxxx"     # Bot User OAuth Token

或通过命令行登录：

openclaw channels login slack

系统会依次提示输入 App-Level Token 和 Bot User OAuth Token。

第七步：启动 Gateway 并验证

openclaw start

在 Slack 中向 Bot 发送一条消息，确认能收到回复。

邀请 Bot 到频道

Bot 不会自动出现在频道中。你需要在目标频道中输入 /invite @OpenClaw Bot，或在频道设置中手动添加 Bot。

配置选项

配置项	说明	默认值
allowedChannels	允许 Bot 响应的频道 ID 列表	所有频道
allowedUsers	允许对话的用户 ID 白名单	所有人
systemPrompt	该频道专用的系统提示词	全局默认
model	该频道使用的 AI 模型	全局默认

部署建议

多人环境部署

在团队环境中，建议不要在主力开发机器上运行 Gateway。推荐使用：

• 专用虚拟机（VM）
• 容器化部署（Docker）
• 云服务器

这样可以避免 Gateway 进程被意外终止，同时不影响日常开发工作。

常见问题

Bot 没有响应消息？

1. 确认 Socket Mode 已开启
2. 检查两个 Token 是否正确配置：openclaw channels list
3. 确认 Bot 已被邀请到对应频道
4. 查看日志排查错误：openclaw logs

收到 missing_scope 错误？

返回 Slack App 配置页面，检查 Bot Token Scopes 是否完整添加了上述所有权限。添加新权限后需要重新安装 App 到 Workspace。