Mininglamp-OSS/octo-server

这是什么？

核心功能

• 01提供会话、用户、群组、文件和组织相关的 REST 与 WebSocket 接口。
• 02支持 Lobster 智能体编排，包括路由、会话管理和工具调用执行。
• 03通过 WuKongIM 控制面客户端实现实时消息。
• 04支持组织感知的 RBAC、按频道的访问控制以及智能体身份校验。
• 05提供兼容 MySQL 的 SQL 迁移，并集成 Redis 与对象存储适配器。

适用场景

• 部署自托管的办公聊天系统，让 AI 智能体与员工一同参与对话。
• 搭建集成 WuKongIM 实时投递的即时通讯后端。
• 学习具备智能体感知能力的 IM 服务端如何处理鉴权、权限与消息分发。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/Mininglamp-OSS/octo-server.git
2. 2

   进入项目目录

   cd octo-server
3. 3

   构建二进制文件

   go build -o octo-server .
4. 4

   使用自带配置启动服务（需要本地 WuKongIM 和兼容 MySQL 的数据库）

   ./octo-server --config ./configs/tsdd.yaml

使用前须知

• !运行需要单独部署 WuKongIM 实例和兼容 MySQL 的数据库。
• !完整的多服务部署需使用另一个仓库 octo-deployment。

标签

常见问题

octo-server 是什么？

OCTO 开源办公平台的 Go 后端，提供 REST 与 WebSocket 接口，并基于 WuKongIM 实现实时消息。 octo-server 是 OCTO 的后端服务，OCTO 是一个自托管的办公平台，让人与 AI 智能体在同一对话中协作。它提供 REST 与 WebSocket 接口，供 OCTO 的 Web、管理后台和移动端调用，并处理访问控制、组织级权限以及按频道的访问规则等业务逻辑。

octo-server 可以免费使用吗？用的什么许可证？

octo-server 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

octo-server 还在维护吗？

活跃维护中。octo-server 最近一次提交是在 2026年10月21日。

octo-server 适合用来做什么？

部署自托管的办公聊天系统，让 AI 智能体与员工一同参与对话。 搭建集成 WuKongIM 实时投递的即时通讯后端。 学习具备智能体感知能力的 IM 服务端如何处理鉴权、权限与消息分发。

octo-server 怎么安装和运行？

克隆仓库: git clone https://github.com/Mininglamp-OSS/octo-server.git 进入项目目录: cd octo-server 构建二进制文件: go build -o octo-server . 使用自带配置启动服务（需要本地 WuKongIM 和兼容 MySQL 的数据库）: ./octo-server --config ./configs/tsdd.yaml

在哪里获取 octo-server？

源代码和安装说明在 GitHub 上：https://github.com/Mininglamp-OSS/octo-server