OpenClaw 配置教程

仅第 4 步文件路径随系统切换

快速生成配置片段

输入 API Key 和主模型后，下方 JSON 配置会自动更新，可直接复制使用。

1

安装 Node.js 环境和 npm

OpenClaw 依赖 Node.js 运行环境，建议安装 LTS（长期支持）版本。

官网下载（推荐）

  1. 访问 nodejs.org
  2. 点击 LTS 版本进行下载
  3. 运行安装包并按默认引导完成安装

命令行安装

# 使用 Scoop
scoop install nodejs
# 或使用 Choco
choco install nodejs

Windows 注意事项

  • 建议优先使用 PowerShell。
  • 若提示权限不足，可尝试以管理员身份运行终端。
  • 如被安全软件拦截，请将 Node.js 或 npm 安装目录加入白名单。

验证安装是否成功

安装完成后在终端中执行：

# 检查 Node.js 版本
node --version

# 检查 npm 版本
npm --version

若显示版本号，说明 Node.js 与 npm 已安装成功。

2

安装 OpenClaw

先确保已安装 Node.js 和 npm，然后在终端执行安装命令。

安装命令

# 全局安装 OpenClaw
npm i -g openclaw
# 如果下载慢，可尝试国内源
npm i -g openclaw --registry=https://registry.npmmirror.com

验证安装

openclaw --version

显示版本号即安装成功。

3

执行 onboard 初始配置

1、输入 openclaw onboard 开始配置：

openclaw onboard

01、选择 Yes

I understand this is powerful and inherently risky. Continue?
> Yes / No

02、选择 QuickStart（先跳过）

Onboarding mode
> QuickStart (Configure details later via openclaw configure.)
  Manual

03、模型供应商选择最下面的 Custom Provider

Model/auth provider
  OpenAI (Codex OAuth + API key)
  Anthropic
  ...
> Custom Provider (Any OpenAI or Anthropic compatible endpoint)
  Skip for now

04、设置模型

API Base URL
https://ai.wdcodex.xyz/v1

API Key (leave blank if not required)
sk-xxxxxxxxxxxxx

Endpoint compatibility
OpenAI-compatible

Model ID
gpt-5.3-codex

Verification successful.

Endpoint ID
custom

Model alias (optional)
e.g. local, ollama

API Base URL：输入

https://ai.wdcodex.xyz/v1

API Key：输入购买的 API Key

sk-xxxxxxxxxxxxx

Endpoint compatibility：选择 OpenAI-compatible

Model ID：输入 gpt-5.3-codex，或者 gpt-5.2 等其他模型（可展开下方模型价格表查看）

等待验证成功：看到 Verification successful.

Endpoint ID：输入任意名称，默认即可

Model alias (optional)：默认留空即可

模型价格表（点击展开）
模型价格
模型 输入 /1M 输出 /1M 缓存 /1M 币种
gpt-5 1.25 10 0.125 USD
gpt-5-codex 1.25 10 0.125 USD
gpt-5-codex-mini 0.25 2 0.025 USD
gpt-5.1 1.25 10 0.125 USD
gpt-5.1-codex 1.25 10 0.125 USD
gpt-5.1-codex-max 1.25 10 0.125 USD
gpt-5.1-codex-mini 0.25 2 0.025 USD
gpt-5.2 1.75 14 0.175 USD
gpt-5.2-codex 1.75 14 0.175 USD
gpt-5.3-codex 1.75 14 0.175 USD

05、可先跳过

Select channel (QuickStart)
> Telegram (Bot API)
  WhatsApp (QR link)
  Skip for now

06、可先跳过

Configure skills now? (recommended)
  Yes
> No

07、可先跳过

Enable hooks?
> Skip for now
  boot-md
  bootstrap-extra-files

08、安装 Gateway service

Gateway service already installed
  Restart
> Reinstall
  Skip

09、先跳过启动 bot

How do you want to hatch your bot?
  Hatch in TUI (recommended)
  Open the Web UI
> Do this later

先完成修改配置文件步骤后再启动 bot（本页对应第 4 步，PDF 原文为“第 2 步”）。

如果第 09 步直接启动失败，先继续第 4 步修改配置文件，再执行网关重启。

4

修改 openclaw.json 配置

打开配置文件：C:\Users\<用户名>\.openclaw\openclaw.json

notepad "C:\Users\<用户名>\.openclaw\openclaw.json"
需要重点修改两处，建议分两部分处理：
01) "models" -> "providers" -> "custom" -> "models"
02) "agents" -> "defaults" -> "thinkingDefault" 与 "agents" -> "defaults" -> "models"

第 1 部分：配置 models.providers.custom.models

这一部分决定模型能力和窗口参数，按下方片段替换/补全：

{}
reasoning: true：改为 true，支持推理。
input: ["text", "image"]：添加 image 输入。
contextWindow: 272000：建议大于 16000，否则可能报错。
maxTokens: 65536：可适当设置更大。

第 2 部分：配置 agents.defaults.thinkingDefault 与 agents.defaults.models

这一部分决定默认思考强度与可用模型映射：

{}
thinkingDefault 可选：low / medium / high / xhigh。
agents.defaults.models 中要添加次模型映射，例如 custom/gpt-5.2。
5

开始使用 OpenClaw

01. 重启网关

openclaw gateway restart

02. 终端模式

openclaw tui

03. 网页模式

openclaw dashboard
附

附录说明

  • reasoning 设为 true，支持推理。
  • input 中包含 image，支持图像输入。
  • contextWindow 建议大于 16000，示例使用 272000。
  • maxTokens 可适当设置大一些，示例为 65536。
  • agents.defaults.models 要同步添加已配置模型。

完成以上 5 步后，即可在终端或网页中使用 OpenClaw。