跳到主要内容

SayClaw 部署总览

本文档完整记录 SayClaw 平台的所有服务、配置和部署流程。
照着做，即可从零完成上线。最后更新：2026-03-10。

架构图​

                        ┌─────────────┐
                        │  Cloudflare │  DNS + CDN
                        │  sayclaw.ai │
                        └──────┬──────┘
                               │
                    ┌──────────▼──────────┐
                    │   小龙 (ai-jp-1)     │  35.243.76.69
                    │   主服务器            │
                    │                      │
                    │  ┌─ Nginx ──────────┐│
                    │  │ api.sayclaw.ai   ││→ admin-api :8081
                    │  │ portal-api.*     ││→ portal-api :8082
                    │  │ admin.*          ││→ /var/www/sayclaw-admin
                    │  │ app.* / m.*      ││→ /var/www/sayclaw-app
                    │  │ doc.*            ││→ /var/www/sayclaw-docs/build
                    │  │ git.*            ││→ GitLab :8929
                    │  │ llm.*            ││→ One API :3001
                    │  │ seven.*          ││→ OC Gateway :18789
                    │  │ design.*         ││→ /var/www/sayclaw-design
                    │  │ /oc-ws/{id}      ││→ 动态路由到各实例
                    │  └──────────────────┘│
                    │                      │
                    │  ┌─ Docker ─────────┐│
                    │  │ MySQL 8.0  :3306 ││
                    │  │ PG 15      :5432 ││
                    │  │ GitLab CE  :8929 ││
                    │  │ One-API    :3001 ││
                    │  └──────────────────┘│
                    │                      │
                    │  ┌─ Native ─────────┐│
                    │  │ admin-api  :8081  ││  Go binary
                    │  │ portal-api :8082  ││  Go binary
                    │  │ OC主实例   :18789 ││  openclaw gateway
                    │  └──────────────────┘│
                    └──────┬─────────┬─────┘
                           │         │
              SSH          │         │         SSH
           ┌───────────────▼┐     ┌──▼───────────────┐
           │ 小二 (ai-jp-2)  │     │ 小三 (ai-jp-3)    │
           │ 34.85.76.114   │     │ 34.180.81.148    │
           │                │     │                  │
           │ OC 实例 01-10   │     │ OC 实例 01-08     │
           │ 端口 18789-18798│     │ 端口 18910-18980  │
           └────────────────┘     └──────────────────┘

服务器清单​

名称IP用途SSH
小龙 (ai-jp-1)35.243.76.69主服务器：DB / API / GitLab / Nginx / 主OC实例ssh -i ~/.ssh/id_ed25519_openclaw [email protected]
小二 (ai-jp-2)34.85.76.114OC 实例农场：10 个实例通过小龙跳板：ssh [email protected]（从小龙）
小三 (ai-jp-3)34.180.81.148OC 实例农场：8 个实例ssh -i ~/.ssh/id_ed25519_openclaw [email protected]
跳板访问

Mac mini → 小龙（直连）→ 小二（小龙跳板）
Mac mini → 小三（直连）

域名总表​

域名指向端口/目录SSL 证书
api.sayclaw.ai小龙:8081 (admin-api) + /oc-ws (WS代理)Certbot
portal-api.sayclaw.ai小龙:8082 (portal-api)共用 api.* 证书
admin.sayclaw.ai小龙/var/www/sayclaw-adminCertbot
app.sayclaw.ai小龙/var/www/sayclaw-app共用 api.* 证书
m.sayclaw.ai小龙/var/www/sayclaw-appCertbot
doc.sayclaw.ai小龙/var/www/sayclaw-docs/buildCertbot
git.sayclaw.ai小龙:8929 (GitLab)Certbot
llm.sayclaw.ai小龙:3001 (One API/One-API)Certbot
seven.sayclaw.ai小龙:18789 (OC主实例WebChat)Certbot
design.sayclaw.ai小龙/var/www/sayclaw-designCertbot

端口总表​

小龙 (35.243.76.69)​

端口服务绑定
80/443Nginx0.0.0.0
3001One-API (One API替代)0.0.0.0
3306MySQL 8.0127.0.0.1
5432PostgreSQL 15127.0.0.1
8081admin-api (Go)127.0.0.1
8082portal-api (Go)127.0.0.1
8929GitLab CE0.0.0.0
18789OC 主实例 GatewayLAN

小二 (34.85.76.114)​

端口服务
18789openclaw (实例 01)
18810openclaw-02
18820openclaw-03
18830openclaw-04
18840openclaw-05
18850openclaw-06
18860openclaw-07
18870openclaw-08
18880openclaw-09
18798openclaw-10

小三 (34.180.81.148)​

端口服务
18910openclaw-01
18920openclaw-02
18930openclaw-03
18940openclaw-04
18950openclaw-05
18960openclaw-06
18970openclaw-07
18980openclaw-08

GitLab 仓库​

ID仓库默认分支说明
1sayclaw/sayclawmain主仓库（monorepo 规划）
2sayclaw/sayclaw-docsmain文档站源码 (Docusaurus 3)
3sayclaw/sayclaw-inframain基础设施配置
4sayclaw/sayclaw-opsmain运维脚本
5sayclaw/sayclaw-adminmainAdmin 前端 (Soybean Admin)
6sayclaw/sayclaw-backendmain后端代码 (admin-api + portal-api)
7sayclaw/sayclaw-appmainPortal 前端 (Vue3 CDN SPA)
8sayclaw/sayclaw-portalmainPortal 前端新版
9sayclaw/sayclaw-designmain设计预览中心

Git 认证格式：https://oauth2:[email protected]/sayclaw/xxx.git

技术栈​

层技术
后端Go (Gin 框架)
数据库MySQL 8.0 + PostgreSQL 15
前端-AdminVue 3 + Vite (Soybean Admin)
前端-PortalVue 3 CDN SPA
文档Docusaurus 3
AI 引擎OpenClaw
模型网关One-API (替代 One API)
反向代理Nginx + Certbot
容器Docker
代码托管GitLab CE
DNS/CDNCloudflare
云平台GCP (日本区)