封面

【完整踩坑王】OPENCLAW安装&通过UI配置API指北

一、安装前准备

基础要求

  • 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,结果如下:

openclaw

操作指南:

左右选择,enter确认,空格选框。

只贴关键选项。

Onboarding mode

进入 Onboarding mode 选择界面时,对于首次配置的用户,建议优先选择 QuickStart 模式——该模式以「最小配置+最快部署」为目标,可跳过非必要配置项,快速完成 OpenClaw 基础部署。

openclaw

◆Config handling

第一次配置使用 Use existing valuesUpdateReset 都行。

◆Model/auth provide

配置要使用的模型,可以在这里直接配置,也可以后续通过配置文件/UI处理。

◆Default model

进入 Default model 选择界面时,可任意选择一个模型临时占位——该配置后续将通过修改配置文件覆盖,不影响最终使用效果。

◆Select channel (QuickStart)

配置要使用的对话应用,这里可选 Skip for now ,先跳过选择。

◇ Skills status

配置技能,可以选 Yes,根据提示安装一些常用的工具。

到了 Install missing skill dependencies 环节,按下空格键选择要默认安装的 skill,可以多选。

GOOGLE的配置用不到,全部选NO。

确认重启服务。

openclaw

◆ How do you want to hatch your bot?

选择 Hatch in TUI,通过终端使用,后面也可以通过配置 Web UI 以便我们可以通过网页访问 OpenClaw。

最后查看界面输出的信息,将这些信息保存下来。

划重点:用带token的地址才能进入openclaw后台并进行操作,否则会被unauthorized: gateway token missing

openclaw

到这里就安装完成了,如果要配置公网和token就ctrl+c退出程序(会后台运行)再输入:

openclaw configure

安装以外配置详情请看官方文档,不过多赘述。

三、使用OpenClaw UI配置API

可以看见成功进入了openclaw的管理页面,要是没token就不能设置。

openclaw

1.进入Config-Models-Providers

划重点:API要设置openai-completions,不然亲测API没法用。

记得设置完了点一下save。

openclaw

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

openclaw

openclaw


2.进入Config-Agents-Defaults

搜索Primary Models。

输入你刚才设置的Entry名/models名,参数不用设置,记得save。

openclaw


四、打开WSL测试API

1.查看模型

输入:

	openclaw models list

有models说明设置成功了:

openclaw

2.测试api

输入:

openclaw models status --probe

只要返回ok就ok了


openclaw

发布评论
全部评论(0)