@openilink/app-slack

docker compose up -d

或手动运行：

docker build -t openilink-app-slack .
docker run -d \
  -p 8082:8082 \
  -e HUB_URL="https://your-hub.example.com" \
  -e BASE_URL="https://your-app.example.com" \
  -e SLACK_BOT_TOKEN="xoxb-xxx" \
  -e SLACK_APP_TOKEN="xapp-xxx" \
  -e SLACK_CHANNEL_ID="C0123456789" \
  -v app-data:/data \
  openilink-app-slack

git clone https://github.com/openilink/openilink-app-slack.git && cd openilink-app-slack
npm install
cp .env.example .env
# 编辑 .env 填入你的配置

# 开发模式（热重载）
npm run dev

# 生产模式
npm run build
npm start

1. 创建 Slack App

1. 前往 Slack API 创建新的 App
2. 选择 From scratch，填写 App Name 和 Workspace
3. 进入 OAuth & Permissions，添加以下 Bot Token Scopes：
   • channels:history - 读取频道消息
   • channels:manage - 管理频道
   • channels:read - 读取频道列表
   • chat:write - 发送消息
   • files:read - 读取文件
   • files:write - 上传文件
   • groups:history - 读取私有频道消息
   • groups:read - 读取私有频道列表
   • groups:write - 管理私有频道
   • im:history - 读取私信
   • pins:read - 读取置顶
   • pins:write - 管理置顶
   • reactions:read - 读取表情反应
   • reactions:write - 添加表情反应
   • reminders:read - 读取提醒
   • reminders:write - 管理提醒
   • bookmarks:read - 读取书签
   • bookmarks:write - 管理书签
   • users:read - 读取用户信息
   • users:read.email - 读取用户邮箱

2. 启用 Socket Mode

1. 进入 Socket Mode 页面，启用 Socket Mode
2. 生成一个 App-Level Token（Scope 选择 connections:write），记录 xapp- 开头的 Token

3. 安装 App 到 Workspace

1. 进入 Install App 页面，点击 Install to Workspace
2. 授权安装
3. 记录 Bot User OAuth Token（xoxb- 开头）

4. 订阅事件

1. 进入 Event Subscriptions，启用 Events
2. 订阅以下 Bot Events：
   • message.channels - 公共频道消息
   • message.groups - 私有频道消息

架构图

graph LR
    WX[微信用户] -->|消息| Hub[OpeniLink Hub]
    Hub -->|Webhook| App[Slack Bridge App]
    App -->|Socket Mode| Slack[Slack 工作区]
    Slack -->|事件| App
    App -->|Bot API| Hub
    Hub -->|回复| WX

    subgraph "Slack Bridge App"
        WxToSlack[WxToSlack Bridge]
        SlackToWx[SlackToWx Bridge]
        Router[命令路由]
        Tools[23 个 AI Tools]
    end

消息流转

sequenceDiagram
    participant WX as 微信用户
    participant Hub as OpeniLink Hub
    participant App as Slack Bridge
    participant Slack as Slack

    Note over WX, Slack: 自动桥接流程
    WX->>Hub: 发送消息
    Hub->>App: Webhook 推送
    App->>Slack: Block Kit 消息
    Slack->>App: 线程回复
    App->>Hub: Bot API 回复
    Hub->>WX: 微信消息

    Note over WX, Slack: 自然语言工具调用
    WX->>Hub: "帮我创建一个 dev 频道"
    Hub->>App: command 事件
    App->>Slack: conversations.create
    Slack-->>App: 创建结果
    App-->>Hub: 工具返回值
    Hub->>WX: "已创建 #dev 频道"

自动桥接

微信用户发送的消息会通过 Hub Webhook 推送到本 App，然后以 Block Kit 格式转发到指定 Slack 频道。Slack 用户在对应消息线程中回复时，App 会通过 Hub Bot API 将回复发送回微信用户。

自然语言工具调用

当 Hub 的 AI 识别到用户意图匹配某个 Tool 时，会发送 command 事件到 App。App 的 Router 根据命令名路由到对应的 Tool Handler，执行 Slack API 操作后返回结果。Hub AI 将结果格式化后回复给微信用户。

常用命令

# 安装依赖
npm install

# 开发模式
npm run dev

# 编译
npm run build

# 生产运行
npm start

# 运行测试
npm test

# 监听模式测试
npm run test:watch

# 类型检查
npx tsc --noEmit

项目结构

src/
├── index.ts              # 主入口
├── config.ts             # 配置加载
├── store.ts              # SQLite 存储层
├── router.ts             # 命令路由器
├── hub/
│   ├── types.ts          # Hub 类型定义
│   ├── client.ts         # Hub Bot API 客户端
│   ├── manifest.ts       # App Manifest 生成
│   ├── oauth.ts          # OAuth PKCE 安装流程
│   └── webhook.ts        # Webhook 事件处理
├── slack/
│   ├── client.ts         # Slack 客户端封装
│   └── event.ts          # Slack Bolt App & 事件监听
├── bridge/
│   ├── wx-to-slack.ts    # 微信 → Slack 消息桥接
│   └── slack-to-wx.ts    # Slack → 微信 消息桥接
├── tools/
│   ├── index.ts          # Tool 注册入口
│   ├── messaging.ts      # 消息操作 Tools
│   ├── channels.ts       # 频道操作 Tools
│   ├── files.ts          # 文件操作 Tools
│   ├── users.ts          # 用户操作 Tools
│   ├── reminders.ts      # 提醒操作 Tools
│   └── bookmarks.ts      # 书签操作 Tools
└── utils/
    └── crypto.ts         # 签名验证 & PKCE 生成