octo-server

自托管 AI 协作后端，让智能体融入团队聊天

octo-server 是 OCTO 开放工作平台的后端核心，用 Go 编写，为人类与 AI 智能体的协作提供基础设施。它解决的是企业或团队在自托管环境下，如何将 AI 智能体无缝集成到日常沟通与协作流程中的问题。项目提供 REST 和 WebSocket API 用于客户端接入，内置 Lobster AI 智能体的编排能力，并集成 WuKongIM 作为实时消息控制平面，实现消息路由、状态管理和智能体调度。其核心能力包括：统一的 API 网关、实时双向通信、智能体生命周期管理，以及基于 Apache 2.0 许可的自托管部署方案。通过将即时通讯与 AI 代理结合，octo-server 旨在构建一个开放、可扩展的数字工作空间，让团队能自定义 AI 协作流程，而非受限于封闭的商业平台。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1062

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队Mininglamp-OSS

所属国家

官网地址https://github.com/Mininglamp-OSS

GitHubhttps://github.com/Mininglamp-OSS/octo-server

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型ai-agents,apache2,chat,collaboration,digital-workplace,go,golang,im,instant-messaging,lobster,openclaw,rest-api,self-hosted,websocket,wukongim

GitHub 星标★ 1062

30天Star增速

HF 下载量

上线时间2026-05-11 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：进阶约 20 分钟部署方式：本地安装 6 步

环境要求

Go 语言环境（README 使用 go build 编译，未指定具体版本）
MySQL 兼容的数据库实例
本地运行的 WuKongIM 实例（默认开发配置要求）
已准备好的配置文件 configs/tsdd.yaml

安装与启动步骤

1克隆仓库

把 octo-server 源码拉到本地，README 的 Quickstart 第一步就是克隆官方仓库。
```
git clone https://github.com/Mininglamp-OSS/octo-server.git
```
2进入项目目录

切换到克隆下来的源码目录，后续编译和启动都在这里执行。
```
cd octo-server
```
3编译服务

用 Go 直接编译出可执行文件 octo-server，README 未说明版本要求，建议使用较新的 Go。
```
go build -o octo-server .
```
4准备运行依赖

默认开发配置需要本地 WuKongIM 实例和 MySQL 兼容数据库，请先启动它们并确认连接信息正确。
5检查配置文件

确认仓库自带的 configs/tsdd.yaml 模板已按你的数据库和 WuKongIM 地址改好，再用于启动。
6启动服务

以 tsdd.yaml 为配置启动 octo-server，进程正常运行即代表后端已起来。
```
./octo-server --config ./configs/tsdd.yaml
```

关键配置

配置项	必填	说明	示例
`configs/tsdd.yaml`	是	服务启动配置模板，内含 WuKongIM 与数据库等连接配置	`./configs/tsdd.yaml`

如何确认成功

执行启动命令后进程持续运行且无报错，客户端可通过 REST 与 WebSocket 接口连上服务。

常见问题

Q：启动时报数据库连接错误怎么办？

A：检查 configs/tsdd.yaml 中 MySQL 兼容数据库的地址、账号、库名是否正确，并确认数据库已启动。

Q：必须单独部署 WuKongIM 吗？

A：README 说明默认开发配置需要一个本地 WuKongIM 实例，它承担实时消息控制平面，未就绪时服务无法完整工作。

Q：想一条命令拉起整套平台怎么办？

A：使用官方 OOTB 部署仓库 Mininglamp-OSS/octo-deployment，其中包含 server、admin、web、WuKongIM、MySQL、Redis、MinIO、nginx 的 Docker Compose 栈。

Q：编译失败或跨仓库构建有问题？

A：README 指向仓库内的 BUILDING.md 查看跨仓库构建说明，QUICKSTART.md 提供端到端操作指引。

注意事项

README 未给出端口号、数据库名、默认账号等细节，请查阅仓库内 QUICKSTART.md 与 configs/tsdd.yaml 模板。
旧版 docker/octo/ 和 docker/tsdd/ 的 Compose 编排已废弃，官方推荐统一使用 octo-deployment 仓库。
本项目采用 Apache 2.0 许可，可自托管部署。
octo-server 是 OCTO 平台后端，前端与管理端分别为 octo-web、octo-admin。

核心亮点

Go 高性能后端，支持 REST 与 WebSocket 双 API，适合实时协作场景
深度集成 WuKongIM，提供成熟的消息控制平面，降低自研 IM 成本
Apache 2.0 许可，完全自托管，数据主权可控，适合企业私有化部署

不足之处

早期项目，文档和社区生态尚待完善
依赖 WuKongIM 和 Lobster 等外部组件，部署复杂度较高

适用场景

企业自建内部协作平台，需要 AI 助手参与工作流
开发者构建自定义聊天机器人或智能体编排系统
团队希望将 AI 能力嵌入即时通讯，但不想依赖商业 SaaS

替代项目

Rocket.Chat、Mattermost、Zulip

项目介绍

octo-server 是智能体领域的开源项目，由 Mininglamp-OSS 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,062）位列前 30%，在智能体分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可自行部署，完全免费。

它主要面向的使用场景是：企业自建内部协作平台，需要AI助手参与工作流。同类可对比的替代方案包括 Rocket.Chat、Mattermost、Zulip。

上一篇：docmancer

下一篇：agents-shipgate