小龙虾OpenClaw配置new-api自定义大模型完整教程

一、前置准备

你需要准备以下内容：

• OpenClaw 环境：已安装并运行

• new-api 实例：已部署并可访问（如 https://api.bangban.xin）

• 模型API密钥：来自模型提供商（如OpenAI、Claude、文心一言等）

• 管理员账号：new-api后台登录权限

二、登录new-api管理后台

访问地址：https://你的域名/console

例如：https://api.bangban.xin/console

登录方式

• 账号密码登录（默认管理员账号）

• 或配置的其他登录方式（GitHub、微信等OAuth）

登录成功后，你将看到管理后台首页，包含账户数据概览、系统公告、快捷入口。

三、添加渠道（Channel）

渠道是new-api连接上游模型提供商的通道。

进入渠道管理

左侧菜单 → 渠道 → 渠道列表

新建渠道

点击右上角 “添加渠道” 按钮，填写以下信息：

基础信息

• 渠道名称：自定义名称，如”OpenAI官方”

• 渠道类型：选择提供商（OpenAI / Anthropic / 百度文心 / 阿里通义 等）

• 优先级：数字越小优先级越高，如 1

• 状态：启用/禁用

API配置

• API密钥：从模型提供商获取的密钥，如 sk-xxxxxxxx

• 代理地址：可选，如需代理填写 https://api.openai.com

• 模型列表：该渠道支持的模型，如 gpt-4, gpt-3.5-turbo

模型映射（可选）

如果你希望对外暴露的模型名与上游不同，可以配置映射：

• 上游模型名 → 对外模型名

• gpt-4 → my-gpt-4

• gpt-3.5-turbo → my-chat

保存并测试

点击 “保存” 后，new-api会自动测试渠道连通性。

• ✅ 绿色：渠道正常

• ❌ 红色：检查API密钥和代理地址

四、添加令牌（Token）

令牌是用户调用API的凭证。

进入令牌管理

左侧菜单 → 令牌 → 令牌列表

新建令牌

点击 “添加令牌”，配置：

• 令牌名称：自定义，如”开发测试”

• 额度：可选，限制该令牌的总调用量

• 速率限制：可选，限制RPM（每分钟请求数）

• 可用模型：选择该令牌能调用的模型

• 过期时间：可选，设置令牌有效期

复制令牌

保存后，点击令牌行的 “复制” 按钮，获取：

sk-xxxxxxxxx

这就是你的API Key，调用时放在请求头中：

curl https://api.bangban.xin/v1/chat/completions \
 -H “Authorization: Bearer sk-your-token” \
 -H “Content-Type: application/json” \
 -d ‘{“model”: “gpt-4”, “messages”: [{“role”: “user”, “content”: “Hello”}]}’

五、配置自定义模型（进阶）

如果你想接入new-api不原生支持的模型，可以使用 自定义渠道。

选择渠道类型为”自定义”

添加渠道时，类型选择 “自定义”。

填写请求格式

new-api支持通过OpenAI兼容格式接入任意模型。

请求地址

https://你的模型API地址/v1/chat/completions

请求头

{
 “Authorization”: “Bearer your-api-key”,
 “Content-Type”: “application/json”
}

请求体（OpenAI格式）

{
 “model”: “your-model-name”,
 “messages”: [
   {“role”: “system”, “content”: “You are a helpful assistant.”},
   {“role”: “user”, “content”: “Hello”}
 ]
}

响应格式要求

你的模型API需要返回OpenAI兼容的响应格式，包含 id、choices、usage 等字段。

六、在OpenClaw中使用

配置环境变量

在OpenClaw的配置中，设置：

export OPENAI_API_KEY=”sk-your-newapi-token”
export OPENAI_API_BASE=”https://api.bangban.xin/v1″

测试调用

import openai

client = openai.OpenAI(
   api_key=”sk-your-newapi-token”,
   base_url=”https://api.bangban.xin/v1″
)

response = client.chat.completions.create(
   model=”gpt-4″,
   messages=[{“role”: “user”, “content”: “你好”}]
)

print(response.choices[0].message.content)

七、常见问题

Q1: 渠道测试失败怎么办？

• 检查API密钥是否正确

• 确认代理地址可访问

• 查看new-api日志获取详细错误

Q2: 如何查看调用日志？

• 左侧菜单 → 日志 → 请求日志

• 可查看每次调用的详情、耗时、状态码

Q3: 额度用完了怎么办？

• 进入令牌管理，编辑令牌增加额度

• 或创建新的令牌

Q4: 如何限制特定用户访问特定模型？

• 在令牌配置中，选择”可用模型”

• 只勾选允许调用的模型

八、总结

配置流程回顾：

1️⃣ 登录new-api后台

2️⃣ 添加渠道（连接上游模型）

3️⃣ 添加令牌（生成API Key）

4️⃣ 在OpenClaw中配置base_url和api_key

5️⃣ 开始调用！

new-api的核心价值在于统一管理：一个入口，接入多个模型，统一计费、统一监控、统一权限。

本文基于new-api v0.12.x版本编写，界面和功能可能随版本更新有所变化，请以实际版本为准。