在 OpenClaw 中使用 ZhiFlo

下面只配置本机 OpenClaw 的模型提供方。完成后，openclaw models status 会识别 ZhiFlo，你可以把 zhiflo/<模型 ID> 设为当前模型并在本地聊天界面发送消息。

开始前

已按照 OpenClaw 官方文档安装客户端；运行 openclaw --version 能看到版本信息。
已创建一枚用于当前设备的 Token。
已复制账户当前可用的完整模型 ID。

在当前环境提供 Token

macOS、Linux 或 Bash

read -s ZHIFLO_API_TOKEN
export ZHIFLO_API_TOKEN

PowerShell

$secureToken = Read-Host "Paste your ZhiFlo Token" -AsSecureString
$env:ZHIFLO_API_TOKEN = [System.Net.NetworkCredential]::new("", $secureToken).Password

输入的 Token 只供当前用户进程读取。不要把真实值写进 openclaw.json 或项目仓库。

添加 provider

打开：

~/.openclaw/openclaw.json

把下面的 models.providers.zhiflo 合并到现有 JSON，不要覆盖其他 provider、Gateway 或用户设置。把两处 <MODEL_FROM_ZHIFLO> 替换为同一个完整模型 ID。

{
  "models": {
    "providers": {
      "zhiflo": {
        "baseUrl": "https://api.zhiflo.com/v1",
        "apiKey": "${ZHIFLO_API_TOKEN}",
        "api": "openai-completions",
        "models": [
          {
            "id": "<MODEL_FROM_ZHIFLO>",
            "name": "<MODEL_FROM_ZHIFLO>"
          }
        ]
      }
    }
  }
}

这里选择 openai-completions，服务地址为 https://api.zhiflo.com/v1。name 只控制本地显示；id 必须与账户模型 ID 一致。

检查并设为当前模型

保存 openclaw.json。
在设置环境变量的同一终端运行：
终端窗口
```
openclaw models status
```
输出中应能识别 zhiflo 和配置的模型。
把占位符替换为相同模型 ID，设置当前模型：
终端窗口
```
openclaw models set "zhiflo/<MODEL_FROM_ZHIFLO>"
```
从同一终端打开本地 OpenClaw 聊天界面。
在聊天中运行 /model status。

状态应显示 ZhiFlo 提供方地址和 OpenAI Completions 模式。
检查当前模型显示为 zhiflo/<模型 ID>。
发送：
```
不要执行工具，只回答 OK。
```

收到 OK 说明当前模型和实际请求均已生效。

配置没有更新

状态中没有 zhiflo：先检查 JSON 层级是否为 models.providers.zhiflo，再检查括号和逗号。
Gateway 仍显示旧配置：保存文件后重启正在运行的 Gateway，再次运行 openclaw models status。不要通过关闭认证或开启不安全访问绕过问题。
模型能显示但请求失败：核对 api 为 openai-completions、baseUrl 带 /v1，并确认当前终端能读取 ZHIFLO_API_TOKEN。
模型不可用：重新复制账户模型 ID，同时更新 id、name 和 models set 命令中的值。

下一步：查看按现象排查连接问题。