OpenClaw

为 OpenClaw 的个人助手配置 Token Factory 模型服务。本页通过自定义提供方使用 OpenAI Chat Completions，先完成模型连接，再接入需要的聊天渠道。

开始前准备

按OpenClaw 官方入门指南安装并完成基础设置。首次向导选择 Custom setup，配置自己的提供方。
在控制台创建工具专用 API Key，确认通用余额充足。
在模型文档复制已开放 OpenAI Chat Completions 的模型 ID；智能体执行任务需要模型支持工具调用与流式输出。

配置提供方

OpenAI 兼容 Base URL

Base URL 填写 https://api.tokenfactory.cn/v1，api 选择 openai-completions。该选项对应 Chat Completions，最终请求为 https://api.tokenfactory.cn/v1/chat/completions。

1. 保存 API Key

在本机的 ~/.openclaw/.env 中设置以下变量，将占位值替换成 API Key。仅在本机编辑该文件，限制文件访问权限，不要提交到项目仓库。

dotenv

TOKENFACTORY_API_KEY=<your-api-key>

后台 Gateway 需要能读取自己的凭据环境。在另一个终端临时设置变量，不一定会传递到已经运行的服务；全局 .env 的加载规则见官方环境变量文档。

2. 添加模型与默认选择

编辑 ~/.openclaw/openclaw.json，合并以下配置，并将两处 <model-id> 替换为实际模型 ID：

json

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "tokenfactory/<model-id>"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "tokenfactory": {
        "baseUrl": "https://api.tokenfactory.cn/v1",
        "apiKey": "${TOKENFACTORY_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "<model-id>",
            "name": "Token Factory"
          }
        ]
      }
    }
  }
}

primary 使用 提供方 ID/模型 ID；提供方下的 id 使用平台原始模型 ID。mode: "merge" 合并自定义提供方；已有配置时保留其他字段，避免覆盖原有渠道、代理与访问控制。

选择模型并验证

保存后，重启正在运行的 Gateway；已安装后台服务时可以执行 openclaw gateway restart。随后检查模型配置：

bash

openclaw models list
openclaw models set "tokenfactory/<model-id>"
openclaw models status

确认目标模型已被选为默认模型后，运行 openclaw dashboard，新建会话并发送：“只回复‘连接成功’，不读取文件、不执行命令。”收到正常回复后，再在测试环境中验证工具调用。

已有会话可能保留此前的模型选择，需要在会话模型菜单中重新选择。通用余额按实际模型用量计费，聊天渠道的登录与连接按 OpenClaw 各渠道教程单独设置。

常见问题

现象	检查方法
模型列表里没有 Token Factory	检查 `models.providers.tokenfactory.models` 是否存在及配置是否已加载；只设置 `primary` 不会注册模型。
`401` 或提示缺少变量	检查 Gateway 运行账号能否读取 `~/.openclaw/.env`，更新凭据后重启服务。
模型不允许选择	检查已有模型选择策略是否允许 `tokenfactory/<model-id>`，以及当前代理是否覆盖了默认设置。
`404`	Base URL 必须保留 `/v1`，不能只填域名或完整 `/chat/completions` 地址。
回复来自原来的模型	检查会话模型、代理独立配置与已有回退规则，不能只看全局默认值。
能对话但工具执行失败	检查模型工具调用能力、工具权限和具体错误；基础连接成功不等于所有渠道和插件均已配置。
限流、余额不足或超时	参考错误处理，先检查任务已有结果再重试。

OpenClaw ​

开始前准备 ​

配置提供方 ​

1. 保存 API Key ​

2. 添加模型与默认选择 ​

选择模型并验证 ​

常见问题 ​

相关文档 ​