编码 Agent 集成

OpenClaw

OpenClaw 是什么？

OpenClaw 是面向对话和编码工作流的 AI Agent 平台。当 OpenClaw 支持通用 OpenAI 兼容提供方时，可以把该提供方指向 JoyToken，让模型调用经过 JoyToken 的 API Key、策略、钱包和模型路由层。

OpenClaw 不同版本的配置键可能不同。请使用你当前 OpenClaw 版本的准确字段名；本页描述的是 JoyToken 需要的提供方契约。

设置

第 1 步：创建 JoyToken API Key

创建专用 Key，例如 dev-openclaw。

设置建议
模型从 auto 开始
预算设置每日开发上限
Tier开发或标准档
日志保持开启

第 2 步：设置环境变量

~/.zshrc
$export JOY_TOKEN_API_KEY="jt_xxx"
$export JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"

第 3 步：添加 JoyToken 提供方

如果 OpenClaw 暴露通用 OpenAI 兼容提供方，使用下面的形态：

openclaw.config.json
1{
2  "providers": {
3    "joytoken": {
4      "type": "openai-compatible",
5      "baseURL": "https://api-dev.joytokens.ai/openai/v1",
6      "apiKeyEnv": "JOY_TOKEN_API_KEY"
7    }
8  },
9  "models": {
10    "joytoken-auto": {
11      "provider": "joytoken",
12      "model": "auto"
13    }
14  },
15  "defaultModel": "joytoken-auto"
16}

第 4 步：启动 OpenClaw

修改提供方配置后重启 OpenClaw。新的模型调用应会经过 JoyToken。

手动配置

如果你的 OpenClaw 是 Agent 级配置，把同样的提供方契约放进 Agent 模型配置：

agent-config.json
1{
2  "agent": {
3    "model": {
4      "provider": "openai-compatible",
5      "baseURL": "https://api-dev.joytokens.ai/openai/v1",
6      "apiKeyEnv": "JOY_TOKEN_API_KEY",
7      "model": "auto"
8    }
9  }
10}

如果 OpenClaw 支持请求头，添加 request ID：

provider-headers.json
1{
2  "headers": {
3    "X-Request-ID": "openclaw-local-dev"
4  }
5}

模型格式

值行为
autoJoyToken 路由器自动选模型
具体模型 key固定到某个 JoyToken 模型，但仍经过策略和钱包检查
API Key 固定模型Key 策略会限制或覆盖请求模型

早期评估使用 auto。等可重复的编码 Agent 工作流质量和成本稳定后，再固定模型。

监控用量

位置应看到
OpenClaw 日志提供方是 joytoken 或 openai-compatible
JoyToken 日志请求出现在 OpenClaw API Key 下
JoyToken 用量tokens 和 Credits 归因到 dev-openclaw
响应头成功调用包含实际模型和提供方响应头

为什么用 JoyToken 接入 OpenClaw？

多 Agent 成本控制

为本地测试、团队共享 Agent、无人值守工作流使用不同 JoyToken Key。

策略执行

在 OpenClaw Agent 请求上游提供方前，拦截不允许的模型、tier、IP 或消费。

模型路由

OpenClaw 保持 auto 配置，由 JoyToken 在策略范围内选择模型。

故障排查

现象检查
提供方不识别使用 OpenClaw 的通用 OpenAI 兼容提供方，并显式设置 JoyToken base URL
401 UnauthorizedJOY_TOKEN_API_KEY 是否传给提供方
403 ForbiddenKey 策略是否允许请求模型、tier 和 IP
工具调用失败OpenClaw 是否发送 OpenAI 兼容 tools，并处理返回的 tool_calls
用量缺失OpenClaw 是否回退到了其他提供方

相关资源