跳转到内容
NoviaHub 文档

命令行 Agent

OpenClaw

在 OpenClaw 里把 NoviaHub 添加为自定义模型服务商。

OpenClaw 是一个开源的 AI 助手，运行在你自己的电脑上，可以接入常用的聊天软件。它的模型由后台运行的「网关」（Gateway）服务调用，在配置文件里添加自定义服务商后，就能使用 NoviaHub 上的模型。

前提条件

Section titled “前提条件”
  • 已经有一把 NoviaHub API 密钥。还没有的话，参见API 密钥。
  • 账户里有余额。调用按用量从余额扣费。

安装

Section titled “安装”

OpenClaw 支持 macOS、Linux 和 Windows，需要 Node.js 24.16 及以上或 26.1 及以上。官方推荐用安装脚本：它会检测系统，缺少 Node.js 时自动安装，然后安装 OpenClaw 并启动初始设置（onboarding）。任选一种官方安装方式：

终端窗口
curl -fsSL https://openclaw.ai/install.sh | bash

官方还提供 Windows Hub 应用和 macOS .dmg 安装包。

配置 NoviaHub

Section titled “配置 NoviaHub”

  1. 把 API 密钥写进 ~/.openclaw/.env。网关能读到的环境变量来自网关进程本身：它作为后台服务（macOS 的 launchd、Linux 的 systemd 等）运行时，你在终端里 export 的变量不一定能传给它。官方推荐把服务商的 API 密钥放在全局的 ~/.openclaw/.env 文件里。打开（或新建）这个文件，加入一行：

    ~/.openclaw/.env
    NOVIAHUB_API_KEY=sk-...

    这个文件里有密钥。OpenClaw 官方的安全建议是把 ~/.openclaw 下的文件权限设为 600（只有自己能读写），所以接着运行：

    终端窗口
    chmod 600 ~/.openclaw/.env

  2. 编辑配置文件 ~/.openclaw/openclaw.json，加入 NoviaHub 服务商（已有配置的话，把 models.providers.noviahub 和 agents.defaults.model 合并进去）：

    ~/.openclaw/openclaw.json
    {
      "models": {
        "providers": {
          "noviahub": {
            "baseUrl": "https://noviahub.com/v1",
            "apiKey": "${NOVIAHUB_API_KEY}",
            "api": "openai-completions",
            "models": [
              {
                "id": "deepseek-v4-flash",
                "name": "deepseek-v4-flash",
                "contextWindow": 1000000
              }
            ]
          }
        }
      },
      "agents": {
        "defaults": {
          "model": { "primary": "noviahub/deepseek-v4-flash" }
        }
      }
    }

    各字段的含义：

    字段 说明
    noviahub 服务商 ID，选模型时写成 noviahub/模型ID。
    baseUrl 用 openai-completions 或 openai-responses 时带 /v1：https://noviahub.com/v1。
    apiKey ${NOVIAHUB_API_KEY} 表示读取环境变量。只有大写的变量名会被替换：由大写字母、数字和下划线组成，不能以数字开头。
    api 请求协议。openai-completions 对应 Chat 接口，也是不写时的默认值。
    models[].id NoviaHub 上的模型 ID，要逐字一致。
    models[].contextWindow 上下文窗口。不写时 OpenClaw 按 200000 计算。示例数值取自 2026-09-28 的模型&价格页面，以页面上的「上下文」为准。

  3. 重启网关，让它读到新写入的密钥：

    终端窗口
    openclaw gateway restart

    之后再改 openclaw.json 不需要重启，网关会自动监测文件变化。

验证

Section titled “验证”
终端窗口
# 列出 noviahub 服务商下的模型
openclaw models list --provider noviahub


# 不进入聊天界面，直接用这个模型问一句话
openclaw infer model run --model noviahub/deepseek-v4-flash --prompt "用一句话介绍你自己。"

官方说明：在 models.providers.<服务商ID>.models 里写明的模型会出现在 openclaw models list 里，所以第一条命令应该能列出 noviahub/deepseek-v4-flash。第二条命令会读取配置里的模型和密钥，发一次请求并打印回复。能收到回复，并且 NoviaHub 的使用日志里出现这次调用，就说明配置成功。之后可以运行 openclaw tui 进入聊天界面。

切换模型

Section titled “切换模型”
  • 在聊天里输入 /model 切换。
  • 命令行：openclaw models set noviahub/<模型ID>。
  • 修改配置里的 agents.defaults.model.primary，作为默认模型。

新模型要先加进 models 列表。选模型时要看它支持的协议：openai-completions 需要模型标有「Chat」端点，openai-responses 需要「Response」端点，anthropic-messages 需要「Anthropic」端点，这些标签可以在模型&价格的模型详情里查看。

如果想让 Claude 模型走 Anthropic 协议，可以再加一个服务商，api 设为 anthropic-messages，baseUrl 写 https://noviahub.com（不带 /v1）。

注意事项

Section titled “注意事项”
  • OpenClaw 严格校验配置：出现它不认识的字段时，网关会拒绝启动。改完配置启动失败时，先检查拼写。
  • 不设 contextWindow 时按 200000 计算；NoviaHub 上不少模型的上下文比这更大，建议按实际填写。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28 至 2026-09-29：