快速开始

这里不假设具体模型名，也不把任何路径写死。原因很简单：这类信息会变，最稳的接入方式是把变化留在控制台和环境变量里。

第一步：记录 3 个最小配置

先在 api.clawsocket.com 控制台核对并记录：

1. 实际的 base URL
2. 你的 API key
3. 当前准备接入的模型标识

建议在本地或部署平台里只暴露这几个环境变量：

CLAWSOCKET_BASE_URL=
CLAWSOCKET_API_KEY=
CLAWSOCKET_MODEL=

第二步：在业务里只读取环境变量

Node.js 示例：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CLAWSOCKET_API_KEY,
  baseURL: process.env.CLAWSOCKET_BASE_URL
});

const response = await client.chat.completions.create({
  model: process.env.CLAWSOCKET_MODEL!,
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "给我一个三步上线检查清单。" }
  ]
});

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

关键点只有两个：

• 不在代码里写死供应商专有路径。
• 不把模型名散落在多个服务文件里。

第三步：先验证再扩展

先只验证一条最短链路：

1. 能正常鉴权
2. 能收到成功响应
3. 错误时能拿到可读日志

确认这三点后，再加流式输出、重试、超时、主备切换和缓存。不要在第一版就把所有工程特性堆上去。

第四步：给上线留回滚面

至少保留两份模型配置：

• MODEL_PRIMARY
• MODEL_FALLBACK

如果上游表现不稳，你可以只改环境变量或网关配置，不需要重新发版。

CLAWSOCKET_MODEL_PRIMARY=
CLAWSOCKET_MODEL_FALLBACK=

发布前检查

• 控制台信息已二次核对
• 密钥只存在于服务端
• 模型名没有在仓库里多处硬编码
• 超时和错误日志可见
• 有明确的回滚模型或回滚配置

开始接入

先在控制台确认当前支持的模型、配额和 base URL。

这类信息变化快，不要把文章里的示例当成唯一事实源。 先去 api.clawsocket.com 核对当前配置，再把示例落到你的服务端。

打开 api.clawsocket.com