# Linux系统

# Ubuntu(乌班图) linux系统安装

简介：

Ubuntu是一个广受欢迎的开源操作系统，基于Debian GNU/Linux操作系统，旨在为大众提供一个免费、易于使用、高度安全、可靠稳定、易于定制的操作系统。Ubuntu拥有友好的界面和易于使用的软件中心，其中包含了大量的免费软件。Ubuntu是一个开放源代码的项目，每6个月发布一次更新。它主要适用于个人计算机和服务器，支持多种平台，如桌面计算机、移动设备和云计算，甚至可以用于物联网设备。Ubuntu还拥有一个强大的社区，用户可以在社区中获取技术支持和分享经验。Ubuntu的设计理念是“人性化”，在过去的几年中，Ubuntu已经成为了一个备受欢迎的操作系统，并被广泛用于个人、工作和教育等各个领域。

### **安装前注意事项**

#### **1.准备8G或8G以上U盘（32G以内）。**

#### **2.安装系统前备份好个人需要数据（制作U盘会格式化U盘，U盘内的重要文件也要事先备份好）**

### 准备工具：

#### 1.Ubuntu(乌班图)系统镜像文件

**Ubuntu官网：[https://ubuntu.com/download/desktop](https://ubuntu.com/download/desktop)**

**点击【Download】即可下载Ubuntu的ISO系统镜像文件**

[![image.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/xX7image.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/xX7image.png)

#### 2.Rufuse写盘工具

#### **下载地址：[http://rufus.ie/zh/](http://rufus.ie/zh/)**

### 安装步骤：

#### 1.首先下载好Ubuntu系统镜像文件和Rufuse写盘工具

[![image 1.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/9wFimage-1.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/9wFimage-1.png)

#### 2.插入U盘，打开Rufuse写盘工具，选择Ubuntu系统镜像文件

[![image 2.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/EBdimage-2.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/EBdimage-2.png)

#### 3.点击开始，写入镜像到U盘

[![image 3.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/413image-3.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/413image-3.png)

如果出现以下提示，选择以ISO镜像模式写入，点击【OK】

[![image 4.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/pakimage-4.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/pakimage-4.png)

[![image 5.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/TPLimage-5.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/TPLimage-5.png)

#### 4.写入完成后，拔掉U盘，插入到主机，按下电源进行启动，当屏幕出现Logo，迅速按下【F7】键，进入引导启动菜单

[![image 6.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/6Xpimage-6.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/6Xpimage-6.png)

#### 5.选择你的U盘，按回车键进入[![image 7.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/Ysyimage-7.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/Ysyimage-7.png)

#### 6.选择【Try Or Install Ubuntu】按回键，进入安装程序[![image 8.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/X8rimage-8.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/X8rimage-8.png)

#### 7.语言选择，【中文】，下一步

[![image 9.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/ee4image-9.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/ee4image-9.png)

#### 8.选择安装Ubuntu，下一步

[![image 10.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/mnYimage-10.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/mnYimage-10.png)

#### 9.键盘布局默认，下一步

[![image 11.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/JXhimage-11.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/JXhimage-11.png)

#### 10.连接到互联网选择，【我现在不想连接到互联网】，下一步

[![image 12.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/5WFimage-12.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/5WFimage-12.png)

#### 11.应用程序和更新默认即可，直接下一步

[![image 13.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/fIqimage-13.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/fIqimage-13.png)

#### 12.勾选擦除磁盘并安装Ubuntu，下一步，如果原有硬盘有数据，请先备份再进行安装

[![image 14.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/N2Timage-14.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/N2Timage-14.png)

#### 13.点击安装

[![image 15.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/LhPimage-15.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/LhPimage-15.png)

#### 14.时区选择【shanghai】，下一步

[![image 16.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/Veeimage-16.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/Veeimage-16.png)

#### 15.设置用户名和登陆密码，下一步

[![image 17.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/Rasimage-17.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/Rasimage-17.png)

#### 16.主题默认，下一步

[![image 18.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/QOdimage-18.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/QOdimage-18.png)

#### 17.耐心等待系统安装

[![image 19.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/WOMimage-19.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/WOMimage-19.png)

#### 18.系统安装完成后，拔掉U盘，点击立即重启

[![image 20.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/k6Bimage-20.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/k6Bimage-20.png)

#### 19.启动完成后，输入刚才设置好的密码登陆即可进入桌面

[![image 21.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/US1image-21.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/US1image-21.png)

#### 20.到这里Ubuntu系统就已经安装完成了，可以正常使用啦！

[![image 22.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/DKjimage-22.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/DKjimage-22.png)

####   

# Ubuntu 开启局域网络唤醒开机教程（WoL）

#### **在设备关闭电源之后，我们可以通过局域网唤醒开机，此功能的主要目的在于预防突然断电等突发状况。**

#### **本教程以Ubuntu 23.04版本为例**

[![截图+2023-11-13+11-29-08.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-29-08.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-29-08.png)

### **具体操作步骤：**

#### **1.创建 systemd 自启动设置文件**

#### **输入命令：`sudo vim /etc/systemd/system/wol.service`**

[![截图+2023-11-13+11-05-42.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-05-42.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-05-42.png)

#### **放入以下内容：**

```HTML
[Unit]
Description=Wake-on-LAN for %i
Requires=network.target
After=network.target

[Service]
ExecStart=/sbin/ethtool -s %i wol g
Type=oneshot

[Install]
WantedBy=multi-user.target

```

#### **输入完成后按 `:wq！`进行保存**

[![截图+2023-11-13+11-07-19.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-07-19.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-07-19.png)

#### **2.确定网卡名称，输入命令：`ip a`**

[![截图+2023-11-13+11-10-44.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-10-44.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-10-44.png)

#### **你如果你有多个网卡，可以根据自己的实际网卡来设置，我这里网卡名称是`en3s0`。一般来说，使用有线网卡进行 WoL 的配置。**

#### **3.启用指定网卡的 WoL 自启动文件**

#### **命令：`systemctl enable wol@enp3s0`**

[![截图+2023-11-13+11-15-51.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-15-51.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-15-51.png)

#### **4.启动**

#### **命令:`systemctl start wol@enp3s0`**

[![截图+2023-11-13+11-17-49.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-17-49.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-17-49.png)

#### **5.测试是否开启**

#### **命令：`ethtool enp3s0`**

[![截图+2023-11-13+11-24-31.png](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/scaled-1680-/2023-11-1311-24-31.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2025-03/2023-11-1311-24-31.png)

#### **可以看到 `Wake-on：g`配置已经生效。重启后再次尝试，配置依然生效。**

#### **Linux 可以使用 `etherwake` 唤醒设备开机，使用方式：**

#### **`etherwake -b [被唤醒设备网卡的mac地址] -i [发出唤醒请求的网卡名称]`**

#### **也可以使用 `wakeonlan` 唤醒开机，使用方式：**

#### **`wakeonlan [被唤醒设备网卡的mac地址]`**

# “龙虾款”切换本地模型指南

<span class="md-plain">零刻预装 OpenClaw+ 本地模型的机型是通过 llama.cpp 运行本地模型，支持自行新增或删除本地模型。</span>

<span class="md-plain">本教程以零刻 GTR9Pro 「预装 OpenClaw」机型为例，实际上手操作切换本地模型，只需按如下步骤操作即可。</span>

> <span class="md-plain">本教程仅适用于预装OpenClaw+本地模型的零刻产品</span>

<div cid="n3" class="md-hr md-end-block" id="bkmrk-" mdtype="hr" tabindex="-1">---

</div><span class="md-pair-s">**<span class="md-plain">1. 下载模型</span>**</span>

<span class="md-plain">llama.cpp 使用 GGUF 格式的模型文件，建议通过以下两种方式下载模型：</span>

1. <span class="md-plain">Hugging Face（需</span><span class="md-pair-s ">**<span class="md-plain">科学上网</span>**</span><span class="md-plain">）</span>
2. <span class="md-meta-i-c  md-link">[<span class="md-plain">ModelScope</span>](https://doc.bee-link.com.cn/www.modelscope.cn/models)</span><span class="md-plain">（魔塔社区）</span>

<span class="md-plain">这里我们使用魔塔社区下载 </span><span class="md-pair-s" spellcheck="false">`Qwen3.6-35B-A3B-UD-Q8_K_XL.gguf`</span><span class="md-plain"> 模型，这是一个高阶 8 位量化版本，精度损耗极低，兼顾优质推理能力与合理显存占用，适配本地部署日常使用。</span>

> <span class="md-plain">请根据主机实际配置选择合适的模型。</span>

<div cid="n3" class="md-hr md-end-block" id="bkmrk--1" mdtype="hr" tabindex="-1"></div>[![下载模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/raVXZOCgNkVV2yhG-cVjmox6YEZ.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/raVXZOCgNkVV2yhG-cVjmox6YEZ.png)

<span class="md-plain">下载好以后，执行以下命令将模型剪切至本地模型目录：</span>

```
sudo mv /home/用户名/下载/Qwen3.6-35B-A3B-UD-Q8_K_XL.gguf /opt/models/
```

> <span class="md-plain">注：在终端输入密码默认不会显示，正常输入后回车执行即可 </span>

<span class="md-plain">剪切后验证是否剪切成功，执行：</span>

```
sudo ls /opt/models/
```

<span class="md-plain">输出结果中包含文件（Qwen3.6-35B-A3B-UD-Q8\_K\_XL.gguf），说明剪切成功。</span>

[![移动模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/Tgu9whUjjBWuQ21P-igy9RT61Ov.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/Tgu9whUjjBWuQ21P-igy9RT61Ov.png)

<span class="md-pair-s ">**<span class="md-plain">2. 编辑 llama 启动脚本</span>**</span>

<span class="md-plain">保存好本地模型后，需要手动编辑 llama 启动脚本，执行：</span>

```
sudo nano /usr/local/bin/start-llama.sh
```

<span class="md-plain">修改 </span><span class="md-pair-s" spellcheck="false">`MODEL`</span><span class="md-plain"> 字段，将后面双引号中的模型名称改为新的模型名称，其他不用修改。</span>

<span class="md-plain">编辑完成后，按下 </span><span class="md-pair-s" spellcheck="false">`Ctrl+X`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`Y`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`回车`</span><span class="md-plain"> ，保存退出编辑器。</span>

[![编辑脚本.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/FCgZer7p6H1rYGa8-zYsP4vnUYO.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/FCgZer7p6H1rYGa8-zYsP4vnUYO.png)

<span class="md-pair-s ">**<span class="md-plain">3. 验证新模型是否启用</span>**</span>

<span class="md-plain">编辑并保存好 llama 启动脚本后，重启一下系统：</span>

```
reboot
```

<span class="md-plain">重启后打开网页 </span><span class="md-pair-s" spellcheck="false">`127.0.0.1:8080`</span><span class="md-plain"> ，可以看到显示的模型名称为 </span><span class="md-pair-s" spellcheck="false">`Qwen3.6-35B-A3B-UD-Q8_K_XL.gguf`</span><span class="md-plain">，说明模型切换成功，打个招呼确认模型能否正常使用，得到回应后说明成功了。</span>

[![验证模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/XjsJC8qtW24jbUUy-kZM8fXASAJ.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/XjsJC8qtW24jbUUy-kZM8fXASAJ.png)

<span class="md-pair-s">**<span class="md-plain">4. OpenClaw 切换新模型</span>**</span>

<span class="md-plain">新模型就绪后，还需要到 OpenClaw 中切换默认模型，打开终端执行：</span>

```
openclaw config
```

<span class="md-plain">选择 </span><span class="md-pair-s" spellcheck="false">`Local`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`Model`</span>

<span class="md-plain">然后选择 </span><span class="md-pair-s" spellcheck="false">`vLLM`</span><span class="md-plain">；</span>

<span class="md-plain">vLLM base URL 修改为 </span><span class="md-pair-s" spellcheck="false">`http://127.0.0.1:8080/v1`</span><span class="md-plain">；</span>

<span class="md-plain">vLLM API Key 填写 </span><span class="md-pair-s" spellcheck="false">`sk-local`</span><span class="md-plain">（可以随意输入）</span>

<span class="md-plain">vLLM model 填写 </span><span class="md-pair-s" spellcheck="false">`Qwen3.6-35B-A3B-UD-Q8_K_XL.gguf`</span>

<span class="md-plain">然后回车，再按一次回车即可。</span>

[![配置openclaw.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/TsgqIV4nP1gD8PoR-openclaw.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/TsgqIV4nP1gD8PoR-openclaw.png)

<span class="md-plain">这样就配置完成了，再移动到 </span><span class="md-pair-s" spellcheck="false">`Continue`</span><span class="md-plain"> 并按下回车，结束配置。</span>

[![完成配置openclaw.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/yHZKitudunxnxSkL-openclaw.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/yHZKitudunxnxSkL-openclaw.png)

<span class="md-plain">结束配置后，还需要重启 OpenClaw Gateway 以应用修改，执行：</span>

```
openclaw gateway restart
```

<span class="md-plain">重启后即可以新模型使用 OpenClaw。</span>

[![测试openclaw.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/w8ZeMPEeLgZ9wJQL-openclaw.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/w8ZeMPEeLgZ9wJQL-openclaw.png)

<div cid="n165" class="md-hr md-end-block" id="bkmrk--10" mdtype="hr" tabindex="-1">---

</div><span class="md-pair-s md-expand">**<span class="md-plain">多模型切换</span>**</span>

<span class="md-plain">配置好新模型后，原先的模型如果没有取消勾选，会自动以备用模型配置，可以通过以下命令查询可用模型列表：</span>

```
openclaw models list
```

[![可用模型列表.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/7ynrTjCE6s1HgQPf-Wpw2YCzBBK.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/7ynrTjCE6s1HgQPf-Wpw2YCzBBK.png)

<span class="md-plain">在终端中可以切换默认模型，无需重启 Gateway，执行：</span>

```
openclaw models set 模型全称
```

[![切换默认模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/6vKBDYJnd3eWxwfQ-HFWb6PTjFK.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/6vKBDYJnd3eWxwfQ-HFWb6PTjFK.png)

<span class="md-plain">如需临时切换模型，可以在与 OpenClaw 的对话中回复：</span><span class="md-pair-s" spellcheck="false">`/model 模型全称`</span><span class="md-plain"> 快速切换，无需重启。</span>

[![临时切换模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/rZGCyxGAAsL6WuME-GyKm6j7uUD.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/rZGCyxGAAsL6WuME-GyKm6j7uUD.png)

---

**<span class="md-plain">查看显存占用</span>**

<span class="md-plain">首先需要下载工具，在终端执行：</span>

```
sudo apt install mesa-utils
```

<span class="md-plain">安装成功后，再次执行：</span>

```
glxinfo | grep -i "video memory\|vram"
```

<span class="md-plain">即可查看当前显存情况</span>

[![剩余显存.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/tUaYvQwRTbb1xU7h-2Z8G7s7Mbg.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/tUaYvQwRTbb1xU7h-2Z8G7s7Mbg.png)

> <span class="md-plain">Video Memory：总显存容量</span>
> 
> <span class="md-plain">Currently available dedicated video memory：剩余可用显存</span>

<span class="md-plain md-expand">如图，目前剩余可用显存约为 54G，说明 GTR9Pro 运行该模型后仍有大量余裕，且运行速度完全足够日常使用。</span>

<div cid="n73" class="md-hr md-end-block" id="bkmrk--16" mdtype="hr" tabindex="-1">---

</div><span class="md-pair-s md-expand">**<span class="md-plain">关闭思考模式</span>**</span>

<span class="md-plain">Qwen3.6-35B-A3B 模型支持关闭思考模式。</span>

<span class="md-plain">如需关闭思考模式（可提高回复速度），可以在最底下的 "--n-gpu-layers 99 </span>"<span class="md-plain"> 的下方新增一条 </span><span class="md-pair-s" spellcheck="false">`--chat-template-kwargs '{"enable_thinking":false}'`</span><span class="md-plain">，如图</span>

[![关闭思考模式.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/XeeSg9sq4Q2MfMkW-ZMqzdyHMjs.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/XeeSg9sq4Q2MfMkW-ZMqzdyHMjs.png)

<span class="md-plain">编辑完成后，按下 </span><span class="md-pair-s" spellcheck="false">`Ctrl+X`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`Y`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`回车`</span><span class="md-plain md-expand"> ，保存退出编辑器。</span>

<span class="md-plain">然后重启系统即可。</span>

[![验证关闭思考.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/sJEwimp481jVfR23-vpDZu65hHE.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/sJEwimp481jVfR23-vpDZu65hHE.png)

# “龙虾款”切换云端模型指南

<span class="md-plain">出于尝鲜或测试目的，很多用户在首次初始化 OpenClaw 时配置的大模型往往不是实际想要的，如果想要切换其他云端模型，应该怎么操作呢？</span>

<span class="md-plain">其实很简单，接下来就实际上手演示 OpenClaw 切换其他云端模型过程。</span>

<div cid="n5" class="md-hr md-end-block" id="bkmrk-" mdtype="hr" tabindex="-1">---

</div><span class="md-pair-s">**<span class="md-plain">1. 准备模型 API</span>**</span>

<span class="md-plain">首先要准备一个新模型的 API Key，这里以 </span><span class="md-pair-s" spellcheck="false">`火山方舟大模型`</span><span class="md-plain"> 为例，进入</span><span class="md-meta-i-c  md-link">[<span class="md-plain">火山方舟官网</span>](https://www.volcengine.com/product/ark)</span><span class="md-plain">，注册处登录后进入控制台，点击 </span><span class="md-pair-s" spellcheck="false">`开通管理`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`语言模型`</span><span class="md-plain">，开通想要使用的模型。</span>

> <span class="md-plain">此处开通的模型为按量付费模型，免费额度用完后需充值才能继续使用</span>
> 
> <span class="md-plain">火山方舟提供 Coding Plan 订阅服务，如体验满意可考虑付费开通</span>

[![开通模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/wSN0RFe3uzqEL7Qw-O4IZkc9rNq.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/wSN0RFe3uzqEL7Qw-O4IZkc9rNq.png)

<span class="md-plain">然后点击 </span><span class="md-pair-s" spellcheck="false">`API Key 管理`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`创建 API Key`</span><span class="md-plain"> ，名称随意设置，然后点击 </span><span class="md-pair-s" spellcheck="false">`创建`</span><span class="md-plain"> 即可。</span>

[![火山官网.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/mcX5KdVM6UKt0ogs-7o0uPbsEig.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/mcX5KdVM6UKt0ogs-7o0uPbsEig.png)

<span class="md-plain">创建成功后，点击 </span><span class="md-pair-s" spellcheck="false">`API Key`</span><span class="md-plain"> 下方的小眼睛，复制完整 API Key。</span>

[![火山API.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/AjygCf1d8sfHW3tw-api.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/AjygCf1d8sfHW3tw-api.png)

<span class="md-pair-s">**<span class="md-plain">2. 切换 OpenClaw 模型</span>**</span>

<span class="md-plain">打开终端执行：</span>

```
openclaw config
```

<span class="md-plain">选择 </span><span class="md-pair-s" spellcheck="false">`Local`</span><span class="md-plain"> - </span><span class="md-pair-s" spellcheck="false">`Model`</span>

<span class="md-plain">然后选择 </span><span class="md-pair-s" spellcheck="false">`Volcano Engine`</span>

> <span class="md-plain">火山方舟大模型服务在 OpenClaw 的名称就是 “Volacno Engine”</span>
> 
> <span class="md-plain">其他大模型服务可通过模型官网的调用指南查阅</span>

<span class="md-plain">然后粘贴 API Key（粘贴快捷键：Ctrl+Shift+V）</span>

<span class="md-plain">然后回车</span>

[![切换模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/F9PLbfAR3btO9OHd-hNmN0zPpE5.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/F9PLbfAR3btO9OHd-hNmN0zPpE5.png)

<span class="md-plain">根据实际情况选择模型，然后再按回车确定即可。</span>

> <span class="md-plain">火山方舟大模型服务区分 volcengine 和 volcengine-plan 两种模型</span>
> 
> <span class="md-plain">前者是按量计费模型，后者是 Coding Plan 模型</span>

[![模型列表.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/cTdLw9ijWIOr6s61-C4v4LZ88ja.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/cTdLw9ijWIOr6s61-C4v4LZ88ja.png)

<span class="md-plain">这样就配置完成了，再移动到 </span><span class="md-pair-s" spellcheck="false">`Continue`</span><span class="md-plain"> 并按下回车，结束配置。</span>

[![完成配置.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/tiox00oLOREcQPlp-RWuowkOR4H.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/tiox00oLOREcQPlp-RWuowkOR4H.png)

<span class="md-plain">结束配置后，还需要重启 OpenClaw Gateway 以应用修改，执行：</span>

```
openclaw gateway restart
```

<span class="md-plain">重启后即可以新模型使用 OpenClaw。</span>

[![验证模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/uqIC9QcHSFXSGqyY-F97k5pq3jO.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/uqIC9QcHSFXSGqyY-F97k5pq3jO.png)

<span class="md-pair-s">**<span class="md-plain">3. 多模型切换</span>**</span>

<span class="md-plain">配置好新模型后，原先的模型如果没有取消勾选，会自动以备用模型配置，可以通过以下命令查询可用模型列表：</span>

```
openclaw models list
```

[![可用模型列表.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/6hfd8FjBxzD8EfZG-hPbN4HPFS1.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/6hfd8FjBxzD8EfZG-hPbN4HPFS1.png)

<span class="md-plain">在终端中可以切换默认模型，无需重启 Gateway，执行：</span>

```
openclaw models set 模型全称
```

[![切换默认模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/Bswx5DT1nvPf84fN-8gJN1HWM9D.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/Bswx5DT1nvPf84fN-8gJN1HWM9D.png)

<span class="md-plain">如需临时切换模型，可以在与 OpenClaw 的对话中回复：</span><span class="md-pair-s" spellcheck="false">`/model 模型全称`</span><span class="md-plain"> 快速切换，无需重启。</span>

[![临时切换模型.png](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/scaled-1680-/WMYBfJCyhz1zw82h-J4pOJkZlcF.png)](https://doc.bee-link.com.cn/uploads/images/gallery/2026-05/WMYBfJCyhz1zw82h-J4pOJkZlcF.png)