OpenClaw 安装与模型配置

本文介绍 OpenClaw 的通用安装方式，以及如何配置模型提供商（LLM Provider）与默认模型。无论你通过 WSL、虚拟机还是物理机部署，配置方式完全一致。

一、安装 OpenClaw

macOS / Linux / WSL2 通用：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动检测系统、安装所需 Node 运行时（Linux 下为 Node 24 LTS，macOS 下为 Node 26）并完成 OpenClaw 安装。

如果你已自行管理 Node（需 22.22.3+ / 24.15+ / 25.9+，推荐 Node 26）：

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

openclaw --version

运行配置向导，按提示完成：

openclaw onboard

向导会引导你完成：

OpenClaw 支持主流 LLM 服务商，包括：DeepSeek、OpenAI、Anthropic、Google Gemini、通义千问、豆包（火山引擎）、智谱、Moonshot、Ollama（本地模型）、llama.cpp（本地模型）等。

查看当前可用模型：

openclaw models list

设置默认模型（提供商/模型名 格式）：

openclaw models set deepseek/deepseek-v4-flash

例如使用火山引擎（豆包）：

openclaw models set volcengine-plan/deepseek-v4-flash

配置文件位于 ~/.openclaw/openclaw.json。默认模型对应字段：

{
  agents: {
    defaults: {
      model: {
        primary: "deepseek/deepseek-v4-flash",
      },
    },
  },
}

修改后重启 Gateway 生效：

openclaw gateway restart

在向导中选择「添加模型账号」，或直接运行：

openclaw onboard

选择「添加提供商」并粘贴对应 API Key 即可。多个提供商可并存，随时通过 openclaw models set 切换默认模型。