TECHNICAL WHITEPAPER · 多智能体平台部署

Octop多智能体平台
部署白皮书

基于腾讯云开源 Octop 平台（前身 LightClaw ACE，MIT 协议），自托管多用户 AI 助手系统。已在云端真实部署并持续运行，本文档含实测运行数据、五维能力架构与产品化服务方案。所有状态均来自线上真实验证。

云端已部署运行多用户自托管零成本接入 Ω₀⊂⊙∞⊂Ω · DID-BR-000002

一、平台定位

Octop 是腾讯云开源的自托管多智能体平台（MIT 协议），作为火斗云智 AIOS 的对外智能交互窗口。核心价值：一个可被外部用户直接访问、多账号登录、多智能体并行、自动路由最优大模型的 AI 助手服务，且完全自托管、数据自主。

二、实测运行状态（2026-10 线上验证）

以下为 octop.huodouai.com 线上接口实测返回，作为白皮书事实基底。

200

HTTP 可达

已载入用户

运行中智能体

~213MB

总内存占用

端点	HTTP	说明
/	200	品牌化前端首页
/api/health	200	返回 ok=true / db=true / users_loaded=3 / agents_running=20
/register	200	多用户注册入口
/login	200	登录入口
/docs	200	API 文档
/api/agents	401	需认证（鉴权正常）

curl -s https://octop.huodouai.com/api/health
{"ok":true,"started_at":1792044686,"db":true,"users_loaded":3,"agents_running":20}

三、五维能力架构

能力	实现	状态
多用户注册登录	JWT 认证 + SQLite 用户表	线上可用
多智能体对话	智能体工作区 + 独立会话	20 智能体并行
多模型自动路由	wrapper(18080) OpenAI 兼容 Provider	router 自动择优
自定义智能体配置	可视化配置 + SQLite 持久化	线上可用
定时任务自动巡检	后台调度器定时执行系统巡检	已纳入体系调度

四、部署架构

用户浏览器
  ↓ https://octop.huodouai.com
Nginx 443 SSL (复用正式证书)
  ↓ proxy_pass
Octop Server (8088, Python/FastAPI)
  ├── 用户认证 (JWT)
  ├── 智能体管理 (SQLite)
  ├── Provider配置
  └── 对话引擎
  ↓
wrapper API中转 (18080)
  ↓
外部大模型 (商汤/书生/豆包 · 免费API)

五、智能体矩阵

智能体	ID	用途
元极恒一	69KBS2	核心内核助手，公理校验
工单助手	EZAS40	任务执行调度
真值管理	MTS5NQ	记忆检索与沉淀
运维巡检	JVFTVH	系统状态监控
小通	main	默认通用助手

六、定时任务自动巡检

在体系后台调度器中对 octop 执行周期性健康巡检：探测 /api/health 返回的 db、users_loaded、agents_running 指标，异常时记录阻塞表并告警。巡检脚本零成本、轻量，复用体系既有心跳与调度能力，不启动常驻额外进程。

巡检策略：健康可达(HTTP200) + 内容特征(ok=true/db=true) 双条件判定；数据库异常或智能体数异常下降即触发告警，保障 7×24 对外可用。

七、品牌定制

标题： Octop → 火斗云智AIOS · 元极恒一
Logo： Octop 章鱼 → 金色 Ω 圆环
主题色： 红色 → 金色 #d4af37
域名： octop.huodouai.com (DNSPod A 记录)
入口： 官网「产品服务」直达

八、部署步骤与 Provider 配置

8.1 一键安装

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

8.2 systemd 服务

octop service start
# 自动创建 /etc/systemd/system/octop.service
# 监听 0.0.0.0:8088

8.3 Provider 配置（wrapper OpenAI 兼容）

参数	值
名称	zongyuan
类型	openai
Base URL	https://127.0.0.1:18080/v1
模型	router / doubao / sensenova

九、实战踩坑记录

坑1： 自签名证书不被 Octop 信任 → 复用已有正式证书
坑2： SPA 前端绝对路径导致子路径反代 404 → 用独立子域名
坑3： 浏览器 HSTS 强制 HTTPS → 必须配 SSL 证书
坑4： Octop provider test 命令有 bug → Web UI 内实际可用
坑5： acme.sh DNS 验证需 DNSPod Token → 手动加 A 记录 + 复用证书

十、产品化服务方案

方案	内容	定位
免费试用	注册即用，多智能体对话、多模型路由	体验入口
标准部署	自托管多用户系统 + 品牌定制 + 巡检	轻量团队版
企业定制	智能体矩阵定制 + 知识库接入 + 高可用	深度集成

多用户自托管多智能体多模型路由自定义配置定时巡检

零成本内核：后端走免费 API（商汤/书生/豆包），自托管无云厂商依赖，数据自主可控。

Octop多智能体平台部署白皮书