教程 01 — 快速开始：5 分钟跑起来你的私人 AI 助手
目标：安装 OpenClaw、配置 MiniMax 模型、启动网关、发送第一条消息。
你需要什么
- macOS / Linux（Windows 需要 WSL2）
- Node.js 22+（推荐用 nvm 管理）
- pnpm 9+
- MiniMax API Key（注册地址）
第一步：克隆并安装依赖
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install第二步：配置环境变量
复制示例 .env 文件并填入你的 MiniMax API Key：
cp .env.example .env # 如果没有 example，直接新建 ~/.openclaw/.env编辑 .env，加入：
MINIMAX_API_KEY=sk-你的key第三步：创建配置文件
新建 ~/.openclaw/openclaw.json：
{
"gateway": { "mode": "local" },
"env": { "MINIMAX_API_KEY": "${MINIMAX_API_KEY}" },
"agents": {
"defaults": {
"model": { "primary": "minimax/MiniMax-M2.1" }
}
},
"models": {
"mode": "merge",
"providers": {
"minimax": {
"baseUrl": "https://api.minimax.io/anthropic",
"apiKey": "${MINIMAX_API_KEY}",
"api": "anthropic-messages",
"models": [
{
"id": "MiniMax-M2.1",
"name": "MiniMax M2.1",
"reasoning": false,
"input": ["text"],
"cost": { "input": 15, "output": 60, "cacheRead": 2, "cacheWrite": 10 },
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}第四步：安装并启动网关
pnpm openclaw gateway install
pnpm openclaw gateway start检查状态：
pnpm openclaw gateway status
# 应该看到 Runtime: running 和 RPC probe: ok第五步：打开 WebChat 聊天
浏览器访问：
http://127.0.0.1:18789/
输入你的第一条消息，比如：
"你好！帮我写一个 Python 冒泡排序"
验证模型
pnpm openclaw models list
# 应该看到 minimax/MiniMax-M2.1 default常见问题
OpenClaw 支持 Windows 吗？
OpenClaw 支持 macOS 和 Linux。Windows 用户需要安装 WSL2（Windows Subsystem for Linux），然后在 WSL2 环境中按相同步骤操作。WSL2 安装教程可参考微软官方文档。
除了 MiniMax，OpenClaw 还支持哪些 AI 模型？
OpenClaw 支持多家主流模型提供商，包括 MiniMax（M2.1、M2.5、VL-01）、Anthropic（Claude Sonnet、Opus）、OpenAI（GPT-4o）等。多模型配置方法见教程 05。
网关启动后浏览器打不开怎么办？
首先确认端口没有被占用：lsof -i :18789。如果端口冲突，在 openclaw.json 中修改 gateway.port 字段后重启。如果是防火墙问题，确保本地 localhost 访问不被阻断。
pnpm install 报错怎么处理？
最常见的原因是 Node.js 版本不满足要求（需要 22+）。运行 node -v 检查版本，推荐使用 nvm 管理：nvm install 22 && nvm use 22，然后重新执行 pnpm install。
发送消息后 AI 没有响应怎么办？
运行 pnpm openclaw gateway status 检查网关是否在运行（应看到 Runtime: running）。然后运行 pnpm openclaw models list 确认模型已正确加载。如果模型列表为空，检查 API Key 配置是否正确。