Octop 开源 Agent 框架详解

来自腾讯云的自托管 AI 助手平台

🐙 Octop 是什么？

Octop 是腾讯云开源的一个自托管 AI 助手，定位是"更聪明、更自立的 AI 助手"——支持多用户、多 Agent 协作。

🔗 GitHub: https://github.com/TencentCloud/Octop

✨ 核心特性

特性说明
🏠 完全自托管数据留在本地，隐私有保障
👥 多用户支持团队、家庭、个人都能用
🤖 多 Agent 架构可同时运行多个专业 Agent
📱 多渠道接入Web 控制台、飞书、钉钉、QQ、Discord、企业微信
🔌 MCP + ACP 集成生态扩展能力强
⚡ 单进程启动轻量高效

🛠️ 技术栈

层级技术
语言Python 3.12+
Web 框架FastAPI + uvicorn
Agent 运行时Harness Agent
前端React 18 + TypeScript + Vite + Ant Design
数据库SQLite (WAL 模式)
调度APScheduler

🧠 它是怎么工作的？

Octop 底层基于 Harness 技术栈构建——一套专注于 AI Agent 的运行时集合。

它的架构大概是这样的：

┌─────────────────────────────────────────────┐
│              Octop Server                   │
├─────────────────────────────────────────────┤
│  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │  Web    │  │   IM    │  │  Cron   │    │
│  │Dashboard│  │(飞书/钉钉│  │ 定时任务 │    │
│  └────┬────┘  └────┬────┘  └────┬────┘    │
│       │            │            │          │
│       └──────────┬─┴────────────┘          │
│                  ▼                          │
│         ┌─────────────────┐                │
│         │ HarnessProcessor │ (单一进程)      │
│         └────────┬────────┘                │
│                  ▼                          │
│    ┌─────────────────────────────┐         │
│    │     Agent / Gateway / DB    │         │
│    └─────────────────────────────┘         │
└─────────────────────────────────────────────┘

所有渠道（Web、IM、定时任务）都通过同一个 HarnessProcessor 路由，整个服务是一个可重启的单进程，启动时从 ~/.octop/octop.db 恢复全部状态。

📦 你能用 Octop 做什么？

  1. 个人 AI 助手 — 定制化 Agent，处理日常任务
  2. 团队协作 — 多用户、多 Agent 分工
  3. 自动化工作流 — 定时任务、IM 触发
  4. 二次开发 — 基于 MCP/ACP 集成自己的工具

🌟 和其他 Agent 框架的区别？

框架定位特点
Octop自托管多用户助手开源、腾讯背书、IM 集成强
LangChain/LangGraph开发者框架生态最全、学习曲线陡
AutoGen多 Agent 编排微软开源、灵活
CrewAI角色扮演 Agent简单易用、适合原型
Dify低代码平台可视化、闭源商业化

🚀 怎么上手？

官方文档很完善，主要步骤：

  1. 克隆仓库
  2. 配置 Python 3.12+ 环境
  3. 启动服务 (make dev 或 docker-compose)
  4. 通过 Web UI 或 IM 渠道接入

📁 项目结构

octop/
├── src/octop/           # 核心代码
│   ├── config.py        # 配置
│   ├── launch.py        # 启动入口
│   └── infra/          # 业务核心 (agents, gateway, cron, db, users)
├── api/                 # HTTP 层 (FastAPI)
├── cli/                 # CLI 层 (Click)
├── dashboard/          # 前端 React SPA
├── docker/              # Docker 配置
└── tests/               # 测试

🔐 安全与隐私

  • 数据存储在 ~/.octop/
  • 完全本地运行，隐私有保障
  • 支持工具权限管理

本文整理自腾讯云 Octop 项目资料