README Overview 的 Family sharing,以及 Highlights 的 Multi-user expert team
TencentCloud/Octop:自托管多用户多智能体助手
给家庭和小团队用的自托管多智能体助手,把 Web、IM、CLI 和自动化集中到一个进程。
🧭 决策指南
为什么现在热: 无法从材料判断
适合,如果你
-
你需要一个管理员管理多个家庭成员和不同专家 Agent
-
你的团队通过 Feishu、DingTalk 或 WeCom 分发任务README Overview 的 Team helper 和支持渠道列表
-
你想从 IDE 或终端把编码任务交给 OpenCode 或 Claude CodeREADME Highlights 的 ACP bidirectional 和 Developer boost
-
你需要在本机保留对话、凭证和工作区数据README Overview 的 self-hosted 设计与 `~/.octop/` 控制平面数据库
不适合,如果你
-
你现在必须使用 Shared resource pool 或 Expert sharingREADME 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 ChromiumREADME 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
适合
我想让一个管理员为家庭成员提供飞书、钉钉和企业微信入口,同时保留各自的账户、会话和专家配置;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
适合
我需要对私有文档做 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]"
视情况
我在 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
视情况
我们是一个小团队,准备在同一个 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
视情况
我们的小团队成员分别使用 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
✨ 核心亮点
-
单进程提供 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/` 的自托管用户