在 OpenClaw 中使用 TOKENOPEN API

通过 OpenClaw AI 工具框架配合 TOKENOPEN API，使用平台上的各类模型

OpenClaw 是一款基于网关架构的 AI Agent 框架，支持对接多种消息平台，提供灵活的模型调用和会话管理能力。通过配置 TOKENOPEN 作为 API 提供商，即可在 OpenClaw 中使用平台上的全部模型。

第一步：安装 OpenClaw

OpenClaw 需要 Node.js 22+，安装前请确认系统环境满足要求。

使用官方安装脚本一键安装：

curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后验证：

openclaw --version

在 PowerShell 中运行官方安装脚本：

iex (irm 'https://openclaw.ai/install.ps1')

安装完成后验证：

openclaw --version

第二步：配置 TOKENOPEN API

获取 API Key

初始化 OpenClaw（可选）

首次使用建议运行初始化向导，按照提示完成基本设置：

openclaw onboard --install-daemon

配置 TOKENOPEN 作为 API 提供商

编辑配置文件 ~/.openclaw/openclaw.json：

vim ~/.openclaw/openclaw.json

在文件中添加以下内容：

{
  "models": {
    "mode": "merge",
    "providers": {
      "my-proxy": {
        "baseUrl": "根据下表替换",
        "apiKey": "替换为你的 API Key",
        "api": "根据下表替换",
        "authHeader": true,
        "models": [
          {
            "id": "替换为模型 ID",
            "name": "替换为模型名称",
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "根据下表替换"
      }
    }
  }
}

参考选项：

参数	可选值示例	说明
`models[].id`	`gpt-5.5` 或 `claude-sonnet-4-6`	填写实际要调用的模型 ID，需与 TOKENOPEN 支持的模型标识一致
`baseUrl`	`https://www.tokenopen.ai/v1` 或 `https://www.tokenopen.ai`	前者适用于 `openai-completions`，后者适用于 `anthropic`，且不带 `/v1`
`api`	`openai-completions` 或 `anthropic`	按所用接口类型填写
`agents.defaults.model.primary`	`gpt-5.5` 或 `claude-sonnet-4-6`	填写你要使用的主模型 ID

按 Esc，输入 :wq! 保存退出。

编辑配置文件 ~/.openclaw/openclaw.json：

vim ~/.openclaw/openclaw.json

在文件中添加以下内容：

{
  "models": {
    "mode": "merge",
    "providers": {
      "my-proxy": {
        "baseUrl": "根据下表替换",
        "apiKey": "替换为你的 API Key",
        "api": "根据下表替换",
        "authHeader": true,
        "models": [
          {
            "id": "替换为模型 ID",
            "name": "替换为模型名称",
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "根据下表替换"
      }
    }
  }
}

参考选项：

参数	可选值示例	说明
`models[].id`	`gpt-5.5` 或 `claude-sonnet-4-6`	填写实际要调用的模型 ID，需与 TOKENOPEN 支持的模型标识一致
`baseUrl`	`https://www.tokenopen.ai/v1` 或 `https://www.tokenopen.ai`	前者适用于 `openai-completions`，后者适用于 `anthropic`，且不带 `/v1`
`api`	`openai-completions` 或 `anthropic`	按所用接口类型填写
`agents.defaults.model.primary`	`gpt-5.5` 或 `claude-sonnet-4-6`	填写你要使用的主模型 ID

按 Esc，输入 :wq! 保存退出。也可以用 TextEdit 打开编辑：

open -e ~/.openclaw/openclaw.json

在 PowerShell 中运行以下命令，自动创建配置文件：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw" | Out-Null

@'
{
  "models": {
    "mode": "merge",
    "providers": {
      "my-proxy": {
        "baseUrl": "根据下表替换",
        "apiKey": "替换为你的 API Key",
        "api": "根据下表替换",
        "authHeader": true,
        "models": [
          {
            "id": "替换为模型 ID",
            "name": "替换为模型名称",
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "根据下表替换"
      }
    }
  }
}
'@ | Set-Content -Path "$env:USERPROFILE\.openclaw\openclaw.json" -Encoding UTF8

参考选项：

参数	可选值示例	说明
`models[].id`	`gpt-5.5` 或 `claude-sonnet-4-6`	填写实际要调用的模型 ID，需与 TOKENOPEN 支持的模型标识一致
`baseUrl`	`https://www.tokenopen.ai/v1` 或 `https://www.tokenopen.ai`	前者适用于 `openai-completions`，后者适用于 `anthropic`，且不带 `/v1`
`api`	`openai-completions` 或 `anthropic`	按所用接口类型填写
`agents.defaults.model.primary`	`gpt-5.5` 或 `claude-sonnet-4-6`	填写你要使用的主模型 ID

也可以用记事本手动编辑：

notepad "$env:USERPROFILE\.openclaw\openclaw.json"

apiKey 填写从 TOKENOPEN 控制台获取的 API 密钥；baseUrl、api 和 agents.defaults.model.primary 可按上表替换。models 数组中也可以按需添加多个模型对象。

第三步：使用 OpenClaw

命令行对话

配置完成后，即可直接通过命令行发起对话：

openclaw chat

常用命令

命令	说明
`openclaw chat`	发起会话
`openclaw chat --session <会话ID>`	发起新会话
`openclaw dashboard`	打开 Web 管理界面
`openclaw models default set [模型]`	设置默认使用的模型
`openclaw --help`	查看完整命令帮助

在 OpenClaw 中使用 TOKENOPEN API

目录