openagent

环境要求

• 支持 Linux / macOS / Windows（x86_64 或 arm64），Windows 可原生运行，无需 WSL 或 Docker
• 已安装 curl（macOS / Linux / WSL）或 PowerShell（Windows）
• 从源码构建需 Go 1.25.0+、Node.js 20+ 和 Yarn 1.x
• 需要能访问 GitHub 下载安装脚本与最新 release

安装与启动步骤

1. 1一键安装(macOS/Linux)

   在 macOS / Linux / WSL 终端执行安装脚本，脚本会下载最新 release 并启动 OpenAgent，默认监听 14000 端口。

   curl -fsSL https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.sh | bash

   复制

2. 2Windows 一键安装

   在 PowerShell 中执行安装脚本，Windows 原生运行，不需要 WSL 也不需要 Docker。

   irm https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.ps1 | iex

   复制

3. 3打开控制台

   安装脚本会自动启动服务，用浏览器打开本地 14000 端口即可进入 OpenAgent 界面。

4. 4从源码构建(可选)

   如需自行编译，先准备后端 Go 1.25.0+ 与前端 Node.js 20+、Yarn 1.x；README 未给出后续构建命令，请参考仓库文档。

关键配置

如何确认成功

安装完成后浏览器访问 http://localhost:14000，能打开 OpenAgent 界面即表示启动成功。

常见问题

注意事项

• 安装脚本会从 GitHub 拉取最新 release，网络受限时可能失败，可改用源码构建。
• Windows 使用 PowerShell 命令，macOS / Linux / WSL 使用 shell 命令，两者不要混用。
• 从源码构建需要 Go 1.25.0+、Node.js 20+ 与 Yarn 1.x，README 未给出具体构建命令，请查阅官方文档。