3分钟阅读

Slack 集成入门指南

分 7 个步骤引导您将新项目连接到 GIIP 的对话式 Slack 机器人（giipclaude）。按顺序完成每个步骤后，您就可以在 Slack 频道中提及 @giipclaude 来注册或查询 giip issue。

1. 确认项目（csn）

在连接 Slack 机器人之前，需要先有一个该机器人所属的 GIIP 项目（csn）。如果贵公司已经注册并完成入门流程，可跳过本步骤，直接进入第 2 步。如果需要先注册:

➡️ 请先完成注册指南。

下一步: 2. 创建服务组

2. 创建服务组

在 GIIP 中，SK（Secret Key）是按"服务组"单位签发的。如果您还没有此 Slack 机器人专用的服务组，请新建一个。

前往 项目组列表 页面。
点击 [+ 添加组] 按钮创建新组（建议使用能体现用途的名称，如 slack-bot）。

下一步: 3. 签发 SK（Secret Key）

3. 签发 SK（Secret Key）

在同一个 项目组列表 页面上，点击刚创建（或已有）的组旁边的 [Generate Secret Key] 按钮。将签发的 SK 字符串复制到安全的地方 —— 第 7 步会原样使用它。

下一步: 4. 本地安装 giip-fde-agent

4. 本地安装 giip-fde-agent

Slack 机器人在您的电脑（或用于常驻运行机器人的服务器）上本地运行。克隆权威模板仓库并安装。

git clone https://github.com/LowyShin/giip-fde-agent.git
cd giip-fde-agent/slack-bot
npm install

下一步: 5. 创建并连接 Slack App

5. 创建并连接 Slack App

请按照 slack-bot/SLACK_APP_SETUP.md（仓库中已包含）中的完整步骤操作。要点摘要如下:

api.slack.com/apps → Create New App → From scratch
OAuth & Permissions → 添加 Bot Token Scopes: chat:write, app_mentions:read, channels:history, channels:read, groups:history, groups:read, im:history, im:read, im:write（可选: users:read）
启用 Socket Mode → 签发 App-Level Token（connections:write 权限范围） → 复制 xapp-...
启用 Event Subscriptions → 订阅 app_mention, message.im, message.channels, message.groups
Install to Workspace → 复制 Bot User OAuth Token（xoxb-...）
将 slack-bot/.env.example 复制为 .env，并填写 SLACK_BOT_TOKEN（xoxb-）、SLACK_APP_TOKEN（xapp-）、WORKSPACE_DIR
运行 node index.js（或 pm2 start index.js --name giipclaude-bot）

如遇问题，请先查看 SLACK_APP_SETUP.md 底部的"Troubleshooting"表。

下一步: 6. 准备 Slack 频道

6. 准备 Slack 频道

创建机器人将要响应的 Slack 频道，或选定一个现有频道。
在该频道中使用 /invite @<机器人名称> 邀请机器人加入。
确认频道 ID: 右键点击频道名称 → 查看频道详情 → 底部的 C0XXXXXXXXX 格式 ID。

下一步: 7. 完成 GIIP 关联

7. 完成 GIIP 关联

确认机器人在 Slack 中正常运行后，现在将该频道与第 3 步签发的 SK/csn 关联起来。请直接给机器人发送私信（或在要连接的频道中），按顺序输入以下命令。

giip account set <login_id> <SK> <csn>
giip channel set <项目名> <频道ID>
giip project set <项目名> <csn>

<login_id>: 用于识别该账户的邮箱等（仅用于展示，例如 you@example.com）
<SK>: 第 3 步签发的值
<csn>: 第 1 步确认的项目编号
<项目名>: 您自行确定的小写标识符（注册 giip issue 时会按此名称路由）

所有命令都成功后，您就可以在该频道中说 @<机器人名称> 注册 issue <内容> 之类的话，立即注册一个 giip issue。

⚠️ 如果是全新项目: giip project set 会自动尝试授予机器人的数据库访问权限（tUserPerCorp），但对于完全全新的 csn，出于安全门控该自动授予会失败（这是预期行为）。此时命令响应会显示警告，并会在 csn 47 下自动注册一个后续处理的 giip issue —— GIIP 管理员需要查看该 issue，并在 giipdb/data/seed_tUserPerCorp_botuser.sql 中手动添加一行来授予权限。只有这一步需要管理员介入，其余全部都是自助完成的。

版本: 2.0（全面改版为基于 giip-fde-agent 的对话式机器人入门流程） 最后更新: 2026-09-10 源文件: giipv3/public/help/slack-bot-setup.zh-CN.md