0、准备工作#

本教程所有内容都建立在用户已经安装好OpenClaw的前提下

已经安装好OpenClaw的前提！已经安装好OpenClaw的前提！

本教程只适用国际版、正规从官方下载部署的OpenClaw！

一键部署、快速部署、中文版OpenClaw等等非正规，修改过文件和代码版本，都有可能无法连接一点 API，无法正常使用模型！

在开始前，请确认你已经具备以下信息 👇

你的中转 API 信息#

先获取以下三项：

API Base URL（接口地址） 一点API URL链接地址：

1
https://api.yidianhub.com/v1

API Key（密钥） 您在蓝移API后台生成的key

1
sk-xxxxxxxxxxxxxxxx

支持的模型名称：

1
# Haiku
2
claude-haiku-4-5-20251001
3

4
# Sonnet
5
claude-sonnet-4-5-20250929
6
claude-sonnet-4-5-20250929-thinking
7
claude-sonnet-4-6
8

9
# Opus
10
claude-opus-4-8
11
claude-opus-4-7
12
claude-opus-4-6
13
claude-opus-4-5-20251101
14
claude-opus-4-5-20251101-thinking

复制填写以上信息时，请注意千万不要有空格，会影响进程

一、特别篇：云服务器接入#

以腾讯云服务器为例，先找到对应的配置画面，然后填入对应数据即可

表单输入#

1
# Provider 供应商
2
Yidian //这里随便填
3

4
# base_url 网址
5
https://api.yidianhub.com/v1
6

7
# api API格式
8
openai-completions
9

10
# model id & name 模型id 和 名字 建议统一，三选一即可
11
claude-haiku-4-5-20251001
12

13
claude-sonnet-4-6
14

15
claude-opus-4-7

JSON输入#

1
{
2
  "provider": "Yidian",
3
  "base_url": "https://api.yidianhub.com/v1",
4
  "api": "openai-completions",
5
  "api_key": "sk-*********填入你自己的令牌***************",
6
  "model": {
7
    "id": "claude-opus-4-7",
8
    "name": "claude-opus-4-7"
9
  }
10
}

二、Windows 配置 OpenClaw#

Windows教程仅适用于Windows本机适用，WSL2虚拟机可能会遇到更多不可预料的网络、端口、防火墙等问题，故不建议使用虚拟机部署OpenClaw，最推荐的还是使用Linux和Mac系统。

0️⃣ 配置 OpenClaw#

在命令行使用命令进入** ****OpenClaw **初始化

OpenClaw 初始化

1
openclaw onboard

选 Yes

Yes ✔ / No

选第一个 QuickStart

✔QuickStart 快速开始
Manual

一般选第三个 ✔ vLLM 供应商

如果没有 vLLM 再考虑 Custom Provider（自定义）

（这种情况可以翻到本教程第六章添加/切换模型）

其中base URL，填写一点API：

1
https://api.yidianhub.com/v1

这里填写自己的令牌（API key）（sk- 开头的），然后回车确认即可

模型名称可以参考 🍺 常用模型列表，以下列举三种常用模型：

性价比模型

1
claude-haiku-4-5-20251001

综合推理模型

1
claude-sonnet-4-6

最强模型

1
claude-opus-4-6

选第一个就行 Keep current

✔ Keep current (保持默认

Enter model manually

vllm/claude-sonnet-4-6

选最底下那个 Skip for now

我们先不设置机器人，选最底下的 ✔ Skip for now（现在跳过）

选最底下那个 Skip for now

联网搜索供应商，我们也暂且跳过✔ Skip for now（现在跳过）

选第二个 NO

是否安装额外的 skills 技能？✔ No

我们也不装，先启动起来再说

选第一个 Skip for now 选择网络钩子（hooks），还是先不选

1️⃣ 加载网关#

随后会弹出新页面，是 Gateway 网关的信息（使用的时候不可关闭），可以不理会

安装完网关后，会让我们选择启动界面，选择1、2 其中都可以

✔ Hatch in TUI（在命令行中启动）

✔ Open the Web UI（在网页Web UI中启动）

❌ Do this later （稍后再启动）

我们选择TUI（命令行中测试运行）

他自动加载了我们刚刚设置好的 vllm/claude-sonnet-4-6 模型

输入一些文字，他就会有回复。

恭喜你！到此为止，你已算安装 OpenClaw 成功

2️⃣ 二次启动#

如果下次在启动的时候，需要打开两个命令行窗口

一个执行打开网关命令（使用过程不可关闭）：

启动网关

1
openclaw gateway start

然后再启动命令行

1
openclaw tui

如果命令行能启动但不能回复，那么请使用自动修复命令

自动修复

1
openclaw doctor

一般不能启动的问题，多为网关问题，在 Start gateway service now？时

选择✔Yes 修复，然后再启动 OpenClaw 即可

三、Mac /Linux 配置 OpenClaw#

本教程有多次修订更改，因为OpenClaw版本更新较快，部分内容可能需要客户自行调整

命令行基本多端通用，Mac与Linux配置教程合并了，因为本身流程也几乎一模一样

0️⃣ 配置 OpenClaw#

进入**OpenClaw **的初始化设置，空格选择，回车确认

1
openclaw onboard

选 Yes

Yes ✔ / No

选第一个 QuickStart

✔QuickStart 快速开始
Manual

选第一个 Use existing values

✔Use existing values
Update values
Reset

1️⃣ Provider 选择#

优先选择

自定义模型

1
Custom Provider

如图所示

如果不行再考虑：

本地模型

1
vLLM

2️⃣ 填写URL & APi Key#

删掉默认的URL，随后就可以填入我们的URL

我们的URL为：https://api.yidianhub.com/v1

这里填写自己的令牌（API key）（sk- 开头的），然后回车确认即可

模型名称可以参考 🍺 常用模型列表，以下列举三种常用模型：

性价比模型

1
claude-haiku-4-5-20251001

综合推理模型

1
claude-sonnet-4-6

最强模型

1
claude-opus-4-6

Endpoint ID （供应商名称/标识）填 ** Yidian **

Model alias （模型标识）可填可不填

后续的APP、Skills因为每个人的设置需求都不一样，就不展示了，用户自己选择

3️⃣ 选择UI界面#

如果前面设置一切正常，那么这一步只要不选第3个都无所谓。

熟悉 **OpenClaw **和有一定代码基础的客户朋友，一般都会选第1个

新手小白、第一次使用和摸索 **OpenClaw **的客户朋友建议选择第2个（网页UI界面）

How do you want to hatch your bot? 你想用哪种方式来“启动/创建（初始化）”你的 bot？

Hatch in TUI (recommended) 在 TUI（终端文本界面）
Open the Web UI 打开 网页界面（Web UI）
Do this later 以后再做 / 先跳过

四、验证是否连接成功（必做）#

一句话总结版，OpenClaw 本质是 OpenAI API 兼容客户端，只需要把URL* 和*API_KEY*模型填写我们提供的模型ID。一般前面步骤没有问题之后，进入网页UI中，可以直接使用对话框进行对话，即可正常使用 *OpenClaw。

✅ 正常情况#

发送一句简单对话，例如：“你好，请用一句话介绍你自己”
几秒内返回 Claude 风格回复
后台能看到 Token 消耗记录

1）Web UI 版（对新人友好）#

或者你也可以使用：

启动openclaw网关

1
openclaw gateway

然后在网页中输入：

openclaw默认端口

1
http://127.0.0.1:18789/

下面以正常启动后的Web UI 网页UI举例图：

2）TUI Web（推荐）#

启动命令

1
openclaw tui

正常启动后，互动的结果大概如下：

❌ 常见报错与解决#

1️⃣ 401 / Unauthorized#

原因：

API Key 错误
Key 未生效

解决：

重新复制 Key
确认没有多余空格

2️⃣ 404 / Not Found#

原因：

Base URL 没有 /v1

✅ 正确示例：

1
https://api.yidianhub.com/v1

3️⃣ 模型不存在 Model Not Found之类#

原因：

模型ID名称填错/选择Provider不对

解决：

确认模型是否是跟我们提供的模型ID名称一定一致，且不能有空格！

4️⃣ Web UI前端没连接#

unauthorized: gateway token missing (open the dash board URL and paste the token in Control Ul settings)

原因：

网页没有获取到token

解决：

Linux / MacOs

1
grep -n '"token"' ~/.openclaw/openclaw.json | head

Windows

1
Select-String -Path "$env:USERPROFILE\.openclaw\openclaw.json" -Pattern '"token"' | Select-Object -First 1

1
findstr /n /c:"\"token\"" "%USERPROFILE%\.openclaw\openclaw.json"

比如：

http://127.0.0.1:18789/?token=xxxxxxxxxxxxxxxx

5️⃣ 已断开与网关的连接。#

已断开与网关的连接

unauthorized: device token mismatch (rotate/reissue device token)

重新复制令牌化url

1
openclaw dashboard --no-open

然后复制如图内容到浏览器中，即可打开WebUI

1
http://127.0.0.1:18789/#token=你自己的token

五、添加/切换模型#

前言#

理论上，方法有三种：

在命令行/终端中里面通过 openclaw config 设置添加
在 OpenClaw Web UI 直接添加新模型
在命令行/终端通过修改配置文件添加新模型

一般建议使用方法1和3，较为稳定。方法2有时候会出现很多奇奇怪怪的问题。

1）在 OpenClaw TUI中添加新模型#

进入配置

1
openclaw config

云服务器、或者配置表比较特殊的，使用 openclaw config配置时候可以找到隐藏起来的vllm或者custom，如果还没有，只能参考下面的其他方法了在诸多选项中选择 model 配置，然后按照前面的流程配置 model 即可

配置完了，选 Continue 退出

然后在终端中用 /model 切换模型选择，回车确认即可

选择模型

1
/model

最底下就是我们新加的模型

2）在命令行终端通过修改配置文件添加新模型#

查看模型配置文件所在

1
openclaw models

如图所示，可以看到模型的配置文件大概在 ~/.openclaw/openclaw.json 中

当你启动查看命令查看配置文件的时候，你会发现：

查看openclaw配置单

1
cat ~/.oepnclaw/openclaw.json

其实这里的文件配置，和OpenClaw Web UI打开的Raw 格式配置单，是一模一样的东西

1
{
2
  "meta": {
3
    "lastTouchedVersion": "2026.2.22-2",
4
    "lastTouchedAt": "2026-02-24T04:29:32.032Z"
5
  },
6
  "wizard": {
7
    "lastRunAt": "2026-02-24T04:29:32.024Z",
8
    "lastRunVersion": "2026.2.22-2",
9
    "lastRunCommand": "onboard",
10
    "lastRunMode": "local"
11
  },
12
  "models": {
13
    "mode": "merge",
14
    "providers": {
15
      "vllm": {
16
        "baseUrl": "https://api.yidianhub.com/v1",
17
        "apiKey": "__OPENCLAW_REDACTED__",
18
        "api": "openai-completions",
19
        "models": [
20
          {
21
            "id": "claude-haiku-4-5-20251001",
22
            "name": "claude-haiku-4-5-20251001",
23
            "reasoning": false,
24
            "input": [
25
              "text"
26
            ],
27
            "cost": {
28
              "input": 0,
29
              "output": 0,
30
              "cacheRead": 0,
31
              "cacheWrite": 0
32
            },
33
            "contextWindow": 128000,
34
            "maxTokens": 8192
35
          }
36
        ]
37
      }
38
    }
39
  },
40
  "agents": {
41
    "defaults": {
42
      "model": {
43
        "primary": "vllm/claude-haiku-4-5-20251001"
44
      },
45
      "models": {
46
        "vllm/claude-haiku-4-5-20251001": {}
47
      },
48
      "workspace": "/home/ubuntu/.openclaw/workspace"
49
    }
50
  },
51
  "commands": {
52
    "native": "auto",
53
    "nativeSkills": "auto",
54
    "restart": true,
55
    "ownerDisplay": "raw"
56
  },
57
  "session": {
58
    "dmScope": "per-channel-peer"
59
  },
60
  "hooks": {
61
    "internal": {
62
      "enabled": true,
63
      "entries": {
64
        "boot-md": {
65
          "enabled": true
66
        },
67
        "bootstrap-extra-files": {
68
          "enabled": true
69
        },
70
        "command-logger": {
71
          "enabled": true
72
        },
73
        "session-memory": {
74
          "enabled": true
75
        }
76
      }
77
    }
78
  },
79
  "channels": {
80
    "telegram": {
81
      "enabled": true,
82
      "dmPolicy": "pairing",
83
      "groupPolicy": "allowlist",
84
      "streaming": "off"
85
    }
86
  },
87
  "gateway": {
88
    "port": 18789,
89
    "mode": "local",
90
    "bind": "loopback",
91
    "auth": {
92
      "mode": "token",
93
      "token": "__OPENCLAW_REDACTED__"
94
    },
95
    "tailscale": {
96
      "mode": "off",
97
      "resetOnExit": false
98
    },
99
    "nodes": {
100
      "denyCommands": [
101
        "camera.snap",
102
        "camera.clip",
103
        "screen.record",
104
        "calendar.add",
105
        "contacts.add",
106
        "reminders.add"
107
      ]
108
    }
109
  }
110
}

以上JSON配置单仅供参考，用户未必能运行，作者也暂未通过此方式成功配置/添加新模型。还请用户自行摸索探究。

如果你想修改的话

1
vim ~/.oepnclaw/openclaw.json

0、准备工作#

你的中转 API 信息#

一、特别篇：云服务器接入#

表单输入#

JSON输入#

二、Windows 配置 OpenClaw#

**0️⃣ 配置 **OpenClaw#

1️⃣ 加载网关#

2️⃣ 二次启动#

三、Mac /Linux 配置 OpenClaw#

0️⃣ 配置 OpenClaw#

1️⃣ Provider 选择#

2️⃣ 填写URL & APi Key#

3️⃣ 选择UI界面#

四、验证是否连接成功（必做）#

✅ 正常情况#

1）Web UI 版（对新人友好）#

2）TUI Web（推荐）#

❌ 常见报错与解决#

1️⃣ 401 / Unauthorized#

2️⃣ 404 / Not Found#

3️⃣ 模型不存在 Model Not Found之类#

4️⃣ Web UI前端没连接#

5️⃣ 已断开与网关的连接。#

五、添加/切换模型#

前言#

1）在 OpenClaw TUI中添加新模型#

2）在命令行终端通过修改配置文件添加新模型#

0️⃣ 配置 OpenClaw#