工具介绍
关于 Octop 的定位、能力与适用场景
Octop 是腾讯云开源的自托管 AI 助手,MIT 协议,仓库已有 12.2k 星。它把「多用户 + 多智能体」做成原生能力:一个 Python 进程同时提供 Web 控制台、命令行、IM 通道和定时任务,所有对话、工作区与凭据都留在本机 ~/.octop/ 目录里。
一个进程,四个入口
octop run 启动后,Web 控制台跑在 8088 端口,CLI 提供 octop chats 这类交互式会话,飞书、钉钉、QQ、微信、企业微信、Telegram、Discord 等 IM 通道共用同一条消息处理管线,cron 负责定时任务。控制面数据库默认 SQLite(WAL),也可以换成 PostgreSQL;重启后状态从数据库重建,不需要额外的消息队列。
专家、人格与 AgentTeams
每个用户可以建多个专家,每个专家有独立的工作区、模型供应商、通道和定时任务。内置专家库在启动时扫描,支持部署内共享和专家市场;16 种 MBTI 人格模板加一套互动测试,让不同专家有各自的说话方式。AgentTeams 目前是 Beta:一个协调者按多步任务调度多个专家,适合把调研、执行、复核拆给不同角色。
连接器、知识库与记忆
Connectors 用 OAuth 和 MCP 两种方式扩展边界,内置腾讯文档、腾讯会议、Notion、TickTick、OpenAlex、飞书 CLI、企业微信 CLI、Agent Mail、Obsidian、WeKnora、Dify 等。知识库走 RAG,可以索引自己的文档并在部署内共享语料。记忆由 Octop Memory 负责,分层召回加全文检索,跟着工作区一起迁移。
ACP 与三种工作台
ACP 是双向的:octop acp --agent main 把自己变成 stdio ACP 服务器,供 Zed、OpenCode 调用;反过来,Octop 也能把任务派给 OpenCode、CodeBuddy、Claude Code、Codex 这些外部编码 Agent。工作台方面,终端 AI+ 在浏览器里跑交互式 shell,浏览器 AI+ 用无头 Chromium 做网页自动化与截图,远程桌面则把宿主机的屏幕和输入搬到控制台。
自托管与安全
安全侧做了四件事:JWT 多用户隔离、工具调用审批、可编辑的 shell 命令护栏、以及数据离开工作区前的 PII 脱敏。工作区文件可以放本地磁盘、Docker 沙箱、PostgreSQL 或 COS/S3,和控制面数据库分开。桌面端覆盖 Windows、macOS、Linux,另有 FnOS NAS 安装包。
安装与生态
macOS / Linux 一行脚本、Windows 用 PowerShell 一行,安装器会用 uv 在 ~/.octop/venv 建独立环境,不碰系统 Python;也可以 pip install octop、Docker Compose 或 Helm。升级用 octop update,数据库、工作区、密钥和配置都会保留。底层拆成 Octop Harness(Agent 运行时)、Octop Gateway(IM 桥)、Octop Memory、Octop Browser 四个项目,想二次开发可以从这些仓库入手。


