获取模型调用API KEY、模型ID等信息

以下文章内容中所提到的API KEY，通通即为TokenHub平台中的APP KEY。

关于APP KEY和模型ID具体获取方式可详见快速入门。

OpenClaw

方式一：通过Web UI修改配置文件（适用于Windows或者Mac系统）

1.在终端执行以下命令打开 Web UI。

openclaw dashboard

2.在Web UI的左侧菜单栏中选择“配置”->“All Settings”->“RAW”。

3.复制以下内容到Raw JSONS输入框，替换已有内容，并将YOUR_API_KEY替换为在服务接入页面所获取到的APP KEY。

{
    "models": {
        "mode": "merge",
        "providers": {
            "xirang": {
                "baseUrl": "https://ai.ctaigw.cn/v1",
                "apiKey": "YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
{
                        "id": "GLM-5",
                        "name": "GLM-5",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 204800,
                        "maxTokens": 131072
},
{
                        "id": "Qwen3.5-397B-A17B",
                        "name": "Qwen3.5-397B-A17B",
                        "reasoning": true,
                        "input": [
                            "text",
                            "image"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 65536,
                        "maxTokens": 16384
},
{
                        "id": "Qwen3-Max",
                        "name": "Qwen3-Max",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 258048,
                        "maxTokens": 65536
},
{
                        "id": "Doubao-Seed-2.0-pro",
                        "name": "Doubao-Seed-2.0-pro",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 131072,
                        "maxTokens": 65536
},
{
                        "id": "DeepSeek-V3.2-Standard",
                        "name": "DeepSeek-V3.2-Standard",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 131072,
                        "maxTokens": 16384
},
{
                        "id": "DeepSeek-V3-0324",
                        "name": "DeepSeek-V3-0324",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 131072,
                        "maxTokens": 16384
},
{
                        "id": "kimi-k2.5",
                        "name": "kimi-k2.5",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 32768,
                        "maxTokens": 16384
},
{
                        "id": "DeepSeek-R1-0528",
                        "name": "DeepSeek-R1-0528",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 98304,
                        "maxTokens": 16384
}
                ]
}
}
},
    "agents": {
        "defaults": {
            "model": {
                "primary": "xirang/GLM-5"
},
            "models": {
                "xirang/GLM-5": {},
                "xirang/Qwen3.5-397B-A17B": {},
                "xirang/Qwen3-Max": {},
                "xirang/Doubao-Seed-2.0-pro": {},
                "xirang/DeepSeek-V3.2-Standard": {},
                "xirang/DeepSeek-V3-0324": {},
                "xirang/kimi-k2.5": {},
                "xirang/DeepSeek-R1-0528": {}
}
}
},
    "gateway": {
        "mode": "local"
}
}

4.点击右上角 Save 保存，再点击 Update 使配置生效，保存成功后，apiKey将显示为“__OPENCLAW_REDACTED__”。由于脱敏保护，仅在前端界面隐藏，不影响实际调用。

方式二：通过终端修改配置文件（适用于Windows 、mac 系统、Linux系统）

1.在终端执行以下命令打开配置文件

Mac系统和Linux系统执行以下命令：

nano ~/.openclaw/openclaw.json

Windows系统执行以下命令（Windows系统推荐优先使用方式一）：

notepad %USERPROFILE%\.openclaw\openclaw.json

2.复制以下内容到配置文件。将YOUR_API_KEY替换为在服务接入页面所获取到的App Key。

{
    "models": {
        "mode": "merge",
        "providers": {
            "xirang": {
                "baseUrl": "https://ai.ctaigw.cn/v1",
                "apiKey": "YOUR_API_KEY",
                "api": "openai-completions",
                "models": [
{
                        "id": "GLM-5",
                        "name": "GLM-5",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 204800,
                        "maxTokens": 131072
},
{
                        "id": "Qwen3.5-397B-A17B",
                        "name": "Qwen3.5-397B-A17B",
                        "reasoning": true,
                        "input": [
                            "text",
                            "image"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 65536,
                        "maxTokens": 16384
},
{
                        "id": "Qwen3-Max",
                        "name": "Qwen3-Max",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 258048,
                        "maxTokens": 65536
},
{
                        "id": "Doubao-Seed-2.0-pro",
                        "name": "Doubao-Seed-2.0-pro",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 131072,
                        "maxTokens": 65536
},
{
                        "id": "DeepSeek-V3.2-Standard",
                        "name": "DeepSeek-V3.2-Standard",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 131072,
                        "maxTokens": 16384
},
{
                        "id": "DeepSeek-V3-0324",
                        "name": "DeepSeek-V3-0324",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 131072,
                        "maxTokens": 16384
},
{
                        "id": "kimi-k2.5",
                        "name": "kimi-k2.5",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 32768,
                        "maxTokens": 16384
},
{
                        "id": "DeepSeek-R1-0528",
                        "name": "DeepSeek-R1-0528",
                        "reasoning": true,
                        "input": [
                            "text"
                        ],
                        "cost":{
                            "input": 0,
                            "output": 0,
                            "cacheRead": 0,
                            "cacheWrite": 0
},
                        "contextWindow": 98304,
                        "maxTokens": 16384
}
                ]
}
}
},
    "agents": {
        "defaults": {
            "model": {
                "primary": "xirang/GLM-5"
},
            "models": {
                "xirang/GLM-5": {},
                "xirang/Qwen3.5-397B-A17B": {},
                "xirang/Qwen3-Max": {},
                "xirang/Doubao-Seed-2.0-pro": {},
                "xirang/DeepSeek-V3.2-Standard": {},
                "xirang/DeepSeek-V3-0324": {},
                "xirang/kimi-k2.5": {},
                "xirang/DeepSeek-R1-0528": {}
}
}
},
    "gateway": {
        "mode": "local"
}
}

3.保存文件并退出，运行以下命令来使配置生效。

openclaw gateway restart

使用openClaw

Windows或者Mac环境

1.新开一个终端，运行以下命令。

openclaw dashboard

2.在Web UI点击左侧顶部“聊天”进入聊天窗口后，输入Message进行对话。

Linux环境

1.新开一个终端，运行以下命令，进入TUI界面。

openclaw tui

2.在TUI界面进行对话。

常见问题

聊天对话上方出现“API rate limit reached. Please try again later”

原因：由于模型免费额度已用完或已到期，或者已经开通模型付费但因账户余额不足，模型已无法使用。

解决方案：

请在控制台开通模型付费。如遇部分模型无法自助开通，请联系客户经理或提交工单购买。

提示“USER_TPM_RATELIMITING 用户请求TPM超限，请减少tokens后重试”

原因：每分钟消耗的Token总数已超过系统阈值，单次请求的文本过长（如长文档分析、长代码生成），或多个并发请求的总Token量过大，导致触发限流。

解决方案：

缩短聊天消息长度：请尝试将问题或输入内容拆分成几个较短的部分，分批发送。
稍后再试：系统限流通常会在1分钟内自动恢复，您可以稍等一会儿再继续提问。
减少同时对话：避免并发过高，如果您同时打开了多个聊天窗口，请先集中在一个窗口对话，关闭其他窗口，避免多个对话同时争抢额度。
调整限额：如果您需要更高的流量额度，请联系客户经理或提交工单提升额度。

提示“USER_RPM_RATELIMITING 用户请求RPM超限，请稍后重试”

原因：您当前发起的请求速度过快，每分钟的请求数（RPM, Requests Per Minute）已超过系统阈值。

解决方案：

稍后再试：限流通常会在1分钟内自动解除，您可以稍后再试。
降低发送频率：发送完一条消息后，等出现回复再发送下一条，避免连续快速发送。
减少同时对话：避免并发过高，如果您同时打开了多个聊天窗口，请先集中在一个窗口对话，关闭其他窗口，避免多个对话同时争抢额度。
调整限额：如果您需要更高的流量额度，请联系客户经理或提交工单提升额度。

提示“400 模型id错误，无法与AppKey对应，请联系管理员”

问题：当前使用的模型没有与您在服务接入所创建AppKey对应，导致无法使用。

解决方案：

修改服务组重新添加模型服务：在服务接入页面找到创建的服务组，编辑服务组，勾选您需要在OpenClaw中使用的模型，提交后在OpenClaw进行重试。

ClaudeCode

全局配置文件修改

macOS 全局：~/.claude/settings.json
Windows 全局： %USERPROFILE%\.claude\settings.json
项目根目录： .claude/settings.json（优先级 > 全局）

安装 Claude Code后，通过手动配置的方式修改相应JSON文件，在 Claude Code 中接入编码套餐，需要配置以下信息：

ANTHROPIC_BASE_URL：设置为 https://ai.ctaigw.cn/coding。
ANTHROPIC_AUTH_TOKEN：设置为你购买的编程套餐专属的API Key
model：设置为你购买的编程套餐所支持的模型

# 编辑或新增 `settings.json` 文件
# MacOS & Linux 为 `~/.claude/settings.json`
# Windows 为`用户目录/.claude/settings.json`
# 新增或修改里面的 env 字段
# 注意替换里面的 `YOUR_API_KEY` 为您上一步获取到的 API Key
{
"$schema":"https://json.schemastore.org/claude-code-settings.json",
"env":{
"ANTHROPIC_AUTH_TOKEN":"YOUR_API_KEY",
"ANTHROPIC_BASE_URL":"https://ai.ctaigw.cn/coding"},
"model":"GLM-5.1"
}

# 再编辑或新增 `.claude.json` 文件
# MacOS & Linux 为 `~/.claude.json`
# Windows 为`用户目录/.claude.json`
# 新增 `hasCompletedOnboarding` 参数
{
"hasCompletedOnboarding":true
}

使用Claude Code

配置完成后，进入一个您的代码工作目录，在终端中执行 claude 命令即可开始使用 Claude Code

若遇到「Do you want to use this API key」选择 Yes 即可，启动后选择信任 Claude Code 访问文件夹里的文件

OpenCode

全局配置文件修改

请在以下路径创建并打开配置文件 opencode.json ：

macOS / Linux: ~/.config/opencode/opencode.json

Windows: C:\Users\您的用户名\.config\opencode\opencode.json

将以下配置写入文件，关键配置项：

YOUR_API_KEY为你购买的编程套餐专属的API Key
models的配置则为来源于您当前购买实际套餐的可用模型，以下示例配置以GLM MAX(旗舰版)为例，不同编码套餐支持调用的模型不一样

{
"$schema":"https://opencode.ai/config.json",
"provider":{
"xirang":{
"npm":"@ai-sdk/openai-compatible",
"name":"xirang",
"options":{
"baseURL":"https://ai.ctaigw.cn/coding/v1",
"apiKey":"YOUR_API_KEY"
},
"models":{
"GLM-4.7":{
"name":"GLM-4.7"
},
"GLM-5":{
"name":"GLM-5"
},
"GLM-5-Turbo":{
"name":"GLM-5-Turbo"
},
"GLM-5.1":{
"name":"GLM-5.1"
},
"GLM-4.5":{
"name":"GLM-4.5"
},
"GLM-4.5-Air":{
"name":"GLM-4.5-Air"
},
"GLM-4.6":{
"name":"GLM-4.6"
}
}
}
},
"model":"xirang/GLM-4.7",
"small_model":"xirang/GLM-4.7"
}

运行 opencode 启动 OpenCode

在命令行中输入以下命令：

$ opencode

使用 /models 命令来选择模型，例如 GLM-5。

/models

Trae

添加自定义模型

在下载好Trae后依次点击：设置->模型->添加模型->自定义模型

在自定义模型页面填入相关参数

注意点

模型ID即为模型的名称，可在自己的API页面查询，确保准确
自定义请求地址必须填写完全，因为Trae 只会原封不动地拿去请求，它自己不会在末尾自作聪明地补充
这里使用的服务接入的API，若使用编程套餐的API，请在自定义请求地址的v1前加上coding，类似于.../coding/v1/chat/completions

切换自定义模型

Trae默认的是Auto Mode模型，点击其将其关掉，随后即可下滑选择自定义模型

随后就可以开始测试使用了

Codex（Openai）

在 Codex 中配置 Coding Plan

修改配置文件

完整复制以下内容并粘贴到 Codex 配置文件~/.codex/config.toml中。

model_provider ="Ctyun_Coding_Plan"
model ="GLM-4.7"
[model_providers.Ctyun_Coding_Plan]
name ="Ctyun_Coding_Plan"
base_url ="https://ai.ctaigw.cn/coding/v1"
env_key ="OPENAI_API_KEY"
wire_api ="responses"

配置环境变量

将配置文件中的OPENAI_API_KEY环境变量设置为 Coding Plan 专属 API Key。

macOS

在终端中执行以下命令，查看默认 Shell 类型。

echo $SHELL

根据 Shell 类型设置环境变量，命令如下：

Zsh

# 用您的Coding Plan API Key 替换 YOUR_API_KEY
echo'export OPENAI_API_KEY="YOUR_API_KEY"'>> ~/.zshrc

Bash

# 用您的Coding Plan API Key 替换 YOUR_API_KEY
echo'export OPENAI_API_KEY="YOUR_API_KEY"'>> ~/.bash_profile

在终端中执行下列命令，使环境变量生效。

Zsh

source ~/.zshrc

Bash

source ~/.bash_profile

Windows

CMD

在CMD中运行以下命令，设置环境变量。

# 用您的Coding Plan API Key 替换 YOUR_API_KEY
setx OPENAI_API_KEY "YOUR_API_KEY"

打开一个新的 CMD 窗口，运行以下命令，检查环境变量是否生效。

echo %OPENAI_API_KEY%

PowerShell

在PowerShell中运行以下命令，设置环境变量。

# 用套餐专属 API Key 替换 YOUR_API_KEY
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

打开一个新的 PowerShell 窗口，运行以下命令，检查环境变量是否生效。

echo$env:OPENAI_API_KEY

使用 Codex

新建一个终端，执行以下命令进入 Codex。

codex

选择跳过更新。

开始对话。

Cursor

创建新Provider/Model

在 Cursor 中，打开 “Models” 部分，并点击 “Add Custom Model” 按钮。

选择 OpenAI 协议。

配置 OpenAI API Key。

在 Override OpenAI Base URL 中，将默认 URL 替换：https://ai.ctaigw.cn/coding/v1。

输入您希望使用的模型，如 GLM-5, GLM-4.7, GLM-4.6等。

开始使用

按照上面步骤，Cursor 已经配置完成，可在对话框中进行编程测试。

常见问题

Q：在 Cursor 中无法调用 Coding Plan 支持的模型？

A：如果在界面看到了如下报错：

The model xxx does not work with your current plan or api key.

Named models unavailable Free plans can only use Auto. Switch to Auto or upgrade plans to continue.

由于 Cursor 的产品限制，Cursor 免费版仅支持 Auto 模式，且不支持调用自定义模型。请升级至 Cursor Pro 及以上套餐，即可正常使用 Coding Plan 支持的模型。

Cline

打开插件市场

打开 VS Code
点击左侧插件市场图标
在搜索框中输入 Cline
找到 Cline 扩展

安装插件

点击 Install 按钮进行安装
安装完成后，选择信任开发者

配置 API 设置

选择 API Key 方式

选择 Bring my own API key

填入配置信息

请按照以下配置填入相关信息：

API Provider：选择 OpenAI Compatible
Base URL：输入 https://ai.ctaigw.cn/coding/v1
API Key：填入您的 API Key
Model ID：输入您希望使用的模型，如 GLM-5, GLM-4.7, GLM-4.6等
其他配置：取消勾选 Support Images
调整 Context Window Size 为 200000
根据您的任务需求调整 temperature 等其它参数

开始使用

配置完成后，您可以在输入框中输入需求，让模型帮助您完成各种任务。

Chatbox

访问链接：https://web.chatboxai.app/

点击Setting，添加OpenAI API Compatible添加天翼云。配置Api Host、API path、API key和Model，配置完成后点击check校验配置是否生效。

配置成功后，回到主页，选择new chat，即可使用刚配置的模型。

Codebuddy

CodeBuddy 是一款基于 AI 的全流程智能编程工具，致力于构建产品、设计、研发、部署无缝协作的共生环境。

安装 CodeBuddy

访问官网https://www.codebuddy.cn/home/下载并安装适合您的操作系统的版本。

登录CodeBuddy并打开项目

配置天翼云自定义模型

腾讯云 CodeBuddy（及相关的 WorkBuddy / CLI 客户端）中，配置自定义模型主要通过创建或编辑 models.json 配置文件来实现。无论是接入本地运行的模型（如 Ollama），还是第三方的兼容 API（如 DeepSeek、通义千问等），都可以通过该配置完成。

Windows 路径：C:\Users\<你的用户名>\.codebuddy\models.json

macOS / Linux 路径：~/.codebuddy/models.json

提示：如果该路径没有models文件请创建

配置示例：

{
"models":[
{
"id":"GLM-5.1",
"name":"CTyun",
"vendor":"OpenAI",
"url":"https://ai.ctaigw.cn/v1/chat/completions",
"apiKey":"*****",
"supportsToolCall":false,
"supportsImages":false,
"supportsReasoning":true
}
]
}

注意事项：

（1）请将id和apiKey替换成你自己购买的模型和apiKey，可在购买页查看

（2）这里使用的服务接入的API，若使用编程套餐的API，请在url自定义请求地址的v1前加上coding，类似于.../coding/v1/chat/completions

（3）name是自定义显示在codebuddy的名字前缀，可自定义。

配置字段说明：

字段	类型	必填	说明
id	string	✓	模型唯一标识符
name	string	-	模型显示名称
vendor	string	-	模型供应商（如 OpenAI, Google）
apiKey	string	-	API 密钥（实际密钥值，非环境变量名）
maxInputTokens	number	-	最大输入 token 数
maxOutputTokens	number	-	最大输出 token 数
url	string	-	API 端点 URL（必须是接口完整路径）
supportsToolCall	boolean	-	是否支持工具调用
supportsImages	boolean	-	是否支持图片输入
supportsReasoning	boolean	-	是否支持推理模式

使用天翼云自定义模型

在保存models.json重启CodeBuddy后即可在右侧栏底部查看自定义模型并开始使用

Hermes Agent

windows流程

用管理员身份运行PowerShell,运行指令：

irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

setup那里选择Quick setup

Select provider那里选择37 custom

然后就是输入url（https://ai.ctaigw.cn/v1/）->输入API key->选择auto-detect自动探索出你的模型->给你的模型进行命名->然后就是一路按Enter 直到安装成功。

安装成功后在输入hermes开始聊天

mac流程

在终端中执行以下命令安装 Hermes Agent：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，重新加载终端环境：

source ~/.bashrc    # 如果使用 zsh，改为 source ~/.zshrc

运行以下命令验证安装。若有版本号输出，则表示安装成功：

hermes --version

运行hermes setup命令就会跳到和上面windows一样的安装引导：

hermes setup

或者你也可以直接配置不走安装引导：

hermes config set model.provider custom
hermes config set model.base_url https://ai.ctaigw.cn/v1
hermes config set model.api_key 你的APIKey
hermes config set model.default 你的模型ID

后面也是运行hermes开始聊天。

Codex桌面版

前置准备

首先安装codex桌面版，安装链接如下：

https://developers.openai.com/codex/app

然后安装CC-Switch v3.16.1+（低于此版本不支持格式转换，会报错），链接如下：

https://github.com/farion1231/cc-switch/releases/latest

购买编程Token Plan后获取专属APP Key和专属请求地址，获取链接如下：

https://ctxirang.ctyun.cn/maas/codingPlan

在CC-Switch中添加供应商

说明：Codex 桌面版只支持 OpenAI Responses API 格式，而天翼云只支持 Chat Completions 格式，CC-Switch v3.16+ 的代理负责两种格式之间的互转。

首先开启在CC-Switch中添加Codex的路由

查看是否成功

选择 Codex → 添加供应商：

填写相应内容，注意一定开启需要本地路由映射：

默认模型名称是custom，如果想改成自己模型的真正名称，下滑在config.toml更改（这个文件对应本地的~/.codex/config.toml）

然后点击保存即可

Codex对话验证

打开codex，就可看到自定义模型：

随后可以开始对话了。

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

获取模型调用API KEY、模型ID等信息

OpenClaw

ClaudeCode

OpenCode

Trae

Codex（Openai）

Cursor

Cline

Chatbox

Codebuddy

Hermes Agent

Codex桌面版

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

获取模型调用API KEY、模型ID等信息

OpenClaw

ClaudeCode

OpenCode

Trae

Codex（Openai）

Cursor

Cline

Chatbox

Codebuddy

Hermes Agent

Codex桌面版