腾讯开源 Octop：一条命令跑起来的多人 AI 助手

最近在 GitHub 趋势里反复刷到一个名字Octop。一开始我以为又是哪个个人开发者的玩具项目点进去一看仓库挂在TencentCloud组织下是腾讯云开源的一个自托管 AI 助手。今天10 月 9 日晚上我看的时候仓库已经有 8191 个 star、992 个 fork许可证是 MIT。先交代清楚这篇是读仓库的笔记不是上手测评。我还没有在自己的机器上完整部署跑过它下面写的功能和架构都来自官方 README、CHANGELOG 和 Release 页面凡是我自己判断的部分会单独标出来。一、它是什么一句话一个可以装在自己机器上、全家或小团队共用的 AI 助手平台。仓库简介写的是「A smarter, self-hosted AI assistant — multi-user, multi-agent」。翻成大白话有三个关键词自托管装在你自己的电脑、服务器或 NAS 上配置、对话、工作区和凭证都放在本机的~/.octop/目录。多用户一个管理员账号开通家人或同事各自登录按用户隔离 Agent 和工作区。多 Agent每个人可以建多个「专家」各自有独立的工作区、模型供应商、通道和定时任务还内置了 16 种 MBTI 人格模板。README 里列的典型用法有六类我照着摘一下个人助理写周报、整理资料、定日程记忆随工作区长期保留。家庭共享一个管理员账号全家共用按成员分配不同的 Agent。团队助手多个 Agent 并行协作对接飞书、钉钉、企业微信把任务分发到群里。开发者增效把编码任务委派给外部编程 Agent或者在终端里让 AI 辅助排障。网页自动化用浏览器和远程桌面能力自动填表、截图、操作 GUI 软件。定时任务用自然语言配置 Cron让 Agent 每天按时推送或执行。入口也不止一个。Web 控制台、命令行、HTTP 和 WebSocket API 之外它能接飞书、钉钉、QQ、微信、企业微信这些 IM 通道。也就是说你可以在群里直接 它干活不用专门打开一个网页。二、架构很省我最感兴趣的是它的架构选择。README 里说得很直白单进程。一条octop run启动之后同一个进程里同时跑着 Web 控制台、CLI、IM 通道和定时任务。所有入口都汇到一个叫HarnessProcessor的进程内路由不依赖外部消息队列或中间件。状态存在控制面数据库里默认是 SQLiteWAL 模式也可以换成 PostgreSQL进程重启后状态从数据库重建。数据目录的结构也很清楚~/.octop/下面放进程配置config.json、控制面数据库octop.db、密钥目录secrets/、每个 Agent 的工作区agents/、Shell 命令护栏规则和运行日志。备份和迁移基本就是围绕这一个目录做官方也提供了octop backup命令。Agent 的工作区后端还可以单独换成 Docker 沙箱、PostgreSQL 或者 COS / S3 这类对象存储和控制面数据库分开。底下的能力拆成了四个独立仓库Octop HarnessAgent 运行时负责模型路由、工具、技能和对话检查点。Octop Gateway多平台 IM 通道桥接把各家消息归一成同一条处理管线。Octop Memory分层记忆和全文检索记忆跟着工作区一起迁移。Octop Browser基于 CDP 的浏览器自动化支持持久化登录配置。这四个子仓库都是 9 月 24 日前后在 GitHub 上创建的同样是 MIT 许可目前 star 数还只有几十。我的看法主观单进程加 SQLite 这个组合对家庭和小团队是对的。不用装 Redis不用配消息队列一台小主机或者 NAS 就能扛起来出问题也好排查。代价是横向扩展能力有限但它本来瞄准的就不是大规模企业部署。三、功能清单功能很多我按自己关心的程度挑几项说。连接器和技能通过 OAuth 加 MCP 网关接外部服务README 写的是能一键接入「腾讯全家桶」文档、会议、新闻等。技能可以按 Agent 单独启用或禁用。ACP 双向集成这一点对开发者比较有意思。一方面octop acp可以把你的 Octop Agent 以 stdio ACP 服务的形式提供给 Zed、OpenCode 这类工具另一方面Octop 也能在对话里把编码任务委派出去内置的出站 Runner 包括 OpenCode、CodeBuddy、Claude Code 和 Codex。终端、浏览器和远程桌面控制台里有带 AI 辅助的交互式 Shell、基于 Chromium 的无头浏览器会话还有跨 Linux、Windows、macOS 的远程桌面可以在网页里直接看屏、操作键鼠。安全护栏JWT 多用户隔离、高风险工具审批、Shell 命令规则放在~/.octop/security/tool_guard/、离开工作区前的敏感信息脱敏。知识库和插件基于文档的 RAG 检索支持同一实例内共享语料第三方插件用octop plugin管理。还有一个AgentTeams由一个协调者调度多位专家协作完成多步骤任务目前标的是 Beta。四、迭代很快翻 CHANGELOG 能看出这个项目的节奏。7 月 8 日仓库创建CHANGELOG 里第一个版本是 0.9.1。7 月 11 日0.9.4CHANGELOG 里写着「项目重命名为 Octop」。9 月 14 日v1.0.0标注为 GA 正式版。9 月 18 日v1.0.1加了飞书、钉钉、企业微信的 OAuth 单点登录。10 月 4 日v1.0.2b6是目前 GitHub 上最新的 Release新增了 Agent Mail 连接器、LDAP 登录和飞牛 ARM 安装包。从 0.9.1 到 1.0.2b6三个月里 CHANGELOG 一共记了 41 个版本平均两天出头就有一版。这说明投入很大也意味着接口和配置还在快速变化现在上生产要做好跟着升级的准备。另外提一句截至今晚仓库的 open issues 加 PR 数是 688。star 涨得快反馈也多这个数字本身说明不了好坏但值得留意。五、怎么装上官方给了好几种装法最后都落到同一组命令上。README 里写明安装脚本会用 uv 在~/.octop/下建一个隔离的 Python 3.12 环境不碰系统 Python。PyPI 上也能直接装要求 Python 3.12 及以上。需要注意的是PyPI 当前的稳定版是 1.0.1GitHub Release 上的 1.0.2b6 版本号带 bbeta按 Python 的版本号规范算预发布版。如果你只是想看看桌面客户端最省事Windows、macOS、Linux 都有安装包飞牛 NAS 也有现成的 fpk。要长期给家人或团队用README 推荐 Docker 部署。六、我的疑问读完仓库我有几个还没想清楚的地方先记下来模型要自己配。Octop 本身不带模型需要接 OpenAI 兼容接口、DashScope千问或者 Ollama 这类供应商。用本地模型能真正做到数据不出门用云端 API 的话「数据留在本地」只对存储成立对话内容还是要发给模型厂商。资源占用未知。README 只写了「现代多核 CPU预留数 GB 内存」没有给具体数字。打算装在 NAS 上的朋友最好自己先测一下。微信通道怎么接。README 里微信通道写的是「扫码绑定 / 账号凭证」具体是哪种机制、稳定性如何我还没有实测不下结论。和同类项目的差别。自托管 AI 助手这条赛道已经有不少项目我的理解是Octop 的差异化在多用户、腾讯生态连接器和 IM 通道的组合上。是不是真的更好用得实际跑一段时间才知道。后面我打算找台机器实际部署一次跑通 IM 通道和定时任务之后再写一篇实测。附安装命令以下命令均摘自官方 README执行前建议先看一眼脚本内容。macOS / Linux 一键安装curl-fsSLhttps://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh|bashWindowsPowerShellirmhttps://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1|iex或者用 PyPI需要 Python 3.12 及以上pipinstalloctop装好之后初始化并启动octop init octop run# 浏览器打开 http://127.0.0.1:8088项目地址github.com/TencentCloud/Octop我是文茂热衷于分享 AI 工具与开发者生态观察。觉得有用欢迎点赞、在看、转发三连。