
在家里或几个人的小团队里搭一个 AI 助手,问题很快就会冒出来:大家共用一个账号,你让它记住的工作安排和孩子问的作业题混在一起;想在微信群、飞书群里直接喊它,还得自己写机器人对接;聊天记录和各种 API Key 也都放在别人的服务器上。
Octop 是腾讯云开源的自托管 AI 助手,Python 编写,MIT 协议。它装在你自己的电脑、NAS 或云服务器上,一个 octop run 进程同时提供网页控制台、命令行、IM 机器人和定时任务,数据都放在本机的 ~/.octop/ 目录下(默认 SQLite,可选 PostgreSQL)。
这篇适合想给家庭或小团队部署私有 AI 助手的读者,也适合想把编程任务从聊天里转给 Claude Code、Codex 的开发者。下面依次讲多用户与专家、IM 通道与连接器、AgentTeams 协作、ACP 编程接入、安装方式和限制。

多用户共用:一个管理员,每人一组专家
Octop 是多用户设计。管理员给每个人开账号,登录后各自有一组 Agent,项目里叫“专家”。每个专家有独立的工作区和记忆,模型、IM 通道、定时任务也分别配置,孩子问的作业题不会混进你的工作周报。
- 专家可以从模板一键创建:内置专家库里有通用助手、系统医生、运维工程师、办公自动化、热点记者、育儿管家、证券观察员等,点一下就装好,再按需要改提示词。配好的专家还能分享给同一实例里的其他人。
- 可以给专家设定性格:内置 16 种 MBTI 人格模板和一套互动测试,同样是助手,可以一个说话干脆、一个耐心细致。
- 模型按专家单独配置:支持 OpenAI 兼容接口、通义 DashScope、本地 Ollama 等,重活交给能力强的模型,日常陪聊用便宜的。

如果你打算给 Octop 的专家接 OpenAI 兼容接口,Key 分组、协议地址和模型 ID 的对应关系可以参考 第三方工具接入 AIGoCode:Key 分组、协议地址和模型 ID 怎么选。
在微信、飞书群里直接 @ 它
网页控制台只是入口之一。飞书、钉钉、QQ、微信、企业微信、Telegram、Discord 等都能接入,每个专家绑定自己的通道,在群里 @ 一下就开始干活。
定时任务可以用自然语言配置,比如让它每天早上 8 点整理一份科技新闻发到家庭群,到点自动执行。
连接器以腾讯系服务为主,内置腾讯文档、腾讯会议等,也有 Notion、滴答清单、Obsidian、Dify 等;不够用时可以在控制台里接自定义 MCP。
控制台里还有几项实用功能:
- 知识库:把自己的文档导入做 RAG,回答基于你的私有资料;
- 终端 AI+:在浏览器里开一个 Shell,让 AI 协助执行命令、排查问题;
- 浏览器 AI+:用无头 Chromium 自动填表、截图;
- 远程桌面:在控制台里直接看屏幕、操作键鼠。
AgentTeams:一个主持人带一组专家协作
AgentTeams 目前还是 Beta,但设计思路值得看。
团队本身也是一个专家,身份是主持人。它不做具体工作,没有文件系统、浏览器、搜索这类工具,只能查看成员名单、给成员派活。
你交给团队一个任务,主持人先把需求改写成任务说明,再同时派给几个成员。成员各自在自己的工作区里干活,发言直接出现在群聊时间线上。成员之间可以互相询问,但不能再拉新成员进来。全部完成后,主持人被唤醒,判断是否收工,最后给你一段总结。

中途插话时,消息一律先到主持人;点停止只会停掉主持人这一轮,成员会把手上的活做完再交差。主持人只调度不动手、成员只干活不拉人,权限收得紧,几个 Agent 互相调用停不下来的情况就很难出现。
写代码的任务,通过 ACP 转给 Claude Code、Codex
Octop 支持 ACP(Agent Client Protocol),两个方向都能用。如果你还不清楚 ACP 和 MCP 的分工,可以先看 ACP 与 MCP 怎么选,编辑器接入 AI 编程 Agent 的两种协议对比。
往外派:在控制台的 ACP 页面配置 runner,内置 OpenCode、CodeBuddy、Claude Code、Codex、Kimi Code、Cursor CLI,再给某个专家打开 acp_runner 工具。聊天里说一句,它就把编码任务交给外部编程 Agent;对方需要改文件、跑命令时,权限确认会弹回聊天里让你选择。对应的 CLI 需要装在运行 octop run 的那台机器上。
往里接:反过来,Zed 这类支持 ACP 的编辑器,也可以把 Octop 的专家当作编程 Agent 使用。下面的命令会单独启动一个 stdio ACP 服务,不需要先运行 octop run:
octop acp --agent main
然后在 Zed 的配置文件里加一段:
// ~/.config/zed/settings.json
{
"agent_servers": {
"Octop": {
"command": "octop",
"args": ["acp", "--agent", "main"],
"env": {}
}
}
}

能执行 Shell、能调用外部 Agent,安全措施也要跟上。Octop 有一套 Shell 命令的允许和拒绝规则(放在 ~/.octop/security/tool_guard/ 下,可以自己改),有风险的工具需要你确认才执行,敏感信息离开工作区前会先脱敏;多用户之间用 JWT 做隔离。
怎么安装 Octop
Octop 支持 macOS、Linux 和 Windows,有几种安装方式。
官方安装脚本:README 提供了 macOS / Linux 和 Windows 的一键安装脚本,脚本用 uv 在 ~/.octop/ 下单独准备 Python 3.12 环境,不需要预先安装 Python,也不影响系统自带的 Python。
pip 安装:自己管理 Python(3.12 及以上)的,可以直接安装:
pip install octop
安装后初始化并启动。初始化是交互式向导,会建好数据库和第一个管理员账号(密码至少 8 位,需包含字母和数字):
octop init
octop run
浏览器打开 http://127.0.0.1:8088 即可使用。想让它常驻,可以注册成系统服务:
octop service start
Docker 部署:长期运行更推荐 Docker。国内拉取 ghcr.io 较慢的,仓库里有一份走国内镜像的配置:
git clone https://github.com/TencentCloud/Octop.git
cd Octop
docker compose -f deploy/docker/docker-compose.cn.yml up -d
桌面客户端:不想碰终端,Release 页面有 Windows、macOS、Linux 桌面客户端,飞牛 NAS 也有安装包。
限制与注意事项
- 迭代很快:版本更新频繁,AgentTeams 仍是 Beta;跨版本升级前先用
octop backup备份。 - 连接器偏国内服务:以腾讯系和国内服务为主,海外用户能直接用上的相对少。
- 功能铺得很宽:第一次打开控制台,侧边栏一长串。建议先建一个通用助手、接一个微信或飞书通道用起来,再逐步打开其他功能。
总结
Octop 适合想在自己机器上给家庭或小团队搭 AI 助手的场景:多用户隔离、每人一组专家、在微信飞书群里直接 @,数据留在本地;对开发者来说,ACP 让它既能把编码任务派给 Claude Code、Codex,也能作为 Zed 里的 Agent 使用。
给 Octop 的专家或它调用的 Claude Code、Codex 配模型时,可以直接用 AIGoCode 的接口。
参考链接
- Octop 项目地址:https://github.com/TencentCloud/Octop
- Octop 官网:https://octop.cloud
- ACP 文档:https://github.com/TencentCloud/Octop/blob/main/docs/acp.md
- Agent 运行时 octop-harness:https://github.com/TencentCloud/octop-harness