跳到正文

OpenClaw 接入 ​

先按 OpenClaw 官方入门 完成安装和初始化。下文使用默认配置目录。

下文在运行 OpenClaw Gateway 的环境中操作;Windows 使用 WSL 时,在对应的 WSL 内修改文件并运行命令。

准备好 API 密钥 和余额,在 模型页 选择对话模型,记下模型 ID、上下文和单次输出上限。

1.保存密钥 ​

在 ~/.openclaw/.env 添加以下一行,替换成自己的密钥,保留已有内容:

dotenv
ZEROSEAL_API_KEY=你的密钥

2.配置模型 ​

将以下字段合并到 ~/.openclaw/openclaw.json,保留已有提供商和其他配置:

json
{
  "models": {
    "providers": {
      "zeroseal": {
        "baseUrl": "https://gw.zeroseal.cn/v1",
        "apiKey": "${ZEROSEAL_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "ZeroSeal",
            "contextWindow": 131072,
            "maxTokens": 1024
          }
        ]
      }
    }
  }
}

将 YOUR_MODEL_ID 换成模型 ID,contextWindow 的 131072 换成该模型的上下文上限。

maxTokens: 1024 用于测试短回复,要求模型支持至少 1024 token 的输出。实际任务可调高,但不能超过模型上限。预算包含思考与回答,过低可能导致回复不完整;余额需覆盖预扣金额。

校验配置并设为默认模型,命令中的模型 ID 要与配置一致:

bash
openclaw config validate
openclaw models set zeroseal/YOUR_MODEL_ID

接口类型保持 openai-completions,对应 Chat Completions。ZeroSeal 暂不提供 Responses 或 Anthropic Messages 接口。

3.验证回复 ​

使用本机 OpenClaw Gateway 服务时,重启后打开控制界面:

bash
openclaw gateway restart
openclaw dashboard

若平时通过 openclaw gateway run 前台运行,重启该进程,再运行 openclaw dashboard。

新建会话,确认当前模型为 zeroseal/YOUR_MODEL_ID,发送:

只回复:连接成功。不要调用工具或读取文件。

收到回复后,到 消费记录 确认本次调用。多轮任务可能发起多次模型请求,费用从 zeroseal 余额扣除。遇到问题见 错误排查。

本接入属于 普通调用,不执行客户端 TEE 验证。

配置依据:自定义 Provider、环境变量。