# 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/`
- 完全本地运行，隐私有保障
- 支持工具权限管理
---
*文档生成时间：2026-08-07*