ARTICLE · 1012380
腾讯开源AI助手:Octop,装自己电脑上,数据全留本地

你电脑里大概装了不止一个 AI 应用。聊天记录、上传的文件、跟客户谈的方案,都在别人的服务器上。
腾讯云在 GitHub 上开源了一个叫 Octop 的项目。MIT 协议,Python 写的,版本 0.9.33。它想把这些搬回你自己的电脑。
自己机器上跑 AI 助手,这事早有一堆方案。Octop 多出来的是两样:能开多个账号给家里人各用一个,每个账号底下还能养几个性格不同的 Agent。
装起来就一行
macOS 和 Linux:
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bashWindows 换成 PowerShell 的 irm ... | iex,或者用 cmd 跑 install.bat。脚本会拿 uv 在 ~/.octop/ 下建一个隔离的 Python 3.12 环境,系统里原来那套 Python 碰都不碰。
装完敲 octop run,浏览器打开 127.0.0.1:8088,控制台就出来了。
不想碰命令行的,GitHub Releases 里有打包好的桌面客户端。Windows 是 exe,macOS 是 dmg,飞牛 NAS 还有 fpk 包,走应用中心装就行。
一家人怎么分
多用户这块,很多自托管方案写得含糊。Octop 在 README 里讲得很细。
第一个注册的账号是管理员,给家里每个人各开一个。各人的 Agent、对话记录、工作区、定时任务互相看不见,隔离靠 JWT 认证。
一家人挤在一个会员里轮着用,或者不小心翻到别人跟客户的聊天记录,这类别扭事就不存在了。
每个 Agent 还能配性格,内置 16 种 MBTI 人格模板。查资料的设成理性派,管日程的设成乐天派。不想用模板,直接写系统提示词。启动时它会扫一遍专家库,专业角色一键建出来。
在群里用它
Octop 内置了 IM 通道桥接。飞书、钉钉、QQ、Discord、企业微信,凭证配好就能把 Agent 拉进群。
在飞书群里 @ 一下,周报出来了。或者设个定时任务,每天早上八点自动把昨天的数据整理成一条消息推给你。定时任务支持自然语言配 Cron,不用背那五个星号。
Web 控制台、IM、定时任务走的是同一条消息处理链路。在群里跟助手说的话,回到网页上还能接着聊。
跟编辑器和编程助手接上
Octop 支持双向的 ACP(Agent Client Protocol)。
往里,你在 Zed、OpenCode 这类编辑器里可以直接调用自己 Octop 里的 Agent,用的还是你自己的模型和记忆。
往外,给 Agent 打开 acp_runner,它就能把编码活派出去。可选的 Runner 有 OpenCode、CodeBuddy、Claude Code、Codex。你在微信里说一句"把那个登录 bug 修了",它转手交给专门写代码的去做。
浏览器、终端、远程桌面
浏览器 AI+ 是个无头 Chromium,能自动填表、截图、抓公开页面信息。登录状态可以持久化,不用每次重新登。
终端 AI+ 在浏览器里开一个交互式 Shell,命令敲不明白的时候让 AI 帮着看。
远程桌面管的是另一类事。控制台里直接看屏加键鼠操控,Linux、Windows、macOS 都支持。手里那台没装图形界面的 Linux 服务器,一条命令能给它搭出一个隔离桌面。
数据在自己手里,到什么程度
所有东西在 ~/.octop/ 这一个目录下。数据库、JWT 密钥、每个 Agent 的工作区、安全规则、日志,都在里面。
默认 SQLite,可以换成 PostgreSQL。Agent 工作区的存储能接腾讯云 COS 或者 S3。
工具护栏自己配。哪些 Shell 命令能跑、哪些必须人工点同意,规则写在 ~/.octop/security/tool_guard/。敏感信息离开工作区之前自动脱敏。
模型供应商不锁定,OpenAI 兼容接口、通义千问 DashScope、Ollama 这些预设都能接,还能按 Agent 分别配。全用本地 Ollama 的话,对话连你自己的服务器都不出。
架构是单进程,不依赖外面的消息队列和中间件。Web UI、IM、定时任务三个入口全走进程内的 HarnessProcessor 统一路由。重启之后状态从控制面数据库重建。
现在还不行的地方
版本号 0.9.33,没到 1.0。
README 里那张规划表,大半还是空框:技能和子智能体共享池、专家配置共享、浏览器技能录制、AgentTeams 多专家协同,还有把日常对话自动沉淀成技能,都写着待做。
PC 和移动端的原生客户端也在规划里,现在只有 Web 控制台和 IM 两条路。
底层的 harness-agent、harness-gateway、harness-memory、harness-browser 四个项目在筹备开源,仓库地址还没放出来。
它的脾气适合愿意动手的人。敲命令行、改 config.json 这些事得能接受,0.x 版本的坑也得能忍。
想试就一行命令的事。装完第一件事,把管理员密码设成 8 位以上、字母加数字的组合。
项目地址:github.com/TencentCloud/Octop