一、安装前准备
基础要求
- Node.js ≥ 22.x
- 内存 最低 2GB,推荐 4GB+
- 磁盘空间 最低 1GB,推荐 5GB+
各平台要求
macOS
如果要构建应用:安装 Xcode / Command Line Tools
仅 CLI + Gateway:Node.js 足够
Windows
推荐使用 WSL2(Ubuntu 22.04LTS)
原生 Windows 未测试,工具兼容性较差
Linux
无额外要求
二、安装 OpenClaw
第1步 官方脚本安装 OpenClaw
在 Terminal 中执行:
curl -fsSL https://openclaw.ai/install.sh | bash
执行后会安装nodejs22+,随后默认运行openclaw,结果如下:

操作指南:
左右选择,enter确认,空格选框。
只贴关键选项。
Onboarding mode
进入 Onboarding mode 选择界面时,对于首次配置的用户,建议优先选择 QuickStart 模式——该模式以「最小配置+最快部署」为目标,可跳过非必要配置项,快速完成 OpenClaw 基础部署。

◆Config handling
第一次配置使用
Use existing values、Update、Reset都行。
◆Model/auth provide
配置要使用的模型,可以在这里直接配置,也可以后续通过配置文件/UI处理。
◆Default model
进入 Default model 选择界面时,可任意选择一个模型临时占位——该配置后续将通过修改配置文件覆盖,不影响最终使用效果。
◆Select channel (QuickStart)
配置要使用的对话应用,这里可选
Skip for now,先跳过选择。
◇ Skills status
配置技能,可以选
Yes,根据提示安装一些常用的工具。
到了 Install missing skill dependencies 环节,按下空格键选择要默认安装的 skill,可以多选。
GOOGLE的配置用不到,全部选NO。
确认重启服务。

◆ How do you want to hatch your bot?
选择
Hatch in TUI,通过终端使用,后面也可以通过配置 Web UI 以便我们可以通过网页访问 OpenClaw。
最后查看界面输出的信息,将这些信息保存下来。
划重点:用带token的地址才能进入openclaw后台并进行操作,否则会被unauthorized: gateway token missing

到这里就安装完成了,如果要配置公网和token就ctrl+c退出程序(会后台运行)再输入:
openclaw configure
安装以外配置详情请看官方文档,不过多赘述。
三、使用OpenClaw UI配置API
可以看见成功进入了openclaw的管理页面,要是没token就不能设置。

1.进入Config-Models-Providers
划重点:API要设置openai-completions,不然亲测API没法用。
记得设置完了点一下save。

Entry里面设置完了,还要设置你的api里面用什么models,注意:id里面填api厂商提供的,例如deepseek-v3.2。


2.进入Config-Agents-Defaults
搜索Primary Models。
输入你刚才设置的Entry名/models名,参数不用设置,记得save。

四、打开WSL测试API
1.查看模型
输入:
openclaw models list
有models说明设置成功了:

2.测试api
输入:
openclaw models status --probe
只要返回ok就ok了





