📌 项目地址: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,十分钟就知道合不合口味。

这篇文章对你有帮助吗?

发表回复