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

## 1\. 前言

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

本文基于octopus v0.9.18版本，Github地址为 [https://github.com/bestruirui/octopus](https://github.com/bestruirui/octopus)

octopus 是一个聚合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/e16f5c148038caf719c19998cc4ee828.png)

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

## 2\. 搭建

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

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

复制以下 docker compose 配置（8080端口太常见容易被占用所以这里我改成了8780，可自行修改为其它端口）

```yaml
services:
  octopus:
    image: bestrui/octopus
    ports:
       - '8780:8080'
    volumes:      
       - './data:/app/data'
    container_name: octopus
    restart: unless-stopped
```

粘贴到 compose.yaml 里

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

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

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

## 3\. 配置

访问 服务器IP:8780 （如果你修改了端口则替换为你的端口），进入登录界面，初始账号密码为 `admin` ，点击登录

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

进入后台主页

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

点击设置，修改初始用户名，点击保存（我不理解为什么用户名和密码不能一起修改，一定要分开修改，修改其中一个还需要重新登录，导致我需要修改，登录，再修改，再登录😅，并且还没有退出登录按钮😅）

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

用新用户名和旧密码 `admin` 登录

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

点击设置，修改初始密码，点击修改密码

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

用新用户名和新密码登录

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

点击 渠道 ，点击右上角 +

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

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

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

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

类型默认 OpenAI Chat ，名称随意，API Key 填写在CLIProxyAPI配置的密钥，Base URL填写 CLIProxyAPI的服务器IP:端口/v1，或是你反代CLIProxyAPI的域名/v1（注意！一定要带/v1），点击模型处的刷新，点击创建渠道

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

可以看到我们刚刚创建的渠道

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

点击分组，点击右上角 +

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

该项目的分组最好是以模型为单位配置的，即每个模型一个分组，这里我们只为 `qwen3-coder-plus` 添加一个分组作为演示

名称这里我选择使用模型名作为分组名，点击以下拉渠道，点击 `qwen3-coder-plus` 模型右边的加号，点击创建

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

可以看到我们刚刚创建的分组

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

点击设置，点击 API 密钥的 + ，添加 API 密钥

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

名称随意，把刚刚创建的分组点亮，点击创建

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

可以看到我们创建的 API 密钥

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

## 4\. 使用

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

_彩蛋：（因为我一开始踩大坑了，所以写完我特意测试了一下，确定了这么配置是可以用的）_

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

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

基于docker搭建octopus图文教程

该教程详细介绍了基于 Docker 部署 octopus 聚合 API 项目的具体流程。octopus 旨在将多种免费或付费 API 整合为统一接口，特别适用于多模型渠道的集中管理。

腾云先锋（TDP）成员

开发工具

云计算

后端

OpenClaw教程：octopus聚合API搭建指南，详细讲解基于docker部署octopus v0.9.18的方法，包含渠道配置、分组管理和API密钥生成步骤，支持OpenAI兼容API接入，适合个人多账号模型聚合使用场景。

轻量应用服务器

服务器

容器

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

lighthouse

2026新春采购季

domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

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

基于docker搭建octopus图文教程

基于docker搭建octopus图文教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐