octo-web

一套代码搞定浏览器和桌面，原生拥抱 AI 智能体的工作空间客户端

octo-web 是 OCTO 开放工作空间的官方客户端，采用 React + TypeScript 构建，一套代码同时支持浏览器（PWA）和桌面（Electron）双端。项目定位为面向 AI 智能体时代的工作沟通工具，内置聊天、消息、工作区管理等基础 IM 能力，并通过 WebSocket 实现实时通信。其核心特色在于将 AI 智能体作为一等公民融入交互界面，提供专门的智能体操作体验，而非简单的聊天机器人挂载。项目采用 monorepo + Turborepo 管理，支持国际化（i18n），技术栈现代。当前处于早期阶段（600+ 星标），旨在为 OCTO 生态提供统一的前端入口，解决传统工作空间工具缺乏 AI 原生协作体验的问题。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1180

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队Mininglamp-OSS

所属国家

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

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

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自由使用和部署，无付费版本。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型ai-agent,chat,desktop-app,electron,i18n,im,messaging,monorepo,open-source,pwa,react,turborepo,typescript,websocket

GitHub 星标★ 1180

30天Star增速

HF 下载量

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

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

已安装 Node.js（README 未指定具体版本，建议使用较新的 LTS）
已安装 pnpm 包管理器（README 中全部命令均使用 pnpm）
一个可访问的 octo-server 实例，默认地址为 http://localhost:8080
网络可访问 GitHub 以克隆仓库

安装与启动步骤

1克隆仓库

从 GitHub 拉取 octo-web 源码到本地，确保网络可访问 GitHub。
```
git clone https://github.com/Mininglamp-OSS/octo-web.git
```
2进入项目目录

切换到刚克隆下来的 octo-web 目录，后续命令都在此执行。
```
cd octo-web
```
3安装依赖

用 pnpm 安装 monorepo 全部依赖，依赖较多时耗时较长，请耐心等待。
```
pnpm install
```
4配置服务端地址

复制环境变量示例文件，编辑其中的 VITE_API_* 指向你自己的 octo-server 地址。
```
cp .env.example .env.local
```
5启动开发服务

运行 dev 脚本启动浏览器端开发服务，终端会输出本地访问地址。
```
pnpm dev
```

关键配置

配置项	必填	说明	示例
`VITE_API_*`	否	指向 octo-server 的接口地址，默认使用 http://localhost:8080。	`http://localhost:8080`

如何确认成功

pnpm dev 启动后终端会打印本地访问地址，浏览器打开该地址并能连上 octo-server 即成功。

常见问题

Q：前端启动后连不上后端、消息加载不出来怎么办？

A：确认 octo-server 已运行且在 http://localhost:8080 可访问；若不是该地址，请在 .env.local 中修改 VITE_API_* 指向你自己的服务端。

Q：可以用 npm 或 yarn 代替 pnpm 吗？

A：README 的 Quickstart 全部使用 pnpm 命令（pnpm install / pnpm dev），建议直接使用 pnpm 以免依赖安装出现差异。

Q：是否支持桌面 PC 客户端？

A：支持。浏览器版与 Electron 桌面版由同一份 src/ 代码构建，属于同一代码库的两个发布形态。

Q：需要单独申请密钥或账号吗？

A：README 未提及任何密钥或账号要求，仅需准备可访问的 octo-server 实例即可。

注意事项

README 未指定 Node.js 与 pnpm 的具体版本要求，建议使用较新的稳定版本。
octo-web 只是前端，必须配合 octo-server 才能完整使用聊天与实时通信功能。
.env.local 为你本地的服务端配置，读取示例文件后按需修改，不要直接改动 .env.example。

核心亮点

React + TypeScript 单代码库同时输出 PWA 和 Electron，开发维护成本低
将 AI 智能体作为一等公民融入 UI，而非简单聊天框，交互设计更原生
基于 WebSocket 实时通信，适合即时消息和协作场景

不足之处

早期项目，文档和社区生态待观察
功能聚焦于 OCTO 平台，脱离该生态可能无法独立使用

适用场景

作为 OCTO 工作空间的桌面端和 Web 端统一入口
在团队协作中集成 AI 智能体辅助任务处理
作为 React + Electron 跨端开发的参考实现

替代项目

Rocket.Chat、Mattermost、Zulip

项目介绍

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

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

近 45 天，它的 GitHub 星标从 604 增加到 1,180，净增 576。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，可自由使用和部署，无付费版本。

它主要面向的使用场景是：作为OCTO工作空间的桌面端和Web端统一入口。同类可对比的替代方案包括 Rocket.Chat、Mattermost、Zulip。

上一篇：loom

下一篇：tgo