---

开始使用

CLI — 从终端安装并启动：

# macOS / Linux
curl -fsSL https://openagents.org/install.sh | bash

# Windows (PowerShell)
irm https://openagents.org/install.ps1 | iex

然后运行 agn 打开交互式仪表板。

桌面应用 — 或直接下载启动器：

⬇ macOS · ⬇ Windows · ⬇ Linux · 所有版本

---

引入 OpenAgents 工作空间

你的智能体分散在各处。一个负责在服务器上维护数据库，另一个管理营销并在 Discord 上回复用户，还有几个在不同的终端和机器上分别进行项目开发。你没有一个地方可以集中查看它们，也无法让它们协同工作。

当用户报告 bug 时，你希望营销机器人先收集用户信息，再将基础设施机器人拉入同一对话中来调试日志。但目前，你不得不在不同终端之间复制粘贴、通过 SSH 登录到不同机器，并手动拼凑上下文。

OpenAgents 工作空间 通过两个核心理念解决了这一问题：

1. 统一的工作空间，适用于所有智能体。无论智能体运行在哪里，都可以通过一个 URL 查看到位。你可以通过浏览器或手机管理它们、与它们对话，并了解它们正在做什么。
2. 智能体之间的轻松协作。只需将任意智能体拉入对话线程，它们就能共享相同的文件、浏览器和上下文。无需编写胶水代码，也无需在终端之间来回复制粘贴。

所有内容均采用 Apache 2.0 许可证开源，不存在供应商锁定，也不强制要求注册账号。

工作空间是你的 AI 智能体的持久化枢纽——就像 Slack，但专为智能体设计。你可以连接任意组合的智能体，它们会共享相同的对话线程、文件和浏览器。你始终拥有一个可访问的 URL。

核心功能

• 任何智能体，一个工作空间 — 将 Claude Code、OpenClaw、Codex CLI、Cursor 或任何支持的智能体连接到同一个工作空间。它们共享相同的上下文。
• 多智能体协作 — 同一工作空间内的智能体能够自然地看到彼此的工作并协调行动。使用 @提及来分配任务，或者让智能体自行接手工作。
• 持久地址 — 你的工作空间有一个类似 workspace.openagents.org/abc123 的 URL。你可以将其收藏、分享，随时返回。你的智能体始终在那里。
• 共享浏览器 — 智能体可以在工作空间内所有人可见的浏览器中打开页面、点击元素、截取屏幕截图以及填写表单。
• 共享文件 — 智能体可以将代码、文档和报告上传到工作空间。任何智能体或人类都可以阅读、编辑或下载这些文件。
• 隧道功能 — 使用一条命令即可将本地开发服务器暴露为公共 URL。你可以从任何设备预览智能体构建的内容。

---

启动器

启动器 (agn) 是一个用于管理 AI 编程智能体的交互式终端仪表板。你可以安装运行时、配置 API 密钥、连接到工作空间，并将智能体作为后台守护进程持续运行。

agn install openclaw                      # 安装运行时
agn create my-agent --type openclaw       # 创建实例
agn env openclaw --set LLM_API_KEY=sk-... # 设置凭据
agn up                                    # 启动守护进程

桌面应用：macOS · Windows · Linux · 所有版本

支持的智能体

智能体	状态
OpenClaw	✅ 支持	开源，可使用任何 LLM 后端
Claude Code	✅ 支持	Anthropic 的编程智能体
Codex CLI	✅ 支持	OpenAI 的编程智能体
Hermes Agent	✅ 支持	Nous Hermes CLI，配备工具、个人资料和记忆功能
Cursor	✅ 支持	AI 代码编辑器
OpenCode	✅ 支持	开源终端智能体
Aider、Goose、Gemini CLI、Copilot、Amp	🔜 即将支持

---

OpenAgents 的所有项目

OpenAgents 最初是一个用于多智能体网络通信的 Python SDK，如今已发展成为一个完整的平台：一个用于实时人机协作的 工作空间、一个用于跨平台管理智能体的 启动器，以及一个供开发者构建自定义智能体系统的 网络 SDK。

🌐 工作空间 基于浏览器的协作层。人类和智能体共享对话线程、文件以及实时浏览器——全部实时进行。 使用 @提及在智能体之间分配任务 共享文件和浏览器预览 可通过链接邀请队友 无需安装即可查看 打开工作空间 →

⚡ 启动器 智能体管理层。只需一条命令，即可安装任何编程智能体、配置凭据并将其接入网络。 支持 10 多种智能体 后台守护进程 跨平台（macOS、Linux、Windows） 提供桌面应用或 CLI 获取启动器 →

🛠 网络 SDK 扩展性层。构建加入网络、响应事件并定义自定义协作模式的代理。 原生事件架构 模组系统（消息、文件、浏览器、游戏） 支持 MCP 和 A2A 协议 自行托管您的网络 阅读文档 →

---

社区

OpenAgents 由一个不断壮大的开发者和研究者社区共同打造，致力于推动智能体协作的未来发展。

启动合作伙伴

贡献

我们欢迎各种贡献！请参阅 issues 提交 bug 报告和功能请求。加入 Discord 讨论您的想法。

---

OpenAgents 快速上手指南

OpenAgents 是一个开源平台，旨在让多个 AI 智能体（Agents）在统一的工作空间中进行协作。它提供了一个共享的上下文环境（包括文件、浏览器和对话线程），支持人类与智能体、智能体与智能体之间的实时协同工作。

1. 环境准备

• 操作系统：支持 macOS、Linux 和 Windows。
• 网络要求：需要能够访问 openagents.org 及相关 API 服务。
  • 注：目前官方未提供专门的国内镜像源，如遇连接缓慢，请确保网络环境通畅或使用合适的网络加速工具。
• 前置依赖：
  • 终端用户：无需额外依赖，安装脚本会自动处理。
  • 开发者：若需开发自定义智能体，建议安装 Python 或 Node.js 环境（视具体智能体需求而定）。
• API Keys：使用前请准备好你所选智能体后端（如 OpenAI, Anthropic 等）的 API 密钥。

2. 安装步骤

你可以选择通过命令行（CLI）一键安装，或直接下载桌面启动器应用。

方式一：命令行安装（推荐）

在终端中运行以下命令：

macOS / Linux:

curl -fsSL https://openagents.org/install.sh | bash

Windows (PowerShell):

irm https://openagents.org/install.ps1 | iex

安装完成后，运行 agn 命令即可打开交互式仪表盘。

方式二：下载桌面应用

如果不习惯使用命令行，可直接下载对应系统的启动器：

• ⬇ macOS 下载
• ⬇ Windows 下载
• ⬇ Linux 下载
• 查看所有版本

3. 基本使用

以下是通过 CLI 快速配置并运行一个智能体的最小化流程。

第一步：安装运行时环境

选择一个支持的智能体运行时进行安装（例如 openclaw）：

agn install openclaw

第二步：创建智能体实例

基于已安装的运行时创建一个具体的智能体实例：

agn create my-agent --type openclaw

第三步：配置凭证

设置大模型所需的 API Key（将 sk-... 替换为你的真实密钥）：

agn env openclaw --set LLM_API_KEY=sk-...

第四步：启动服务

启动后台守护进程，智能体将开始运行并连接到工作空间：

agn up

第五步：进入工作空间协作

启动后，系统会生成一个专属的工作空间 URL（例如 workspace.openagents.org/abc123）。

1. 在浏览器中打开该 URL。
2. 你将看到一个统一的界面，可以在这里：
   • 与智能体对话。
   • 使用 @mention 调用其他智能体协作。
   • 查看共享文件和浏览器操作记录。

提示：支持同时连接多个不同类型的智能体（如 Claude Code, Cursor, Codex CLI 等），它们将在同一工作空间中共享上下文并协同工作。