教程 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 配置是否正確。