装AIAgent之前,先把这几个环境装好(2026 Windows版),可节省很多报错和时间
前几天发了一篇AI Agent测评，后台收到一条留言：“能不能讲讲怎么装？”，后来又收到好几条类似的，我才发现——很多人不是不想用AI Agent，是第一步就卡在环境上了。
今天把OpenClaw、Hermes、OpenCode、WorkBuddy这四个主流Agent的安装前提一次性讲清楚。照着来，半小时以内全搞定。
一、四大Agent一览
先搞清楚这四个分别是什么：
Agent | 开发方 | 一句话定位 | 核心特色 | 支持平台 |
OpenClaw | 社区开源 | 自主执行任务的AI助手 | 插件生态丰富，支持邮件/日历/代码 | Windows/macOS/Linux |
Hermes Agent | Nous Research | 全能型AI工作平台 | 多平台消息接入，有桌面端和记忆系统 | Windows/macOS/Linux |
OpenCode | OpenCode团队 | 专注写代码的AI | 轻量快速，代码审查和重构能力强 | Windows/macOS/Linux |
WorkBuddy | 腾讯 | 办公场景AI工作台 | 开箱即用，支持文件处理和自然语言指令 | Windows/macOS |
二、公共环境：所有Agent都需要
不管装哪个，这四样先备好：
环境 | 作用 | 下载地址 |
Git | 拉取代码、更新版本 | git-scm.com |
Node.js v22+ | JavaScript运行时 | nodejs.org |
npm | 包管理器，随Node.js自动装 | 随Node.js附带 |
LLM API Key | 连接大模型的凭证 | 各提供商官网 |
1、Git
去 git-scm.com 下载Windows版，一路默认下一步。装完打开终端输入git --version，返回版本号就对了。提示“不是内部命令”的话重启终端试试，还不行就重新装，注意勾选“Add Git to PATH”。
2、Node.js
去nodejs.org下载LTS版，选 Windows Installer (.msi)，一路默认。
装完输入 node --version 和 npm --version ，都返回版本号就对了。
特别提醒：npm默认从国外下载包，国内网络会特别慢。装完第一件事切镜像：
npm config set registry https://registry.npmmirror.com/
3、npm
不需要单独装，随Node.js一起就有了。
npm --version 确认一下就行。
4、LLM API Key
所有Agent都要连大模型才能干活，API Key就是你的使用凭证。各家申请地址：
提供商 | 网址 | 特点 |
OpenAI | platform.openai.com | GPT系列，最主流 |
Anthropic | console.anthropic.com | Claude系列，安全性好 |
DeepSeek | platform.deepseek.com | 国产，便宜，国内直连 |
申请到的Key类似sk-xxxx，后面装每个Agent时会要求填入。
Key千万别泄露——发到群里、贴到论坛、写进公开仓库，别人用你的额度调模型，费用算你的。
我之前就犯过这个错，Key不小心提交到了GitHub仓库，半夜收到扣费通知才反应过来。后来学乖了，Key一律存本地.env文件，不进版本控制。
三、特殊环境：只有部分Agent需要
环境 | 作用 | 哪些Agent需要 |
Python 3.10+ | 核心运行时 | 仅Hermes |
uv | Python包管理器 | 仅Hermes |
pnpm | 源码编译 | 仅OpenClaw（源码安装方式） |
管理员权限 | 安装系统服务 | 仅OpenClaw |
1、Python 3.10+（只有Hermes要）
Hermes是Python写的，其他三个完全不碰Python。去python.org下载3.10+版本，安装时一定要勾选“Add Python to PATH”——我见过太多人装完Python用不了，就是因为漏了这一步。装完用python --version确认。
2、uv（只有Hermes要）
Hermes官方安装脚本会自动装好uv，不需要手动操作。
用uv --version确认有就行。
3、pnpm（OpenClaw源码安装才要）
普通用户直接npm i -g openclaw就够了，不用管pnpm。只有你要从源码编译才需要。
四、一条命令装好所有环境
Windows用户如果装了winget（Windows自带的包管理器），上面那些环境可以一行命令搞定，不用手动去网站下载：
环境 | winget安装命令 |
Git | winget install Git.Git |
Node.js | winget install OpenJS.NodeJS.LTS |
Python | winget install Python.Python.3.12 |
npm镜像 | npm config set registry https://registry.npmmirror.com/ |
打开PowerShell（管理员模式），逐条复制执行就行。Python只有Hermes需要，其他三个Agent不装Python也行。
五、四个Agent的安装
公共环境准备好，每个Agent的安装就一条命令的事。
1、OpenClaw
npm i -g openclaw
openclaw onboard
第二条启动引导向导，引导你配置API Key。装完跑一下openclaw --version确认。更新用openclaw update，建议每两周跑一次。
2、Hermes Agent
2.1、Git Hub直接安装，国内网络容易报错，供参考
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
如果显示超时报错，则改成下面方案
$ProgressPreference = 'SilentlyContinue'
irm -Uri https://hermes-agent.nousresearch.com/install.ps1 -OutFile "$env:TEMP\install.ps1" -TimeoutSec 300
iex "$env:TEMP\install.ps1"
安装完成后，再进行
hermes setup
官方脚本自动装好一切。Windows用户，如果一直失败，去GitHub仓库手动下载安装脚本。装完跑hermes --version确认，再跑一次hermes doctor做全面体检。
2.2、下载安装脚本安装
浏览器打开这个链接下载（浏览器能走代理 / 缓存，比命令行稳）：
https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip
下载后解压，把里面的
hermes-agent-main文件夹重命名为hermes-agent，放到：
C:\Users\liuse\AppData\Local\hermes\
然后重跑安装脚本：
iex "$env:TEMP\install.ps1"
装完跑hermes --version确认，再跑一次hermes doctor做全面体检。
3、OpenCode
npm i -g opencode-ai@latest
opencode auth login
按提示输入API Key。opencode --version确认安装成功。更新用npm update -g opencode-ai。
4、WorkBuddy
去workbuddy.ai下载安装包，双击运行，登录账号即可。四个里最省心的一个，打开能登录就算装好了。
六、装完跑一遍健康检查
工具 | 检查命令 | 正常输出示例 |
Git | git --version | git version 2.55.0 |
Node.js | node --version | v24.19.0 |
npm | npm --version | 12.0.2 |
Python | python --version | Python 3.11.16 |
OpenClaw | openclaw --version | OpenClaw 2026.9.1 |
Hermes | hermes --version | Hermes Agent v0.21.0 |
OpenCode | opencode --version | 返回版本号 |
WorkBuddy | 打开客户端验证 | 能正常登录即OK |
某个命令报错，回上面对应小节查排查方法。
七、更新命令汇总
AI Agent更新很频繁，建议每两周跑一次：
Agent | 更新命令 |
OpenClaw | openclaw update |
Hermes | hermes update |
OpenCode | npm update -g opencode-ai |
WorkBuddy | 客户端自动提示更新 |
国内网络更新慢的话，给Git配代理：
git config --global http.proxy http://你的代理地址:端口
最后总结
装AI Agent这事不复杂，说白了就两步：先把Git + Node.js + npm + API Key这四样公共环境备好，再按你要装的Agent补上特殊依赖（大多数人只需要前四样就够了）。
卡住的人，问题基本都出在第一步——Git没装好、Node.js版本太低、npm源太慢、API Key没申请。这些解决了，后面就是一条命令的事。
你现在装了哪个Agent？或者准备先试哪个？评论区聊聊，遇到安装问题也可以留言，我看到会回复。