首页 产品 为什么选 OCTO 解决方案 文档 关于
文档中心 / 产品指南 / 开源版与高级服务
← 返回文档中心

开源版与高级服务

OCTO 文档中心 · 产品指南
  • 01-product/核心能力概览.md v2.0（16个能力域）
  • 02-architecture/OCTO全组件服务清单.md v0.1
  • 03-deployment-ops/OCTO部署形态总览.md v1.1
  • 01-product/模块说明/各模块v0.2-v0.3文档
  • source-repos/octo-deployment（开源部署仓库）
  • source-repos-internal/octo-deployment（内部部署仓库docker-compose.yaml/helm values）

开源版与内部版差异对照 v0.1

用途：售前/交付快速对照OCTO开源版（GitHub Apache 2.0）与内部版（明略商业授权）的能力差异，明确各能力域的profile开关和默认状态，帮助交付时按需选择开启哪些模块。

重要口径：开源版已包含完整企业IM + Bot/AI Agent基础能力，可独立用于企业内部IM + AI Bot场景；内部版扩展模块（文档/网盘/回路/市场/语音/摘要/搜索/我的）需明略商业授权。

一、能力域差异总表

# 能力域 开源版（GitHub, Apache 2.0） 内部版（商业授权）模块名 Profile开关 默认开启 备注
1 即时消息IM ✅ 完整支持（文本/富文本/图片/文件/语音消息type=4/视频/typing/已读/编辑） 同开源版 —（默认启动） ✅ WuKongIM v3底座，WS/TCP直连
2 群组Group ✅ 完整支持（创建/管理/公告MD/加人踢人） 同开源版 — ✅ Bot加群后是普通成员，非超管
3 Thread/子区 ✅ 完整支持（创建/列出/详情/删除/成员/join/leave/归档/MD） 同开源版 — ✅ channel_type=5独立channel
4 文件与附件 ✅ 支持（presigned URL上传/下载，S3兼容存储，默认100MB，魔数校验） 同开源版（IM消息附件）；另有独立网盘模块 — ✅ IM附件≠Drive网盘
5 Bot/开放API ✅ 完整Bot API（/v1/bot/*）+ OBO + OpenAPI OAuth + Incoming Webhook + 出站Webhook(HMAC) 同开源版；另有内部版独有Bot能力 — ✅ 双token模型；8套API分类；内部版增加文档@Mention/语音纠错/OBO搜索等
6 卡片消息 ✅ 支持（展示卡/交互卡/进度卡/模板卡，客户端profile降级） 同开源版 — ✅ 服务端profile决定能力
7 OIDC SSO/权限安全 ✅ 支持（RBAC+ACL+opaque token+HMAC签名） 同开源版 — ✅ Bot普通成员权限模型
8 AI Agent集成（基础） ✅ Agent一等公民架构（Bot API + openclaw-channel-octo插件接入） 同开源版；另有回路Loop多Agent协作层 — ✅ 开源版=消息→Bot→回复基础链路
9 Admin管理后台 ✅ octo-admin（用户/空间/Bot管理） 同开源版 — ✅ 无独立/admin前缀API，走后台UI
10 文档协同（Docs） ❌ 仅群/Thread MD公告 ✅ Docs模块（Tiptap+Yjs+Hocuspocus实时协同，5类表面：富文本/表格/白板/HTML/PPT） docs + docs-html（HTML文档，依赖docs） ❌ Web左侧「文档」入口；docs_on门控；Bot评论@Mention链路（仅User Bot）；PPT协作v2026.09.14
11 企业网盘（Drive） ❌ 仅IM消息附件（chat/file bucket） ✅ Drive模块（个人+共享空间、分享/转存/文档挂载/全文搜索） drive ❌ ⚠️ 仅Web端；drive_on门控；MinIO独立bucket octo-drive
12 回路Loop/Fleet（项目管理+AI协作+运行时） ❌ ✅ Fleet模块（Loop项目管理+AI协作+Daemon本地运行时+Bot编排） fleet(+fleet-db内置PG) ❌ ⚠️ 仅Web端；dmloop.enabled门控；唯一使用PostgreSQL 16的模块；octo-daemon npm包本地运行时
13 市场Marketplace ❌ ✅ Marketplace模块（技能包+专家+专家团+插件分发市场） docker-compose默认启动（无profile）；helm marketplace.enabled=false⚠️ ⚠️ docker默认/helm待确认 Web两个承载面：专家市场+插件市场；Bot不分发
14 智能语音Speech（ASR） ❌（仅语音消息type=4基础收发） ✅ Speech模块（ASR双链路：语音输入全端+语音消息自动转写；4种引擎Gemini/GPT/Qwen/本地） speech ❌ 全端支持；用户opt-in；@mention识别/情感emoji；Bot语音纠错API；TTS待验证(P1)
15 智能摘要Summary ⚠️ octo-smart-summary旁路服务镜像存在但能力有限（开源版未完整文档化） ✅ Summary模块（消息/会话智能总结，手动/✨一键/定时日周月/Agent触发三种方式；map-reduce长会话；SSE流式） summary ❌ 全端（Web最全）；直读MySQL不依赖搜索；需配LLM Key（默认claude-sonnet-4-6）
16 全文搜索Search ⚠️ messages_search模块代码存在但Kafka+OpenSearch完整管道为内部版 ✅ Search模块（Kafka+OpenSearch+IK中文分词近实时NRT三层管道，覆盖消息+云文档正文+网盘文件全文） search + doc-index(依赖docs+search) + drive-index(依赖drive+search，含Tika) ❌ 消息搜索尊重权限；Bot OBO搜索；5QPS限流；开源版有代码框架但需完整基础设施
17 我的/个人中心（Loop部分） ❌（基础设置属octo-server内置） ✅ 运行时+Skills管理（添加电脑=Loop Runtime、技能包管理、专家/专家团、自动化） 归dmloop.enabled门控（与Loop一致） ❌ ⚠️ 仅Web端（移动端确认无回路）

二、基础设施差异

基础设施 开源版最小集 内部版额外需求
MySQL ✅ 8.x（3库：octo/octo_matter/octo_summary） +4个可选库：octo_speech/octo_docs/octo_marketplace/octo_drive
PostgreSQL ❌ 不需要 Fleet专用（内置postgres:16-alpine或外接）
Redis ✅ 7.x（DB 0，缓存/会话/bot_task） DB 1（Fleet专用）
MinIO/S3 ✅（10个bucket：file/chat/moment/sticker/report/chatbg/common/download/group/avatar） +3个bucket：octo-docs-attachments/marketplace/octo-drive
Kafka ❌ 不需要 search profile需要（KRaft单节点3.8.0），7个topic
OpenSearch ❌ 不需要 search profile需要（2.17.0+IK中文分词定制版），3个索引
Tika ❌ 不需要 drive-index profile需要（3.3.0.0文本提取）
外部LLM API ❌ 基础IM不需要 summary必须配（默认claude-sonnet-4-6，可配置）
语音引擎API ❌ 不需要 speech需配（Gemini/GPT/Qwen/本地四选一）

三、最小部署对比

维度 开源版 内部版（全模块）
最小生产7件套 octo-server + octo-web + octo-admin + WuKongIM + MySQL 8 + Redis 7 + MinIO 同左
额外容器数 — +约25-30个容器（summary-api/worker/speech/speech-admin/docs-backend/docs-html/drive/drive-config/fleet/fleet-postgres/marketplace/kafka/opensearch/es-indexer/doc-indexer/drive-indexer/tika等+init/migrate/preflight一次性容器）
额外内存估算 — Kafka+OS约1-2GiB；其他旁路服务各约50-200MiB（idle轻载参考值，非容量规划）
额外磁盘 — OpenSearch索引+Kafka日志+语音PVC（具体容量视数据量）
额外端口 28080(HTTP)/28443(HTTPS) 不需额外开放防火墙端口（所有服务经nginx路由）；loopback可访问28087-29200等

四、售前口径指南

开源版能演示什么

  1. ✅ 企业级IM即时通讯（消息/群/Thread/文件/已读/typing）
  2. ✅ Bot/AI Agent接入（Bot API、OpenClaw插件、卡片消息）
  3. ✅ 群组协作（群公告MD、成员管理、Bot协作）
  4. ✅ OIDC SSO企业身份集成
  5. ✅ 文件上传/下载（S3兼容存储直传）
  6. ✅ Incoming/出站Webhook系统集成
  7. ✅ 私有化部署（单机Docker Compose / K8s）
  8. ✅ 管理后台（用户/空间/Bot管理）

开源版可以独立用于「企业内部IM + AI Bot助手」场景，是完整可运行的产品。

内部版额外提供什么

客户需求 开启模块 额外前提
多人实时协作文档（类Notion/飞书文档） docs + docs-html 无额外中间件（复用MySQL/Redis/MinIO）
企业网盘（个人+团队文件空间） drive MinIO octo-drive bucket（自动创建）
AI项目管理/多Agent协作/本地电脑接入 fleet + fleet-db PostgreSQL 16（内置或外接）
技能/插件/专家市场分发 marketplace 默认启动（docker）
语音消息转写/语音输入 speech 语音引擎API Key（Gemini/GPT/Qwen/本地）
智能会话总结（一键/定时/AI驱动） summary LLM API Key
全文搜索（消息+文档+网盘文件内容） search + doc-index + drive-index Kafka + OpenSearch（~2GiB额外内存）；drive-index需Tika
运行时管理/Skills（添加电脑/技能包） （随fleet+dmloop.enabled） Fleet已启前提下可用

交付时如何选择开启哪些profile

  1. 先跑核心7件套，验证IM/Bot/文件/SSO基础功能
  2. 按客户需求逐个启用模块（不需要的模块不要开，减少资源消耗和运维复杂度）
  3. 独立旁路先开：summary和speech是独立旁路（不依赖其他opt-in模块），可以优先启用
  4. 文档/网盘按需：docs和drive是各自独立的模块，互不依赖（但drive可挂载docs云文档）
  5. 搜索放最后：search是重资源模块（Kafka+OS），需要额外内存，且必须跑search-upgrade.sh初始化，建议客户明确需要全文搜索时再启用
  6. 回路/Fleet评估客户成熟度：Loop/Fleet是面向AI-native团队的多Agent协作功能，需要用户本地安装octo-daemon，建议在有明确AI协作需求时启用
  7. Marketplace：docker-compose默认启动，如果客户不需要技能市场可手动禁用（待确认禁用方式）

售前红线

  • ❌ 不承诺开源版有文档/网盘/回路/语音/摘要/搜索——这些是内部版独有能力
  • ❌ 不承诺所有功能全端可用——Drive/Loop/运行时/Skills/Admin明确仅Web端
  • ❌ 不承诺内部版模块全部默认开启——除Marketplace(docker)外均opt-in，需管理员配置
  • ⚠️ Summary必须配LLM API Key才能实际生成摘要（Key可占位启动但不可用）
  • ⚠️ Search是近实时(NRT)，不承诺毫秒级实时搜索
  • ⚠️ Fleet必须使用PostgreSQL（不可用MySQL替代）
  • ⚠️ 语音数据保留策略/Tika OCR能力/Drive Bot API等标"待确认"的项，源码验证前不承诺

五、版本授权说明

项目 开源版 内部版
代码仓库 github.com/Mininglamp-OSS/octo-*（公开） 内部部署仓库（hub2.intra.mlamp.cn镜像）
协议 Apache 2.0 明略商业授权
核心IM ✅ 完整 ✅ 同左
内部模块镜像 ❌ 无（mininglamposs/octo-docs-backend等内部镜像在公开Docker Hub不可见） ✅ 通过商业授权获取
文档协同/网盘/回路/市场/语音/摘要/搜索 ❌ ✅

六、版本记录

  • v0.1（2026-09-21）：基于核心能力概览v2.0+全组件服务清单v0.1+部署形态总览v1.1+各模块v0.2-v0.3文档新建；17个能力域对比表+基础设施差异+最小部署对比+售前口径指南+授权说明
← 返回文档中心