TencentCloud/Octop:自托管多用户多智能体助手
给家庭和小团队用的自托管多智能体助手,把 Web、IM、CLI 和自动化集中到一个进程。
GitHub TencentCloud/Octop 更新 2026-09-18 分支 main 星标 3.4K 分叉 358
Python TypeScript 自托管 AI 助手 多用户多智能体 ACP Browser AI+ macOS/Linux/Windows

🧭 决策指南

适合,如果你

  • 你需要一个管理员管理多个家庭成员和不同专家 Agent
    README Overview 的 Family sharing,以及 Highlights 的 Multi-user expert team
  • 你的团队通过 Feishu、DingTalk 或 WeCom 分发任务
    README Overview 的 Team helper 和支持渠道列表
  • 你想从 IDE 或终端把编码任务交给 OpenCode 或 Claude Code
    README Highlights 的 ACP bidirectional 和 Developer boost
  • 你需要在本机保留对话、凭证和工作区数据
    README Overview 的 self-hosted 设计与 `~/.octop/` 控制平面数据库

不适合,如果你

  • 你现在必须使用 Shared resource pool 或 Expert sharing
    README Roadmap 将 Shared resource pool 和 Expert sharing 标记为 `[ ]`
  • 你需要官方已说明的原生桌面或移动客户端
    README Roadmap 将 PC / mobile clients 标记为 `[ ]`
  • 你不接受远程安装脚本直接执行 `curl` 或 `irm`
    README Quick Start 提供 `curl ... | bash` 和 `irm ... | iex`
  • 你的模型供应商不在 OpenAI-compatible、DashScope 或 Ollama 等预设范围内
    README Configuration 的 Supported LLM providers 只列出这些预设类型

前置条件

  • 支持 macOS、Linux 或 Windows;README 提供对应安装脚本
  • 可使用 PyPI 的 `pip install octop`,或从源码执行 `uv sync --extra local-embedding`
  • 运行入口为 `octop run`,默认访问 `http://127.0.0.1:8088`
  • Docker 首次初始化会将凭据写入 `/data/.octop/credential.txt`;交互式密码要求至少 8 位且包含字母和数字
  • 默认控制平面数据库为 SQLite,PostgreSQL 为可选后端

第一步命令(README 原文)

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash

要注意

  • 安装后需打开新终端或加载 `~/.zshrc`、`~/.bashrc`
    README Quick Start 的安装后说明
  • Browser AI+ 需额外安装 Playwright Chromium
    README Install 的 `--extras browser` 命令
  • Feishu 支持不是默认安装项,需使用 `--extras channels-feishu`
    README Install 的 Feishu channel support 命令
  • 自定义监听地址会使用 `octop run --host 0.0.0.0 --port 8088`
    README Run 的 Custom host / port 示例

替代方案

  • OpenCode / Claude Code:只需要编码代理,而不需要 Octop 的多用户、IM 和 cron 控制平面时
    README 的 ACP bidirectional 与 Developer boost
  • Ollama:需要单独运行本地 LLM 服务,而不是部署完整的 Octop Dashboard、IM 和 Agent 环境时
    README Configuration 的 Supported LLM providers

材料未说明

  • README 节选未说明支持的具体 LLM 模型名称、上下文限制和模型费用
  • README 节选未说明 Browser AI+、Remote desktop 和多 Agent 并行运行的资源需求
  • README 节选未说明 Feishu、DingTalk、WeCom 等渠道的详细配置步骤和权限范围
  • README 节选未说明 v1.0.0 对各操作系统、Docker 和 PostgreSQL 的兼容矩阵
  • README 节选未提供完整的 Server & auth、Security & privacy 和 Docker production 文档
  • README 节选未说明 ACP 与 OpenCode、Claude Code 的具体版本要求

💡 深度解析

6
适合 我已经使用 OpenCode 和 Claude Code,希望通过 ACP 把任务交给 Octop,并让它执行浏览器操作和 Shell 命令;这个方案是否适合开发辅助?
适合读者: 使用 OpenCode 或 Claude Code,并希望从终端调用浏览器和 Shell 自动化的开发者

适合,但更适合受权限门控的开发辅助,而不是无审批的无人值守执行。

  • README Highlights 提供 octop acp,可与 OpenCode、Claude Code 双向协作,并明确带有 permission gates。
  • 同一章节列出 Terminal AI+,支持浏览器中的交互式 Shell、AI 辅助命令执行和故障排查。
  • Browser AI+ 基于无头 Chromium,可进行网页自动化、截图和远程浏览;这使表单填写、资料收集等任务具备直接执行能力。
  • Security built-in 列出工具审批和 Shell command guardrails;项目洞察还指出浏览器、终端和 ACP 若权限配置不当,可能误删文件、泄露凭证或产生非预期外部操作。

因此,Octop 能覆盖你的工具链,但 ACP、Shell 和浏览器应被视为高权限执行面,而不是普通聊天插件。

  • README Highlights:"`octop acp` for IDE/terminal AI; delegate to OpenCode / Claude Code with permission gates"
  • README Highlights:"Terminal AI+";"AI-assisted command execution and troubleshooting"
  • README Highlights:"Browser AI+";"Headless Chromium sessions for web automation, screenshots, and remote browsing"
  • README Highlights:"tool approval";"shell command guardrails"
octop run
材料未说明:README 未提供 ACP 的具体权限策略、工作目录限制或每种工具的默认审批行为;README 未说明 OpenCode、Claude Code 版本兼容矩阵以及浏览器自动化对网站反爬机制的处理范围
适合 我想让一个管理员为家庭成员提供飞书、钉钉和企业微信入口,同时保留各自的账户、会话和专家配置;Octop 是否适合?
适合读者: 希望由一个管理员服务家庭成员,并通过飞书、钉钉或企业微信共享 AI 的家庭用户

适合:多用户、家庭共享和多渠道接入正是 Octop README 明确展示的使用方式。

  • Highlights 将功能定义为“Multi-user expert team”,支持一个管理员和共享家庭,并提供按场景切换的专家库。
  • Security built-in 列出 JWT multi-user isolation、工具审批、Shell 命令护栏和 PII 脱敏;Overview 还说明每个用户可以拥有个人的专业智能体团队。
  • README 明确列出 Feishu、DingTalk、QQ、Discord、WeCom,以及 Web Dashboard、CLI 和 HTTP/SSE/WebSocket 入口。
  • 项目洞察提醒,多用户隔离不等于插件、外部服务和宿主机资源天然隔离;如果家庭成员共用工作区、专家或凭证,隐私边界会被削弱。

所以它适合家庭共享基础设施,但账户隔离仍需配合独立工作区和凭证管理。

  • README Highlights:"Multi-user expert team";"One admin, shared household"
  • README Highlights:"JWT multi-user isolation, tool approval, shell command guardrails, and PII redaction"
  • README Overview:"Feishu, DingTalk, QQ, Discord, WeCom";"each user a personal team of specialized agents"
  • 项目洞察 user_experience.common_pitfalls:共享工作区、专家或凭证可能削弱隔离
octop run
材料未说明:README 未给出家庭成员数量上限、每用户权限粒度或不同渠道身份映射的具体规则;README 未说明插件和连接器是否完全继承 JWT 用户隔离
适合 我需要对私有文档做 RAG,并希望使用本地 ONNX embedding、让长期记忆随工作区迁移;Octop 是否适合构建个人知识助手?
适合读者: 维护私有文档知识库、希望使用本地 ONNX embedding 并让长期记忆随工作区迁移的技术型用户

适合:私有文档 RAG、本地 embedding 和可迁移长期记忆都对应 Octop README 的明确能力,但答案质量仍取决于检索与记忆配置。

  • Highlights 将 Knowledge base 定义为对文档执行 RAG,通过语义检索让智能体基于 private corpus 作答。
  • Portable memory 说明长期记忆由 harness-memory 提供,并随 workspace 迁移;这比把记忆锁定在单个聊天界面更适合持续使用。
  • Quick Start 提供可选的 octop[local-embedding],并说明模型目录位于 ~/.octop/embedding_models,同时明确它不是聊天模型或 Memory。
  • 项目洞察提醒,文档分段、嵌入模型、召回率、记忆污染和上下文限制都会影响结果;README 未提供私有文档规模或召回评测指标。

因此,Octop 的组件匹配度很高,但不能把启用 RAG 或 Memory 等同于事实准确性。

  • README Highlights:"Knowledge base";"RAG over your documents";"private corpus"
  • README Highlights:"Portable memory";"Powered by harness-memory; memory migrates with the workspace"
  • README Quick Start:`pip install "octop[local-embedding]"`;"Downloads catalog weights under ~/.octop/embedding_models; not chat, not Memory"
  • 项目洞察 user_experience.common_pitfalls:RAG 和长期记忆受分段、嵌入、召回率和上下文限制影响
pip install "octop[local-embedding]"
材料未说明:README 未提供支持的 ONNX embedding 模型清单、语言覆盖和硬件要求;README 未提供知识库文档数量、索引规模、检索延迟或召回率基准
视情况 我在 Linux 上使用 Ollama,希望把聊天记录、工作区和凭证留在本机;Octop 是否适合替代云端 AI 助手?
适合读者: 在 Linux 上使用 Ollama、希望把对话和工作区数据留在本机的个人用户

视情况适合:Octop 的控制平面和运行数据适合本地部署,但是否完全不出网取决于模型与连接器配置。

  • README 的 Overview 明确说明它是 self-hosted,数据集中在 ~/.octop/,默认使用 SQLite;Highlights 还列出“data stays local”。
  • 项目洞察指出模型层支持 Ollama,因此可以选择本地模型;但使用 OpenAI 兼容 API、DashScope、OAuth 或 MCP 连接器时,请求数据可能离开本机。
  • 该项目最新版本是 v1.0.0,只有 5 个发布版本;README 没有给出 Ollama 的模型兼容矩阵、最低硬件要求或完全离线运行清单。

因此,它适合重视本地控制的个人,但不能仅凭 self-hosted 标签认定所有推理、嵌入和外部工具调用都离线。

  • README Overview:"self-hosted AI assistant";"all sharing one control-plane database under `~/.octop/` (SQLite by default; PostgreSQL optional)"
  • README Highlights:"Self-hosted";"data stays local"
  • 项目洞察 solution_analysis:模型层支持 Ollama、OpenAI 兼容 API、DashScope
  • 项目数据:latest_release 为 v1.0.0;release_count 为 5
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash
材料未说明:README 未提供 Ollama 的具体模型支持列表、显存或内存要求;README 未说明使用本地模型时是否仍会有默认的远程遥测、嵌入或连接器请求
视情况 我们是一个小团队,准备在同一个 Octop 进程里运行多个智能体、Web 控制台和 cron 任务;SQLite 是否足够,还是应该直接使用 PostgreSQL?
适合读者: 已使用 SQLite 起步、计划让小团队同时运行多个智能体和 cron 任务的内部支持团队

视情况:轻量共享部署可以从 SQLite 开始,但并发任务和数据规模上升后,README 已经提供 PostgreSQL 作为替代后端。

  • Overview 说明 Web Dashboard、CLI、IM 通道和 cron 共享一个控制平面数据库,SQLite 是默认选项,PostgreSQL 可选。
  • README 的架构定位是单进程,把控制台、命令行、IM 和定时任务统一起来,适合家庭和小团队,减少多服务编排。
  • 项目洞察明确指出 SQLite 适合轻量部署;高并发、多用户、较多自动化任务或较大知识库可能需要 PostgreSQL、独立存储和更完整的运维设计。
  • README 没有给出并发用户、任务数量、数据库大小或 SQLite 到 PostgreSQL 的迁移基准。

因此,小团队初期可采用默认数据库;如果 cron、IM 和多智能体调用会长期并发,PostgreSQL 更符合扩展方向,但不能由 README 推导具体容量阈值。

  • README Overview:"SQLite by default; PostgreSQL optional"
  • README Overview:"single process that serves a web dashboard, a CLI, IM channels ... and cron automation"
  • 项目洞察 solution_analysis.architectural_strengths:单进程设计适合个人及小团队
  • 项目洞察 user_experience.usage_limitations:SQLite 适合轻量部署,高并发或较大知识库可能需要 PostgreSQL
octop run
材料未说明:README 未提供 SQLite 和 PostgreSQL 的性能基准、并发限制或推荐切换条件;README 未说明数据库迁移、备份恢复和高可用配置的完整流程
视情况 我们的小团队成员分别使用 Windows、macOS 和 Linux,希望从 Octop Dashboard 查看屏幕并操作 GUI 应用;Octop 是否适合做跨平台远程办公自动化?
适合读者: 需要在 Windows、macOS 和 Linux 之间共享远程桌面 AI 工作流的小团队开发者

视情况:Octop 明确提供跨平台远程桌面能力,但 GUI 自动化是否稳定还取决于操作系统权限、显示环境和具体应用。

  • README Highlights 说明 Remote desktop 支持 Linux、Windows 和 macOS,可从 Dashboard 实时查看屏幕并进行输入操作。
  • README 还提到 headless Linux 支持“一键隔离桌面”,因此无显示器的 Linux 机器也有明确入口。
  • Browser AI+ 使用无头 Chromium,适合网页操作、截图和远程浏览;但原生 GUI 应用与浏览器自动化不是同一执行路径。
  • 项目洞察指出跨平台行为可能受系统权限、Chromium 依赖、显示环境、沙箱、网络认证和网站反自动化机制影响。

所以它适合统一入口和受控的远程操作,不足以证明所有 Windows、macOS、Linux GUI 应用都能稳定无人值守运行。

  • README Highlights:"Remote desktop";"Linux, Windows, and macOS";"Live screen and input from the dashboard"
  • README Highlights:"one-click isolated desktop on headless Linux"
  • README Highlights:"Browser AI+";"Headless Chromium sessions for web automation, screenshots, and remote browsing"
  • 项目洞察 user_experience.usage_limitations:跨平台行为受操作系统权限、显示环境、沙箱和网络认证影响
octop run --host 0.0.0.0 --port 8088
材料未说明:README 未说明各操作系统需要哪些屏幕录制、辅助功能或输入控制权限;README 未提供远程桌面的延迟、并发会话数、编码方式或断线恢复行为

✨ 核心亮点

  • 单进程提供 Dashboard、CLI、IM 与 cron
  • 支持 Feishu、DingTalk、QQ、Discord、WeCom
  • ACP 可委派 OpenCode 与 Claude Code
  • JWT 隔离、工具审批与 PII 脱敏内置
  • Shared resource pool 与 Expert sharing 仍在 Roadmap

🔧 工程化

  • 用 `octop run` 同时启动 Web、CLI、IM 和 cron
  • Browser AI+ 基于 Headless Chromium 做网页自动化
  • RAG 知识库从私有文档检索并支撑 Agent 回答
  • PostgreSQL、Docker、COS/S3 可作为后端

⚠️ 风险

  • 共享资源池和专家共享尚未实现,Roadmap 标为未完成
  • 安装脚本通过远程 curl 或 irm 执行
  • Docker 首次初始化会生成随机管理员密码文件
  • 模型仅列出 OpenAI-compatible、DashScope、Ollama 等预设

👥 适合谁?

  • 需要家庭共享和多用户 Agent 的小团队
  • 使用 Feishu、DingTalk 或 WeCom 的协作团队
  • 想把 OpenCode 或 Claude Code 接入 IDE 的开发者
  • 需要本地数据目录 `~/.octop/` 的自托管用户