本文作者：猫猫摸大鱼 原文地址：[https://iloli.love/archives/1771845921615](https://iloli.love/archives/1771845921615)

## 1\. 前言

本文隶属于 OpenClaw龙虾系列教程文章，建议按顺序阅读 ，可以访问OpenClaw龙虾系列教程文章目录 [https://iloli.love/archives/1766849996690](https://iloli.love/archives/1766849996690) 查看其它文章，本文也可单独作为 newapi 搭建教程文章阅读

本文基于newapi v0.11.0-alpha.5版本，Github地址为 [https://github.com/QuantumNous/new-api](https://github.com/QuantumNous/new-api)

newapi 是一个聚合API项目，能够将其它免费或付费 API 接入，并统一到一个API接口，从而方便供给OpenClaw或其它客户端使用

该项目可以作为个人用途使用，也可以分发多人使用，目前市面上的中转站基本都是基于该项目，本文中仅作为个人用途使用

该项目有更多玩法，本文只赘述其中一部分，其他请自行探索

本系列教程全程使用腾讯云轻量应用服务器，可以参加腾讯云OpenClaw专属活动进行购买，新客68/年起，老客99/年起

活动链接 [https://cloud.tencent.com/act/pro/lighthouse-moltbot](https://cloud.tencent.com/act/pro/lighthouse-moltbot) （无AFF） [http://to.iloli.love/openclaw](http://to.iloli.love/openclaw) （有AFF）

**就算不买也强烈推荐使用有 快照 功能的厂商的服务器进行搭建，并且一定要经常打快照，不要问为什么，血的教训，血的教训，血的教训**

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6d2388f22100289b048d89ac2e13d374.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c7a22d0fc059f1222f83463f81b96d00.png)

## 2\. 搭建

首先选择一个目录，本文中使用的是 `/data/newapi` ，先在该目录下创建 `compose.yaml` 文件

![](https://developer.qcloudimg.com/http-save/yehe-6836203/70da6e07acc195d8b7d08f37e98a1432.png)

然后在以下两个版本里面任选其一复制（3000端口比较常见容易被占用所以这里我改成了3480，可自行修改为其它端口）

精简单容器版本

    services:
      new-api:
        image: calciumion/new-api:latest
        container_name: new-api
        restart: always
        command: --log-dir /app/logs
        ports:
          - "3480:3000"
        volumes:
          - ./data:/data
          - ./logs:/app/logs
        environment:
          - TZ=Asia/Shanghai
        healthcheck:
          test: ["CMD-SHELL", "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' || exit 1"]
          interval: 30s
          timeout: 10s
          retries: 3

Redis+PG数据库版本

    services:
      new-api:
        image: calciumion/new-api:latest
        container_name: new-api
        restart: always
        command: --log-dir /app/logs
        ports:
          - "3480:3000"
        volumes:
          - ./data:/data
          - ./logs:/app/logs
        environment:
          - SQL_DSN=postgresql://root:123456@postgres:5432/new-api
          - REDIS_CONN_STRING=redis://redis
          - TZ=Asia/Shanghai
        depends_on:
          - redis
          - postgres
        healthcheck:
          test: ["CMD-SHELL", "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' || exit 1"]
          interval: 30s
          timeout: 10s
          retries: 3
    
      redis:
        image: redis:latest
        container_name: redis
        restart: always
    
      postgres:
        image: postgres:15
        container_name: postgres
        restart: always
        environment:
          POSTGRES_USER: root
          POSTGRES_PASSWORD: 123456
          POSTGRES_DB: new-api
        volumes:
          - ./pg_data:/var/lib/postgresql/data

粘贴到 `compose.yaml` 里（为了方便，本文中使用的是精简单容器版本）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/5b0693469e8f1e5f41b88e689fbb766c.png)

在 `/data/newapi` 下运行 `docker compose up -d` ，创建容器，如图即为成功

![](https://developer.qcloudimg.com/http-save/yehe-6836203/044b92a4cb57b87fdf10e0794048cb0a.png)

## 3\. 配置

访问 服务器IP:3480 （如果你修改了端口则替换为你的端口），进入初始化界面，点击下一步

![](https://developer.qcloudimg.com/http-save/yehe-6836203/7ee24b7e51f5d7ea423627e489443456.png)

设置管理员账号密码，点击下一步

![](https://developer.qcloudimg.com/http-save/yehe-6836203/fc00566629492545e407f9aa97c81207.png)

本文仅展示个人用途，所以选择自用模式，点击下一步

![](https://developer.qcloudimg.com/http-save/yehe-6836203/9ec4ebd4a70149b80b04cbd107ee4350.png)

点击初始化系统

![](https://developer.qcloudimg.com/http-save/yehe-6836203/91d4f8474064ce2eda8c91dbec6a269c.png)

会自动跳转到首页，点击登录

![](https://developer.qcloudimg.com/http-save/yehe-6836203/50567125017e27ae64a090e367e26402.png)

输入刚刚设置的账号密码，点击继续

![](https://developer.qcloudimg.com/http-save/yehe-6836203/7e551c596ad3c5bae49bad83413fcb10.png)

进入后台主页

![](https://developer.qcloudimg.com/http-save/yehe-6836203/6f7d1b98a36703281d98b45e95d20e4d.png)

点击渠道管理，添加渠道

![](https://developer.qcloudimg.com/http-save/yehe-6836203/1f61ad40524706e08506ae2753fa0dd3.png)

这里我们可以接入很多种类型的免费或者付费 API ，本文中我们仅演示接入在 [https://iloli.love/archives/1771758983917](https://iloli.love/archives/1771758983917) 这篇文章里搭建的 API

（所有兼容标准化 OpenAI API 的大模型，都可以按照这个方法接入）

![](https://developer.qcloudimg.com/http-save/yehe-6836203/3587cfafcf6c0e1a9da5f4f9ea523f7b.png)

类型默认 OpenAI ，名称随意，填写在CLIProxyAPI配置的密钥，API 地址填写 CLIProxyAPI的服务器IP:端口，或是你反代CLIProxyAPI的域名（一定要注意，地址的最后不要带 / 或者 /v1 ），模型处可以暂时直接点击 填入相关模型 ，点击提交

![](https://developer.qcloudimg.com/http-save/yehe-6836203/ba9987067878aa82f9c7f1c492beaaac.png)

可以看到我们刚刚添加的渠道，点击编辑

![](https://developer.qcloudimg.com/http-save/yehe-6836203/b598d297affd42273f89bfb45d53c3e0.png)

点击 清除所有模型 ， 获取模型列表

![](https://developer.qcloudimg.com/http-save/yehe-6836203/4d35899a78d8f32ffcbd14b8a645bd52.png)

可以看到我们用CLIProxyAPI反代出的所有模型，选择自己需要的模型，点击确定

![](https://developer.qcloudimg.com/http-save/yehe-6836203/9eb0460d9a7dc2d5aec821ff39e5fceb.png)

点击提交

![](https://developer.qcloudimg.com/http-save/yehe-6836203/bc4d6523e0ac37bde0a411f833af9c3c.png)

可以点击这个小箭头，再点击批量测试，就能看到选择的模型是否能使用了

![](https://developer.qcloudimg.com/http-save/yehe-6836203/c5c99b974b720a32d300a760c14d4aa4.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/a5693c633a768c488e92f93f9771bc4f.png)

![](https://developer.qcloudimg.com/http-save/yehe-6836203/f9071f56cc71e2d5523ff45662340072.png)

接下来点击令牌管理，添加令牌

![](https://developer.qcloudimg.com/http-save/yehe-6836203/f8b179cc36775c0a0de540e4dbab485d.png)

名称随意，点击提交即可

![](https://developer.qcloudimg.com/http-save/yehe-6836203/5bfba9a2848e1c2319284eadfc17642b.png)

可以看到我们刚刚添加的令牌，点击密钥处可以查看或复制 API 密钥

![](https://developer.qcloudimg.com/http-save/yehe-6836203/11b1f760f93236c632b5eb4d00b1b422.png)

## 4\. 使用

到此已经完成，可以使用该密钥了，BaseURL 即为你的服务器IP:项目端口，该项目可以聚合更多大模型 API ，统一直接供给 OpenClaw 使用，这里就不过多赘述了

本文作者：猫猫摸大鱼 原文地址：https://iloli.love/archives/1771845921615

基于docker搭建newapi图文教程

该教程详细介绍了基于 Docker 搭建 newapi 的全过程。newapi 是一款 API 聚合项目，旨在将多种免费或付费 API 整合为统一接口。

腾云先锋（TDP）成员

云计算

开发工具

后端

学习如何使用newapi搭建聚合API接口，统一管理多个API资源。本教程详细讲解基于腾讯云服务器的部署流程，包含Docker容器配置、渠道管理、令牌生成等关键步骤。适用于个人开发者整合OpenAI等大模型API，提升开发效率。

轻量应用服务器

数据库

服务器

容器

4核4G3M云服务器 新用户低至38元/年！

2026新春采购季

tencentdb-catalog

lighthouse

domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

基于docker搭建newapi图文教程-腾讯云开发者社区-腾讯云

基于docker搭建newapi图文教程

基于docker搭建newapi图文教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐