OpenAgents

在真实场景中快速搭建和部署语言智能体，开箱即用

OpenAgents 是一个面向真实场景的开源语言智能体平台，由 X-LANCE 团队开发，相关论文发表于 COLM 2024。它旨在解决大语言模型在现实世界中应用时面临的工具调用、任务规划与执行等复杂问题，提供开箱即用的智能体能力。核心能力包括：支持多种主流大模型（如 GPT、Claude 等）作为后端，提供统一的工具调用接口，内置丰富的工具集（如搜索、计算、代码执行等），并支持自定义工具扩展。平台采用模块化设计，包含 Agent 核心、工具注册、任务调度等组件，开发者可以快速构建、调试和部署自己的语言智能体。OpenAgents 强调在真实环境中的可用性，提供了 Web 界面和 API 接口，方便集成到实际应用中。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4862

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队xlang-ai

所属国家

官网地址

GitHubhttps://github.com/xlang-ai/OpenAgents

定价模式free

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

访问状态

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型agent,assistant-chat-bots,code-generation,executable-langauge-grounding,gpt,hacktoberfest,language-model,language-model-agent,llm,semantic-parsing,tool-learning,ui

GitHub 星标★ 4862

30天Star增速

HF 下载量

上线时间2023-08-08 00:00:00

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

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：进阶约 30 分钟部署方式：Docker 6 步

环境要求

已安装 Git，用于克隆 OpenAgents 仓库
已安装 Docker 与 Docker Compose（v2，使用 docker compose 命令）
如使用本地 GPU 推理，需安装 Nvidia Container Toolkit
自备 OpenAI 或兼容服务的 API Key（使用非官方 OpenAI 服务时需准备 API Base）
如使用 Kaggle 数据集，需准备 Kaggle 用户名与 Key

安装与启动步骤

1克隆项目仓库

把 OpenAgents 源码拉到本地，后续所有配置和构建都在项目根目录进行。
```
git clone https://github.com/xlang-ai/OpenAgents.git
cd OpenAgents
```
2配置 Kaggle 凭据

只有要用 Kaggle 数据集时才需要，打开根目录 Dockerfile 第 12 行，把 ENV 里的用户名和 Key 改成自己的真实信息。
3配置后端访问地址

如果不是在本机运行，需要打开 frontend/Dockerfile 第 15 行，把 NEXT_PUBLIC_BACKEND_ENDPOINT 改成后端服务可访问的 IP 地址。
4构建镜像

在项目根目录执行构建，会拉取并编译前后端等多个服务的镜像，耗时较久，请保证网络稳定。
```
docker compose build
```
5填写模型密钥

编辑 docker-compose.yml 第 36 行：使用官方 OpenAI 只需填 OPENAI_API_KEY；使用 FastChat 等非官方服务还要修改 OPENAI_API_BASE。
6启动全部服务

后台启动所有容器，执行后等待服务初始化完成；如需 GPU 需先取消 docker-compose.yml 第 56-62 行注释。
```
docker compose up -d
```

关键配置

配置项	必填	说明	示例
`KAGGLE_USER`	否	使用 Kaggle 数据集时的 Kaggle 账号用户名，配置在 Dockerfile 第 12 行	`your_kaggle_user`
`KAGGLE_KEY`	否	使用 Kaggle 数据集时的 Kaggle 密钥，配置在 Dockerfile 第 12 行	`xxxxxxxxxxxxxxxxxxxxxxxx`
`NEXT_PUBLIC_BACKEND_ENDPOINT`	否	前端访问的后端地址，非本地运行时必须修改，位于 frontend/Dockerfile 第 15 行	`http://x.x.x.x:8000`
`OPENAI_API_KEY`	是	模型后端密钥，填写在 docker-compose.yml 第 36 行	`sk-xxxxxxxxxxxxxxxx`
`OPENAI_API_BASE`	否	使用 FastChat 等非官方 OpenAI 服务时的接口地址，同样在 docker-compose.yml 第 36 行	`http://x.x.x.x:8000/v1`

如何确认成功

docker compose up -d 执行后无报错且容器持续运行，即视为服务已启动；若某服务异常可查看其容器日志排查。

常见问题

Q：Docker 部署后功能不正常或响应很慢怎么办？

A：README 明确说明 Docker 版本仍在开发中，可能有功能无法正常工作；如需更稳定的版本，建议改为从源码部署。

Q：启动时从 HuggingFace 下载权重超时怎么办？

A：使用 Auto Plugin 会从 HuggingFace 下载权重文件，部分地区会连接超时，README 提示需自行解决网络问题。

Q：想用 GPU 加速应该怎么做？

A：先安装 Nvidia Container Toolkit，然后取消 docker-compose.yml 第 56-62 行的注释，再重新执行 docker compose up -d。

Q：接了 FastChat 这类非官方 OpenAI 服务，需要改哪里？

A：修改 docker-compose.yml 第 36 行的 OPENAI_API_BASE；如果只用官方 OpenAI，则只需填 OPENAI_API_KEY。

注意事项

所有文件修改都在项目根目录完成：Dockerfile、frontend/Dockerfile、docker-compose.yml，注意行号对应关系。
非本机运行时必须把前端后端地址改成外部可访问的 IP，否则前端无法连上后端。
Docker 版本官方标注为开发中，功能与响应速度可能不稳定，追求稳定请使用源码部署方式。
涉及 API Key、Kaggle Key 等敏感信息不要提交到公开仓库。

核心亮点

论文加持，设计有理论支撑，COLM 2024 发表
支持多模型后端，灵活切换 GPT、Claude 等
内置丰富工具集，覆盖搜索、计算、代码执行等常见需求

不足之处

文档/社区待观察
项目仍处于成长阶段，生态和案例相对有限

适用场景

构建个人助理型智能体，集成日历、邮件等工具
开发自动化数据分析工具，让智能体调用代码和查询数据库
快速原型验证语言智能体在特定业务场景的可行性

替代项目

AutoGPT、BabyAGI、MetaGPT

项目介绍

OpenAgents 是智能体领域的开源项目，由 xlang-ai 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（4,862）位列前 9%，在智能体分类的 2,517 个项目里位列前 10%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。Apache-2.0 许可证，可免费自行部署使用。

它主要面向的使用场景是：构建个人助理型智能体，集成日历、邮件等工具。同类可对比的替代方案包括 AutoGPT、BabyAGI、MetaGPT。

上一篇：aci

下一篇：zep