OpenClaw连接Slack配置完整教程

# OpenClaw连接Slack配置完整教程

## 概述

本教程将详细介绍如何将OpenClaw连接到Slack，让您的AI助手能够在Slack中工作。我们将使用Slack的Socket模式进行配置，这是推荐的方式。

## 前提条件

– 一个Slack工作区（Workspace）
– 具有管理员权限的Slack账户
– 已安装并运行的OpenClaw实例

## 步骤1：创建Slack应用

1. 访问 [Slack API网站](https://api.slack.com/apps) 并点击”Create New App”
2. 选择”From scratch”选项
3. 输入应用名称（例如：”OpenClaw”）
4. 选择要安装应用的工作区

## 步骤2：启用Socket模式

1. 在应用管理面板左侧菜单中，点击”Socket Mode”
2. 将开关切换到”on”状态
3. 系统会提示您添加一个名为`connections:write`的作用域（scope）

## 步骤3：创建App Token

1. 转到”Basic Information” → “App-Level Tokens”
2. 点击”Generate Token and Scopes”
3. 输入令牌名称（例如：”openclaw-token”）
4. 从下拉菜单中选择`connections:write`作用域
5. 点击”Generate”按钮
6. 复制生成的App Token（以`xapp-`开头），稍后配置时需要使用

## 步骤4：配置Bot Token

1. 转到左侧菜单中的”OAuth & Permissions”
2. 在”Bot Token Scopes”部分，添加以下作用域：
– `chat:write` – 发送消息
– `channels:history` – 访问频道历史记录
– `channels:read` – 读取频道信息
– `groups:history` – 访问群组历史记录
– `groups:read` – 读取群组信息
– `im:history` – 访问私信历史记录
– `im:read` – 读取私信
– `im:write` – 发送私信
– `mpim:history` – 访问多人私信历史记录
– `mpim:read` – 读取多人私信
– `mpim:write` – 发送多人私信
– `users:read` – 读取用户信息
– `app_mentions:read` – 读取提及
– `reactions:read` – 读取反应
– `reactions:write` – 添加/删除反应
– `pins:read` – 读取固定消息
– `pins:write` – 固定/取消固定消息
– `emoji:read` – 读取自定义表情
– `commands` – 使用命令
– `files:read` – 读取文件
– `files:write` – 上传文件

3. 返回页面顶部，点击”Install to Workspace”按钮
4. 在弹出窗口中点击”Allow”
5. 安装完成后，复制”Bot User OAuth Token”（以`xoxb-`开头）

## 步骤5：配置事件订阅（可选但推荐）

1. 在左侧菜单中点击”Event Subscriptions”
2. 启用事件（将开关切换到”on”）
3. 在”Subscribe to bot events”部分，添加以下事件：
– `message.*` – 包括编辑/删除/线程广播
– `app_mention` – 提及机器人的消息
– `reaction_added`, `reaction_removed` – 反应添加/移除
– `member_joined_channel`, `member_left_channel` – 成员加入/离开频道
– `channel_rename` – 频道重命名
– `pin_added`, `pin_removed` – 固定消息添加/移除

## 步骤6：邀请机器人到频道

在Slack中邀请OpenClaw机器人到您希望它参与的频道：
1. 在频道中输入`/invite @OpenClaw`（或您设置的应用名称）

## 步骤7：配置OpenClaw

有两种方式可以配置OpenClaw：

### 方法一：通过环境变量（推荐）

“`bash
export SLACK_APP_TOKEN=xapp-…
export SLACK_BOT_TOKEN=xoxb-…
“`

### 方法二：通过配置文件

创建或编辑OpenClaw配置文件，添加以下内容：

“`json5
{
channels: {
slack: {
enabled: true,
appToken: “xapp-…”,
botToken: “xoxb-…”
}
}
}
“`

## 步骤8：启动OpenClaw

配置完成后，启动OpenClaw服务：

“`bash
openclaw gateway start
“`

## 高级配置选项

### 用户令牌（可选）

您可以添加用户令牌以获得更好的读取权限：

“`json5
{
channels: {
slack: {
enabled: true,
appToken: “xapp-…”,
botToken: “xoxb-…”,
userToken: “xoxp-…” // 可选
}
}
}
“`

### 频道特定配置

您可以为特定频道设置不同的行为：

“`json5
{
channels: {
slack: {
enabled: true,
appToken: “xapp-…”,
botToken: “xoxb-…”,
groupPolicy: “allowlist”,
channels: {
“C123ABC”: {
“allow”: true,
“requireMention”: true
},
“#general”: {
“allow”: true,
“requireMention”: false
}
}
}
}
}
“`

### 回复线程模式

控制OpenClaw如何回复消息：

“`json5
{
channels: {
slack: {
// 其他配置…
replyToMode: “off”, // 默认：在主频道回复
// 或者
replyToMode: “first”, // 第一次回复在线程中
// 或者
replyToMode: “all” // 所有回复都在线程中
}
}
}
“`

## 故障排除

### 问题：机器人无法发送消息
– 检查Bot Token是否正确
– 确认已添加`chat:write`作用域
– 确保机器人已被邀请到目标频道

### 问题：无法读取消息历史
– 确认已添加相应的`channels:history`、`groups:history`等作用域
– 检查机器人是否已在相关频道中

### 问题：事件未触发
– 检查事件订阅是否已正确配置
– 确认Socket模式已启用

## 安全考虑

– 将令牌存储在安全位置，不要硬编码在代码中
– 定期轮换令牌
– 限制频道访问权限，使用允许列表模式
– 在生产环境中使用适当的用户验证机制

## 总结

完成以上步骤后，您的OpenClaw实例应该能够成功连接到Slack，并开始处理消息、事件和交互。根据您的具体需求调整配置，确保安全性和功能性都符合要求。

如果遇到任何问题，请参考OpenClaw官方文档或社区支持资源。