3 分钟快速接入

这个页面的目标只有一个：让你从“了解”直接进入“可调用”。

第 1 步：在控制台生成令牌

前往 api.clawsocket.com 登录后台，然后按这个流程操作：

1. 进入 令牌管理
2. 点击 添加令牌
3. 分组选择 default
4. 生成并复制你的 Key

如果你的 clawsocket 后端就是基于 New API 搭的，那么这一步和常见的 New API 面板操作是一致的。对用户来说，拿到 Key 以后，后面就是标准的 OpenAI 兼容接入流程。

第 2 步：替换 baseURL 和 apiKey

如果你已经在用 OpenAI SDK，通常只需要把原来的 URL 和 Key 换成你在 api.clawsocket.com 里生成的那一套。

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.CLAWSOCKET_API_KEY,
  baseURL: 'https://api.clawsocket.com/v1'
})

如果你还没写环境变量，也可以先临时测试：

export CLAWSOCKET_API_KEY="你刚刚生成的令牌"

第 3 步：发起第一个请求

const completion = await client.chat.completions.create({
  model: 'claude-sonnet',
  messages: [
    { role: 'system', content: 'You are a concise engineering assistant.' },
    { role: 'user', content: 'Give me a deployment checklist.' }
  ]
})

console.log(completion.choices[0]?.message?.content)

核心思路其实就两件事：

• URL 改成 https://api.clawsocket.com/v1
• Key 改成你在 令牌管理 里生成的令牌

剩下的请求结构、SDK 用法、消息格式，基本都可以保持原来的写法。

接下来你可以继续看什么

如果你已经把第一个请求跑通，下面这些页面可以继续帮你把接入链路补完整：

• 想了解为什么现有 OpenAI SDK 基本不用大改，可以继续看 OpenAI API Proxy。这一页讲的是“为什么只改 URL 和 Key 就能接起来”。
• 想确认统一兼容层适不适合你的项目，可以看 OpenAI Compatible API。如果你后面还要切 Claude、Gemini 或更多模型，这一页会更有帮助。
• 如果你在用 Codex，可以直接看 Codex 如何配置统一 API 网关：用 api.clawsocket.com 接入的完整教程。里面已经把 config.toml、base_url 和环境变量写法整理好了。
• 如果你主要在用 Claude Code，可以继续看 Claude Code 如何配置统一 API 网关：用 api.clawsocket.com 接入的完整教程。照着配 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 就能接。
• 如果你在折腾本地 Agent 或机器人，可以看 OpenClaw 完整配置教程：安装、Onboard 与第三方兼容接入实战。这篇会从 openclaw onboard 一直讲到 openclaw.json 的 relay 配置。
• 如果你想接 Google 的模型体系，可以看 Gemini CLI 安装与配置完整教程：从安装到认证的实用指南 和 谷歌云 Gemini 模型 API Key 全攻略：从获取到调用的完整指南。

第 4 步：按你的情况继续看

用户类型	下一步
已经准备好试用	返回控制台创建更多 Key 或查看套餐
还想确认兼容性	阅读 OpenAI API Proxy
还想理解架构	阅读 OpenAI Compatible API