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

## 1\. 前言

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

本文基于CLIProxyAPI v6.8.24版本，Github地址为 [https://github.com/router-for-me/CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)

CLIProxyAPI 能够将 GeminiCLI ， ClaudeCode 等转换为不仅限于原客户端使用的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/8f9217b8639e24aad739771b30fa3b13.png)

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

## 2\. 搭建

首先选择一个目录，本文中使用的是`/data/CLIProxyAPI`

运行 `mkdir -p /data/CLIProxyAPI && touch /data/CLIProxyAPI/config.yaml` ，创建项目配置文件

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

复制以下项目配置，将 secret-key 修改为你的密码

```yaml
# Server host/interface to bind to. Default is empty ("") to bind all interfaces (IPv4 + IPv6).
# Use "127.0.0.1" or "localhost" to restrict access to local machine only.
host: ""
# Server port
port: 8317
# TLS settings for HTTPS. When enabled, the server listens with the provided certificate and key.
tls:
  enable: false
  cert: ""
  key: ""
# Management API settings
remote-management:
# Whether to allow remote (non-localhost) management access.
# When false, only localhost can access management endpoints (a key is still required).
  allow-remote: true
# Management key. If a plaintext value is provided here, it will be hashed on startup.
# All management requests (even from localhost) require this key.
# Leave empty to disable the Management API entirely (404 for all /v0/management routes).
  secret-key: "loginpassword"
# Disable the bundled management control panel asset download and HTTP route when true.
  disable-control-panel: false
# GitHub repository for the management control panel. Accepts a repository URL or releases API URL.
  panel-github-repository: "https://github.com/router-for-me/Cli-Proxy-API-Management-Center"
# Authentication directory (supports ~ for home directory)
auth-dir: "~/.cli-proxy-api"
```

粘贴到刚刚新建的 config.yaml 里

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

然后运行 `mkdir -p /data/CLIProxyAPI && touch /data/CLIProxyAPI/compose.yaml` ，创建docker compose文件

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

复制以下docker compose 配置

```yaml
services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api:latest
    container_name: cli-proxy-api
    ports:
      - "8317:8317"
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml
      - ./auths:/root/.cli-proxy-api
    restart: unless-stopped
```

粘贴到刚刚新建的 compose.yaml 里

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

运行如下命令 `cd /data/CLIProxyAPI && docker compose up -d` ，创建容器，如图即为成功

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

## 3\. 配置

接下来访问 `服务器IP:8317/management.html` ，进入后台管理页（如果你修改了端口则替换为你的端口），输入你在前面配置的密码，登录

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

进入后台主页

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

本文以对接Qwen作为教程，其它大同小异，请自行研究

点击 OAuth 登录

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

下拉到 Qwen OAuth ，点击登录，等待链接出现后，复制链接到浏览器打开，或者点击 打开链接 按钮

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

登录千问账号

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

千问显示认证成功

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

回到项目后台，也可以看到认证成功

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

接下来添加 API 密钥，点击配置面板，下拉到认证配置处，点击添加 API 密钥

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

可自定义或随机生成一个 API 密钥，点击添加

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

可以看到我们刚刚添加的 API 密钥，点击下方的对号，保存更改

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

点击确认保存

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

## 4\. 使用

到此已经完成，可以使用该密钥了，BaseURL 即为你的服务器IP:项目端口，本项目能提供标准的OpenAI API和Claude API，这里就不过多赘述了

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

基于docker搭建CLIProxyAPI图文教程

CLIProxyAPI 能够将 GeminiCLI、ClaudeCode 等工具转换为标准 API 接口，供 OpenClaw 或其他客户端使用。

腾云先锋（TDP）成员

后端

OpenClaw教程详解CLIProxyAPI搭建方法，教你如何将GeminiCLI、ClaudeCode转换为API接口。包含腾讯云服务器配置、Docker部署步骤、Qwen对接指南及API密钥生成方法，适合开发者快速搭建AI代理服务。

轻量应用服务器

服务器

容器

OAuth

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

lighthouse

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

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

基于docker搭建CLIProxyAPI图文教程

基于docker搭建CLIProxyAPI图文教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐