Company Brain本地开发指南Bunngrok搭建Slack沙箱工作区实战【免费下载链接】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-brainCompany Brain 是一款住在 Slack 里的 AI 记忆队友它记住团队聊过的决策、项目和上下文并能主动开口干活。本文带你完成 Company Brain 本地开发全流程——用 Bun 一条命令跑起服务用 ngrok 打通公网隧道再把机器人装进你自己的 Slack 沙箱工作区全程约 1 小时。 Company Brain 是什么一句话概括一个真正了解你公司的 Slack 队友。它不只回答问题还会替你开 issue、读 PR、翻仓库。核心能力一览摘自 README.md能力说明 记住一切持续更新频道里的决策、项目、负责人无需人工记录 基于团队对话回答答案来自你自己的聊天记录和已连接工具而非联网瞎猜️ 操作工具通过 MCP 连接 GitHub、Linear、Notion、Google Workspace 等 运行代码自带沙箱克隆仓库、跑脚本直接在 Slack 里返回图表和文件️ 本地开发架构先看懂两类流量本地跑 Company Brain关键是理解两种流量走两条路组件位置说明WorkerAPI 大脑 Agent你本机wrangler dev用 Bun 启动浏览器和 Slack 都打到它公网隧道ngrok把 Slack 服务器的事件回调转发进本机Slack 沙箱工作区Slack 开发者计划独立隔离专供机器人调试浏览器流量你本机直接访问无需公网地址Slack 服务器流量事件订阅和交互回调由 Slack 服务器 POST 过来它访问不到127.0.0.1必须经过 ngrok 隧道这也是为什么机器人地址、OAuth 回调都要填隧道地址——填错一项机器人就失联。完整原理可参考 docs/local-dev.md。 准备工作克隆仓库、安装 Bun 与配置密钥第 1 步克隆代码并安装依赖git clone https://gitcode.com/gh_mirrors/co/company-brain cd company-brain bun install第 2 步配置两个必需密钥cp .dev.vars.example .dev.vars打开 .dev.vars.example只需填两个必填项变量用途SUPERMEMORY_API_KEY大脑的记忆库读写记忆都走这里MODEL_API_KEY模型密钥支持 Anthropic / OpenAI / Google / xAI / OpenRouter程序按前缀自动识别提供商可选增强填DAYTONA_API_KEY可启用代码沙箱工具shell、git、文件。 最快启动方法一条命令跑起 Company Brainbun run dev这条命令背后执行的是wrangler dev见 package.json它会先构建前端bun run build:web再启动 Cloudflare Worker 本地运行时自动应用数据库迁移——D1、KV、Durable Objects 都在本地模拟无需额外操作修改src或web下代码后热更新保存即生效启动后打开本地地址下的/setup页面它会检查密钥、检查数据库迁移状态是本地开发的体检中心路由实现在 src/setup/routes.ts。 改了数据库 schema运行bun run db:generate生成迁移并打包进 Worker下次请求自动应用。 ngrok 隧道搭建让 Slack 找到你的电脑Slack 服务器必须能访问到你的本机这就是 ngrok 的活儿ngrok http 8787然后把隧道地址填回 .dev.varsPUBLIC_URLhttps://你的隧道地址.ngrok-free.appPUBLIC_URL决定了 OAuth 回调和 Slack 里所有链接的家定义见 env-supplement.d.ts。改完记得重启bun run dev。 创建 Slack 沙箱工作区并装好机器人第 1 步加入 Slack 开发者计划免费进入 Sandboxes 创建一个沙箱工作区。注意限额同时最多 2 个活跃沙箱30 天内最多建 10 个且不能导入历史消息。第 2 步从 Manifest 创建应用。打开 docs/slack-app-manifest.yaml只需替换两处占位符YOUR-TUNNEL.ngrok-free.app→ 你的 ngrok 隧道地址yourname→ 你的名字方便区分不同开发者的应用到 api.slack.com → Create New App →From a manifest选择你的沙箱工作区粘贴保存。Manifest 里预置了机器人所需的全部 scope 和事件订阅地址/brain/slack/events、/brain/slack/interactions与代码中的 src/routes/slack/index.ts 保持同步。第 3 步验证事件订阅。在应用的 Event Subscriptions 页面Request URL 首次会显示未验证签名密钥还没配对点Retry变绿即成功。验签逻辑在 src/brain/slack/verify.tsHMAC 签名校验 5 分钟时钟偏差没有开发后门。✅ 安装机器人并验证效果在浏览器打开本地地址用 Slack 账号登录第一个登录者成为部署所有者选择Add to Slack在授权页选定你的沙箱工作区回到 Slack私聊机器人或 它应该能收到流式回答 验证小技巧打开 ngrok 控制台每次 Slack 交互都会看到一条请求记录机器人没反应时先看 ngrok 有没有收到请求没请求 Slack 找不到你隧道断了或 URL 填错401 签名密钥不匹配️ 本地开发常见问题快速排查症状原因解法Request URL 验证失败401API 没跑 / 隧道断了 / 签名密钥不一致确认bun run dev在运行、隧道存活、密钥一致后点 Retry机器人从不回复Slack 流量进不来或 AI 密钥缺失查 ngrok 控制台200 但静默则检查模型密钥端口被旧进程占用残留的 workerd 占着端口杀掉旧的 wrangler/workerd 进程后重启全新克隆后行为怪异依赖没装全先bun install再bun run dev 关键文件导航顺着这些入口你可以快速深入 Company Brain 的内部实现官方架构说明docs/architecture.md本地开发详细指南docs/local-dev.md项目规格文档docs/spec.md入口 Workersrc/worker.ts大脑 AgentDurable Objectsrc/brain/turn/agent.tsSlack 事件与回调src/brain/slack/events.tsWeb 前端登录、/brain主页web/app.tsx回顾一下Bun 负责一键起服务ngrok 负责把 Slack 的回调引回本机沙箱工作区负责安全隔离——三者就位你就拥有了一个完全受控的 Company Brain 本地开发环境。去你的沙箱里 它一句介绍一下你自己吧。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考