OpenAgentsDocumentation
Login
启动器启动器安装与设置
Updated August 22, 2026

启动器安装与设置

在 macOS、Windows 或 Linux 上下载并安装 OpenAgents 启动器，并一步一步地跑起你的第一个智能体。

启动器安装与设置

从下载页面获取应用——那里始终提供最新版本。

macOS

  1. 在下载页面点击 macOS，并选择你的芯片类型：Apple Silicon（M 系列芯片的 Mac）或 Intel。不确定？打开苹果菜单 → 关于本机。
  2. 打开下载的 .dmg，把 OpenAgents Launcher 拖入 Applications（应用程序）文件夹。
  3. 从应用程序文件夹中启动它。

Windows

  1. 在下载页面点击 Windows，获取安装程序（.exe）。
  2. 运行它。
  3. **如果 Windows SmartScreen 弹出警告：**应用暂未进行代码签名，SmartScreen 可能会拦截。点击 更多信息 → 仍要运行 继续。

Linux

在下载页面点击 All platforms（所有平台）打开发布列表，然后选择：

  • .deb（适用于 Debian/Ubuntu）：sudo dpkg -i OpenAgents-Launcher-<version>-linux-amd64.deb
  • .AppImage（适用于其他发行版）：为其添加可执行权限（chmod +x）后直接运行。

首次运行——设置向导

首次启动会打开一个引导式的入门流程。在欢迎界面上，它会检查你的机器（Node.js、npm、智能体核心、凭据存储），并让你选择一条路径：

1
路径 1——连接此设备（已有工作空间时推荐）

粘贴来自工作空间 Connect Agent → Nodes 面板的 8 位配对码。 你的机器将作为节点加入工作空间，之后你可以在浏览器中从工作空间那边完成智能体的后续设置。

2
路径 2——在本机设置一个智能体

向导会一步步带你完成：从图库中挑选你的第一个智能体 （Claude Code 是很好的首选）→ 配置密钥（粘贴 API 密钥或使用 账号登录，然后测试连接）→ 创建你的智能体（名称 + 工作 目录）→ 可选地连接一个工作空间。

启动器——首次运行的入门引导
Screenshot: Launcher onboarding welcome screen with the two paths
首次运行：使用配对码连接此设备，或在本地设置你的第一个智能体。

无论选哪条路径，你都会进入仪表盘（Dashboard），并看到关于三个步骤的简短引导：Marketplace（安装智能体）→ Agents（创建与测试）→ Workspaces（打开与管理）。

接下来，连接到一个工作空间，就可以在浏览器里与你的智能体对话了：连接到工作空间。

更新

启动器会自动更新自身，同时也会保持你已安装的智能体处于最新版本——又少了一件要操心的事。

更喜欢终端？

上述所有操作也都可以用 agn CLI 完成：

# macOS / Linux
curl -fsSL https://openagents.org/install.sh | bash
 
# Windows (PowerShell)
irm https://openagents.org/install.ps1 | iex

命令详情见 CLI 参考——不过如果你用应用就够顺手，那就完全不需要终端。