第 2 章：环境与安装

1前置要求

• Node.js ≥ 20
• pnpm ≥ 10

node -v
pnpm -v

2本机安装（推荐先走这条）

git clone https://github.com/THU-MAIC/OpenMAIC.git
cd OpenMAIC
pnpm install
cp .env.example .env.local

下一步去第 3 章填 Key，然后：

pnpm dev

浏览器打开 http://localhost:3000。生产构建：

pnpm build && pnpm start

3Docker

cp .env.example .env.local
# 先编辑 .env.local，至少填一个 LLM Key
docker compose up --build

国内构建可加速 Alpine / npm 镜像（不要把账号密码写进 build-arg，Docker 可能记进镜像元数据）：

ALPINE_MIRROR=mirrors.tuna.tsinghua.edu.cn \
NPM_REGISTRY=https://registry.npmmirror.com \
docker compose up --build

4Vercel

1. Fork 仓库
2. 在 Vercel 导入
3. 环境变量至少填一个 LLM Key
4. 部署

官方提供一键 Clone 按钮，说明见仓库 README「Vercel Deployment」。