使用智能体

OpenClaw

前提条件

项目值
OpenClaw 版本2026.6.11
配置文件~/.openclaw/openclaw.json
Provider idjoytoken
模型名joytoken/auto
API Key 环境变量JOY_TOKEN_API_KEY

OpenClaw 同时支持两种协议。Base URL、注册时的 compatibility mode 和 JoyToken 侧检查必须选择同一个协议。

第 1 步：安装

npm install -g openclaw@2026.6.11
openclaw --version

第 2 步：设置 API Key 和 Base URL

export JOY_TOKEN_API_KEY="sk-xxx"
export JOY_TOKEN_OPENAI_BASE_URL="https://api.joytokens.ai/openai/v1"

长期使用时，把所选协议对应的变量加入 shell 配置。

第 3 步：注册 provider

openclaw onboard \
  --non-interactive \
  --accept-risk \
  --auth-choice custom-api-key \
  --custom-provider-id joytoken \
  --custom-base-url "$JOY_TOKEN_OPENAI_BASE_URL" \
  --custom-compatibility openai \
  --custom-model-id auto \
  --custom-api-key "$JOY_TOKEN_API_KEY" \
  --skip-channels \
  --skip-daemon \
  --skip-skills \
  --skip-search \
  --skip-ui \
  --skip-health

第 4 步：确认配置

cat ~/.openclaw/openclaw.json

配置中应包含 joytoken/auto，并且 API 值与所选 tab 一致：

{
  "models": {
    "providers": {
      "joytoken": {
        "baseUrl": "https://api.joytokens.ai/openai/v1",
        "api": "openai-completions"
      }
    }
  }
}

第 5 步：验证

openclaw models status

输出里应看到 joytoken/auto。发起一次调用：

openclaw infer model run \
  --local \
  --model joytoken/auto \
  --prompt "Reply with exactly: pong" \
  --json

成功时，返回内容包含 pong。

JoyToken 侧检查

位置应看到
Logs请求路径是 /openai/v1/chat/completions
认证Bearer 认证
Usage本次调用产生 tokens 和 credits

常见错误

错误处理方式
找不到 custom-api-key 参数安装 openclaw@2026.6.11
默认模型不是 joytoken/auto重新执行 openclaw onboard
401 Unauthorized重新设置 JOY_TOKEN_API_KEY
JoyToken 没有日志检查 ~/.openclaw/openclaw.json 中所选协议的 baseUrl、api 和默认模型

相关资源