海外团队需基于slack官方api与openai原生接口自主构建安全联动链路：创建slack应用获取client id/secret、signing secret；配置socket mode（用xapp-令牌）避免公网暴露；添加6项bot权限；绑定openai密钥；通过.env区分app与bot令牌；启动后用@teamgpt测试响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
海外团队需要在Slack中直接调用ChatGPT完成会议纪要整理、跨时区技术答疑、多语言消息润色等高频协作任务，但无法依赖国内平台中转或预置插件，必须基于Slack官方API与OpenAI原生接口自主构建安全、可控的联动链路。
创建Slack应用并获取核心凭证
进入 Slack API管理后台 → 点击 Create New App → 选择 From scratch → 填写应用名称（如“TeamGPT”）并指定开发用workspace → 点击 Create App。
在 Basic Information 页面，找到 App Credentials 区域，【务必立即复制并离线保存 Client ID、Client Secret 和 Signing Secret】，这三个值后续无法再次查看，丢失需重新创建应用。
切换到 OAuth & Permissions 标签页，在 Bot Token Scopes 下添加以下6项权限：chat:write、channels:history、groups:history、im:history、mpim:history、users:read。其中 chat:write 是发送回复的必要权限，缺一则Bot无法在频道中说话。
配置Socket Mode实现零公网暴露部署
在左侧菜单点击 Features → Socket Mode，将 Enable Socket Mode 开关置为 ON，并记录下 App Level Token（以 xapp-1- 开头）。该令牌用于建立反向WebSocket连接，【不可与Bot Token（xoxb-）混用】。
Socket Mode模式下，你的服务主动连Slack，而非等待Slack回调——这意味着你完全不需要公网IP、域名或SSL证书，本地MacBook、公司内网服务器甚至树莓派都能运行Bot。
若误选传统Events API方式，将被迫暴露Webhook端点至公网，不仅增加防火墙配置复杂度，更可能触发企业安全策略拦截，导致事件接收失败。
绑定OpenAI API并设置环境变量
登录 OpenAI API Keys页面 → 点击 Create new secret key → 复制生成的 sk-xxx 密钥。
在部署机器上创建 .env 文件，写入三行：
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
SLACK_APP_TOKEN=xapp-1-xxxxxx
SLACK_BOT_TOKEN=xoxb-xxxxxx
OPENAI_API_KEY=sk-xxxxxx
注意：SLACK_APP_TOKEN 用于初始化Socket连接，SLACK_BOT_TOKEN 用于调用 chat.postMessage 发送消息，二者作用不同，顺序不能颠倒。
启动服务并验证首条响应
以Python项目为例，执行 python app.py 启动后端服务。
打开Slack客户端，在任意已安装该App的频道中输入 @TeamGPT Hello，观察Bot是否在3秒内回复 “Hello! I'm ready to help.”。
若无响应，先检查终端日志中是否出现 “Connected to Slack via Socket Mode”；若出现 “Invalid auth” 错误，则大概率是 SLACK_APP_TOKEN 与 SLACK_BOT_TOKEN 混用或填错。
确认响应成功后，在Slack中对该Bot消息点击右键 → Apps → Open App Home → 在Home界面输入 “/help”，即可触发预设的帮助文档返回。
