Octop 实战指南：三步装好你自己的多用户 AI 助手，让专家团替你干活

【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop

早上九点，你打开工作群，里面已经躺着三条行业快讯和一份昨日数据小结。发消息的不是同事，而是跑在办公室一台迷你主机里的 AI 助手。它叫 Octop，一个开源、自托管的 AI 助手，支持多用户、多 Agent，对话记录、工作区文件、密钥全部留在你自己的机器上。这篇文章带你从安装、配专家，一直讲到内网落地。

一个定时任务，替掉晨间简报

先说 Octop 是什么：一个面向家庭和小团队的自托管 AI 助手平台。一个进程同时提供 Web 控制台、CLI、IM 通道和定时任务，你不需要中间件，不需要消息队列，装完就能用。

上面那个"九点简报"，就是它最典型的一种用法。你在控制台里用大白话写一句"每天早上九点，把行业新闻整理成三条发到群里"，它就会自己排班、到点执行、把结果丢进群里。不用写代码，不用配 cron 表达式。

这类场景的价值在于：它把"每天重复、但没人愿意做"的活从人手里接走了，而执行它的机器，就在你自己的网络里。

三步跑起来：安装、初始化、打开控制台

部署这件事，Octop 做到了几乎零折腾。

第一步是安装。安装脚本会在~/.octop/下建一个隔离的 Python 环境，不碰你系统的 Python。克隆仓库后直接跑bash scripts/install.sh即可；Windows 有对应的install.ps1，不想碰终端的用户可以直接下桌面客户端，飞牛 NAS 也有现成安装包。硬件门槛很低：2 核 CPU、4G 内存的迷你主机就能跑，不需要显卡。

第二步是初始化，一条命令octop init。交互式向导会建好数据库、生成密钥，并引导你设置管理员账号。

第三步是启动，octop run之后打开本机 8088 端口，Web 控制台就出来了。

📦 还有一个对新手很友好的设计：数据库、每个专家的工作区、密钥、日志，全在~/.octop/这一个隐藏目录里。备份就是打包这个目录，搬家就是整个拷走。想升级就octop update，数据原样保留。

一句话组建自己的"专家团"

普通聊天机器人只有一个大脑，Octop 的做法是把 AI 拆成一队人。

你可以创建多个专家，每个专家有独立的工作区、模型和知识库，还能挂上一种 MBTI 人格。内置 16 种人格模板，控制台里有个"测一测"小互动，测完自动帮你匹配。于是你会同时拥有：一个说话直来直去的技术顾问，一个耐心的文案，一个只盯数字的分析师。

再往上走一层是 AgentTeams（Beta）：指定一个专家当主持人，再拉几个成员组成团队。你只跟主持人说一句"把这份季度数据整理成汇报材料"，它会把活拆开、并行派给成员，干完回来汇报，最后由主持人汇总、判断能不能收工。整个过程的发言像群聊一样在时间线上滚动，谁在干什么一目了然。规则细节可以翻 专家团文档。

接上飞书、钉钉和浏览器：把 Octop 插进日常工具

会干活只是基础，Octop 把入口铺得相当开。

IM 通道支持飞书、钉钉、QQ、微信、企业微信。接上之后，你在群里 @ 它，它就动手，成果直接回群里。销售问报价、客服查政策，都可以变成一个 @。

知识库走 RAG 检索：把公司文档、产品手册、合同模板丢进去，回答就会"翻着你的资料说话"，并且能标出出处。连接器走 OAuth + MCP，腾讯文档、腾讯会议、Notion、滴答清单这些，点一下授权就能用。

两个"动手"能力值得一提。浏览器 AI+ 能让它自己开一个无头浏览器去填表、点按钮、截图取证；远程桌面则让你在控制台里直接看到另一台机器的屏幕，鼠标键盘都能代劳。

数据不出内网：协议、隔离与审计这套底座

企业 IT 最关心的不是功能，是边界。Octop 在这几件事上的做法值得展开。

协议层走的是标准路线：对 IDE 和编程工具支持 ACP，既能被 Zed、OpenCode 调用，也能把编码任务派给 Claude Code、Codex、CodeBuddy；对外部服务走 MCP；对外提供完整的 HTTP / SSE / WebSocket 接口。可以把它理解成乐队里的乐谱标准——谁按谱来谁就能进乐队，换任何一个乐手都不影响演出，不会被某一家绑死。

安全层是逐条落地的：JWT 多用户隔离，每人有自己的专家和工作区；高风险工具和 Shell 命令按规则拦截、需人工确认；敏感信息在离开工作区前自动脱敏；谁在什么时候让哪个 Agent 干了什么，全程留痕可查。存储也是可插拔的，工作区可以放本地磁盘、Docker 沙箱、PostgreSQL 或对象存储，控制面和数据面分离。

它甚至自带"云边协同"：设置里可以把本机和另一台 Octop（比如公司云主机那台）连起来。连上之后，你在侧边栏就能看到对端的专家，直接开聊——对话实际跑在专家所在的那台机器上，你这边只是遥控器，浏览器只连本机，跨机器的事交给一条加密的 WebSocket 隧道。机制可以看 bridge 文档。数据不用搬家，人却能异地办公。

从 NAS 到内网：一份落地清单

不同体量的人，落地姿势不一样。

家里有 NAS 的，直接装飞牛版，一人一个账号，各用各的专家，互不打扰。五到五十人的小团队，找一台闲置服务器用 Docker 起一个实例，把飞书群接上，日常问答就闭环了。有内网要求的企业，先在隔离环境里跑试点，模型接本地 Ollama，把知识库和审批规则配好，验证一周再谈推广。

别追求一次配齐。挑一台最低配的设备装起来，接入团队最常用的那个群，先把"每天九点的日报"这一件事交给 Octop 跑两周——能稳定跑下来，就说明这套东西值得你继续往下搭。

【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop