📌 项目地址:TencentCloud/Octop | ⭐ 3,348 颗星 | 🔧 Python | 📜 未标注
项目卡片
仓库:TencentCloud/Octop,3348 star,Python。一句 octop run 启动,单进程同时提供 Web 控制台、CLI、IM 通道(飞书、钉钉、QQ、Discord、企业微信)、HTTP/SSE/WebSocket 编程接口和 cron 定时任务。所有数据落在 ~/.octop/,默认 SQLite,可换 PostgreSQL。
自托管 AI 助手的项目不少,但大多止步于“能聊天、能接微信”。Octop 有两处不太一样的地方,值得单独讲讲。
一家人真的能分开用
多数自托管 AI 项目只有一个入口,家里人想用就得共享一个账号。Octop 的思路是:一个管理员,家庭成员各有账号,用 JWT 做隔离。每个人还能按场景从内置专家库里切换不同的“专家”Agent。
比较有意思的是 MBTI 人格功能。16 种性格模板,加一个交互式测试,你可以给每个 Agent 配不同的说话风格。这类功能好不好用见仁见智,但至少说明它把“多用户、多 Agent”当成了核心设计,而不是后补的功能。
Agent 真的能动手
这是 Octop 和聊天套壳项目拉开差距的地方,它给了 Agent 三个实际操作环境的入口:
终端 AI+:浏览器里直接开交互式 shell,AI 辅助执行命令、帮你排障。
浏览器 AI+:无头 Chromium 会话,跑网页自动化、截图、远程浏览。
远程桌面:在 dashboard 上实时看到 Linux/Windows/macOS 机器的画面并控制键鼠。无头 Linux 还能一键创建隔离桌面,服务器没装图形界面也能远程办公。
这三样都是高权限操作,所以安全设计是配套的:工具调用要审批,shell 命令有护栏,PII(个人敏感信息)自动脱敏。执行后端可选本地磁盘、Docker 容器、PostgreSQL 或 COS/S3,也就是说 Agent 干活时可以圈在容器里,不碰宿主机。
一个要执行命令、要接 IM 的系统,这些安全开关不是加分项,是及格线。Octop 至少把这条线画清楚了。
开发者会关心的部分
- ACP 双向集成:
octop acp命令可以把任务委托给 OpenCode 或 Claude Code,带权限门控,走 IDE 工作流。 - Connector 生态:内置腾讯系连接器(腾讯文档、微博热搜、新闻等),通过 OAuth 和 MCP 网关接外部资源。
- 记忆系统:基于 harness-memory,记忆跟着工作区走,换机器不丢。
- 知识库:RAG 对你的私有文档做语义检索,回答有出处。
- 插件:第三方插件可扩展,官方自带的插件默认装好,按需开关。
跑之前想清楚三件事
风险。让 AI 操作终端和远程桌面,出事的代价不小。工具审批和容器隔离务必打开,别图省事在裸机上放权。
规模。单进程控制面加默认 SQLite,这个架构就是为家庭和小团队设计的。想拿它做多租户 SaaS,趁早打消念头。
成本。IM 接入要去各家平台申请应用凭证;Connector 和插件的配置细节 README 没展开,动手前先去仓库翻完整文档。商用前也要确认授权协议。
我的看法
Octop 的差异化是实的:多用户隔离让它能被一家人或一个小团队真正共用;终端、浏览器、远程桌面三件套让 Agent 从“说”走到“做”,做的时候还有隔离边界兜底。再加上腾讯开源的背景和 MCP、ACP 这些新协议的跟进,这个项目不像是凑热闹的产物。
如果你一直想搭一个数据不出家门、全家人都能用的 AI 平台,clone 下来跑一句 octop run,十分钟就知道合不合口味。