企业官网建设流程全解析

如何搭建专属Slack机器人：Company Brain Slack App创建与安装实战指南

【免费下载链接】company-brainOpen-sourcing our company brain - A teammate in your Slack that remembers everything your team says, and can go do the work.项目地址: https://gitcode.com/gh_mirrors/co/company-brain

Company Brain 是一款开源的「公司大脑」Slack 机器人，它能记住团队在 Slack 里讨论的所有内容，回答团队问题，还能主动去干活的 AI 队友。本指南带你从零完成 Slack App 创建与安装：部署项目、配置 Slack App、把机器人拉进团队，全程约 10 分钟，适合新手跟练。

Company Brain 是什么？为什么值得装？

一句话：它是坐在你 Slack 里的 AI 同事 🧠

• 记得住：会议、决策、项目、负责人，谁在哪个频道说了什么，它都记着
• 答得准：答案来自你自己的对话和已连接的工具，不是网上瞎猜
• 干得了活：开 Issue、查 PR、跑代码、回邮件，直接动手而不是口头建议
• 会主动说话：对话里需要它知道的东西时，它会自己开口（可以调节话多话少）

更多能力介绍可看 docs/guide/overview.md，部署细节在 README.md 的 "Deploy in five minutes" 一节。

开始前的 3 个准备清单

💡 没有 Slack 工作区？先去 Slack 官方后台免费创建一个再回来。

第 1 步：一键部署，让机器人先上线

1. 打开项目的 README.md，点击 "Deploy to Cloudflare" 部署按钮
2. 按提示填入上面两个 API Key
3. 其余资源（数据库 D1、KV、Durable Objects）全部自动创建，无需手动配置

部署完成后，访问你的 Worker 地址下的/setup页面，它会按顺序自检四件事：

1. 数据库：D1 迁移已执行（失败会显示原因并提供重试按钮）
2. 记忆：SUPERMEMORY_API_KEY已配置
3. 模型：MODEL_API_KEY有效
4. Slack：Slack 应用凭据是否已保存（这一步留到下一步做）

完整流程参考 docs/guide/setup.md。

第 2 步：创建 Slack App（核心步骤）

这是整个安装中最关键的一步，/setup页面把繁琐的部分都自动化了：

1. 在/setup页面点击Create the Slack app，它会打开 Slack 应用创建页，并附带一份已填好你部署地址的 manifest（事件回调、交互回调、两个 OAuth 重定向 URL 都已就绪）
2. 选择你的 Slack 工作区，确认创建应用
3. 回到 Slack 应用的Basic Information → App Credentials，复制三个值粘贴回/setup表单：
   • Client ID
   • Client secret
   • Signing secret
4. 保存凭据后，如果Event Subscriptions里的 URL 显示"未验证"，点Retry即可变绿

为什么需要 Signing secret？Slack 会用 HMAC-SHA256 签名每个回调请求，服务端校验失败会直接拒绝，验签逻辑见 src/slack/verify.ts。

项目里还内置了一份本地开发用的完整 manifest 模板，列出了机器人需要的所有权限（bot scopes）和事件订阅，想了解机器人"需要什么能力"可以直接读 docs/slack-app-manifest.yaml：

• 用户侧权限全是只读——每多一个 scope，用户同意页就多一行
• 机器人侧有发帖、读频道历史、建表情回应等权限
• 事件订阅了app_mention、message.channels、reaction_added等，这正是它能"听到对话"的原因

第 3 步：登录 Slack 并安装

凭据保存好之后：

1. 点击Sign in with Slack——第一个登录的人自动成为这个部署的 owner，后续同工作区成员可直接加入，其他工作区的人会被拒绝
2. 点击Install to Slack（仅 owner / admin 可操作），在 Slack 授权页批准

批准后机器人会自己完成一系列"入职"动作，详见 docs/guide/setup.md：

• 自动创建#company-brain主频道，邀请你并发一条自我介绍
• 根据工作区信息研究你的公司业务，开始建立记忆
• 给你管理员发一张卡片，一键邀请它加入所有公开频道（它不会偷偷加入，私有频道必须手动邀请）
• 自动识别工作区成员，给团队每人发一条欢迎 DM

装好了怎么用？30 秒体验

在#company-brain频道或私聊里问一句：

What does {你的公司} do?

它会基于学到的公司上下文作答。团队成员在部署根路径/用 Slack 登录后，还能看到完整应用界面：

• Home：设置进度、已连接数据源、成员列表
• Graph：大脑记忆的可视化图谱
• Configure：模型、Workspace Prompt、主动性、自动化、技能

常见问题速查 ⚡

总结

整个安装路径非常短：部署 → 填 2 个 Key → 建 Slack App 贴 3 个凭据 → 登录 → 安装，剩下的机器人都会自己完成。

想继续深入：

• 安装与初始化全流程：docs/guide/setup.md
• 权限模型（它能看到什么）：docs/guide/permissions.md
• 主动性 / 自动化配置：docs/guide/automations.md
• 典型使用场景：docs/guide/use-cases/overview.md

装好后不妨让它观察团队频道一周——你会发现这个"记得所有事"的 AI 队友，真的在干活 💪

【免费下载链接】company-brainOpen-sourcing our company brain - A teammate in your Slack that remembers everything your team says, and can go do the work.项目地址: https://gitcode.com/gh_mirrors/co/company-brain