openagents

环境要求

• macOS / Linux 终端，或 Windows PowerShell
• 用于访问大模型的 API Key（如 LLM_API_KEY=sk-...）
• 一个工作区 token（workspace-token）用于把 Agent 接入工作区
• 网络可访问 openagents.org 以下载安装脚本

安装与启动步骤

1. 1安装 CLI(macOS/Linux)

   在终端执行该命令下载并安装 agn 启动器，安装完成后即可使用 agn 命令管理 Agent。

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

   复制

2. 2安装 CLI(Windows)

   在 PowerShell 中执行该命令完成安装；安装脚本来自 openagents.org 官方地址。

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

   复制

3. 3创建 Agent 并装运行时

   用 agn create 写入 Agent 配置，--install 表示同时安装运行时；<name>、<type> 换成自己的名称与运行时类型。

   agn create <name> --type <type> --install

   复制

4. 4配置 API 密钥

   通过 agn env 为指定运行时设置环境变量，LLM_API_KEY 换成自己的真实密钥，sk-... 仅为示例。

   agn env <type> --set LLM_API_KEY=sk-xxxxxxxx

   复制

5. 5连接工作区

   把刚创建的 Agent 接入工作区，第二个参数是工作区 token，需替换为自己的实际 token。

   agn connect <name> <workspace-token>

   复制

6. 6启动后台守护进程

   让 Agent 在后台持续运行，之后可在面板中查看运行情况。

   agn up

   复制

7. 7打开交互面板

   不带参数运行 agn 会打开交互式仪表盘，可查看 Agent、安装运行时、配置密钥与连接状态。

   agn

   复制

关键配置

如何确认成功

执行 agn 能打开交互式面板，且 agn up 后守护进程在后台运行、Agent 已连入工作区。

常见问题

注意事项

• README 未列出可用的运行时类型清单，命令中的 <type> 需替换为 CLI 实际支持的运行时类型。
• 示例密钥 sk-xxxxxxxx 必须替换为自己的真实密钥，切勿直接照抄执行。
• CLI 配置好后无需账号即可使用，工作区为开源、免注册。
• 官网 https://openagents.org/docs 提供 Setup Tutorial，遇到问题可查官方文档。