夜雨聆风学习资料网

ARTICLE · 1112845

想让 AI 助手住回自己家,腾讯这个开源项目能点几下装好

想让 AI 助手住回自己家,腾讯这个开源项目能点几下装好

腾讯云把一套多用户、多智能体的 AI 助手以 MIT 协议开源了,项目名叫 Octop。

关键在于它跑在你自己的机器上。所有对话、工作区、凭证都留在本地,一个进程同时提供 Web 控制台、命令行、即时通信接入和定时任务。它还上架了 1Panel 应用商店,装它不用敲命令。

一句话上手

先说它解决的是哪一类问题。

你在用某家的云 AI,每天把合同、报表、会议纪要贴进去。这些内容都要先出门绕一圈,再回来。数据留在谁的机器上,取决于服务商的条款,不取决于你。

很多公司 AI 落地的第一道关卡不在技术,在法务那句「这数据能不能不出内网」。

Octop 的答案很朴素,把助手装回自己家。

它到底装了些什么?配置挺多,我挑几个有实际意义的说。

Octop 的四层

多用户是它的底座设计。一个管理员账号,全家或小团队共用一套实例,每个人有自己的 agent 和记忆,彼此用 JWT 隔离。

人设这块有点意思。内置 16 套 MBTI 性格模板,还带一个互动测试,等于给每个 agent 分配一个固定角色。听着像噱头,不过如果你同时跑几个 agent,让它们的说话风格固定下来,读输出的时候确实省事。

安全反而是重点。工具调用要走审批,shell 命令有护栏,敏感信息会做脱敏。这三个开关的意义在于,它没把「agent 能执行命令」当成一个可以直接交付的能力。

接入面铺得很宽。Web 面板之外,支持飞书、钉钉、QQ、Discord、企业微信。还有 ACP 双向通道,能把编码任务派给 OpenCode 或 Claude Code 去跑,带权限门。

浏览器这块也做了。内置无头 Chromium,可以做网页自动化和截图。在 Linux、Windows、macOS 上还能从面板里拿到远程桌面。

一个助手框架值不值得装,不看它功能列了多长,看它有没有把「能干什么」的边界说清楚。

怎么装。1Panel 用户最简单,应用商店里搜 Octop,填表确认,几分钟完事。架构是 amd64,建议内存 2048 MB 以上。

命令行装是这样(下面是按官方 README 整理的示意,具体参数以仓库文档为准)。

# 数据目录默认落在 ~/.octop/
# 默认 SQLite,要换 PostgreSQL 改配置里的数据库连接

# 启动(单进程,Web 面板 + CLI + IM 通道 + 定时任务都在里面)
octop run

# 想接 IDE 或终端里的 AI
octop acp

装完之后,所有状态都在 ~/.octop/ 一个目录里。备份就是拷目录,迁移就是搬目录。老实说,这一点比那些状态散在五六个地方的方案省心得多。

两个选择,两笔账

不过有几处得打问号。

第一,它的定位是个人、家庭和小团队。README 里写得很清楚,它不是给几百人的企业做的。多用户隔离靠 JWT,这在家庭场景够用,你要拿它当公司统一入口,权限模型的粒度得自己再评估。

第二,星数还不算高。仓库目前约 5900 星,30 天增长 4580。热度是真在涨,但和那些几万星的老项目比,生态和插件数量还在早期。插件机制有了,第三方插件有多少得自己看。

第三,模型从哪来。Octop 提供的是助手框架和接入层,模型本身要靠你自己接。这意味着成本结构跟你直接买云 AI 完全不同,你得自己算 token 账和机器账。

第四,项目 7 月才开源,还很年轻。MIT 协议宽松,商用没额外限制。但年轻项目意味着接口可能变,升级前建议先看 changelog。

回到我自己的打算。

这条我打算真装一下。测试目标很具体,不看它功能列得多全,看在一个小团队场景下,多用户隔离和工具审批会不会挡住正常流程。

具体做法是先在一台 2C4G 的机器上用 1Panel 装一遍,建三个账号,给其中一个开 shell 权限、一个只开只读、一个不给工具。然后跑一周,看审批弹窗的频率有多高。

你想想看,如果每次跑个脚本都要点一次确认,那这个护栏在真实使用里就会被关掉,等于没有。反过来,如果一周下来只弹了三四次,那它是可用的。

跑完有结果我再写一篇。

Octop 是自托管项目,部署和维护由使用者自己负责。上面的安装写法是按官方 README 整理的示意,实际配置请以仓库文档为准。数据安全取决于你所在环境的运维水平。

· · ·

本文信息来源

[1] GitHub:TencentCloud/Octop https://github.com/TencentCloud/Octop

[2] 博客园:AI 助手终于能「回家」了,腾讯开源 Octop https://www.cnblogs.com/xiaobaiysf/p/23181208

[3] SegmentFault:2026-09-30 GitHub 热点项目精选(Octop 条目) https://segmentfault.com/a/1190000048325971

[4] 开源榜:GitHub 开源项目 30 日趋势榜(Octop 条目) https://kaiyuanbang.cn/zh-cn/rankings/monthly.html?page=1

[5] 开源榜:GitHub 开源项目 7 日飙升榜(Octop 条目) https://kaiyuanbang.cn/zh-cn/rankings/weekly.html?page=1

[6] GStars.dev:TencentCloud/Octop 项目说明 https://www.gstars.dev/repo/TencentCloud/Octop

[7] Octop 官网 https://octop.cloud

相关学习资料