OpenClaw + 1Panel 快速部署教程：10 分钟搞定私有化 AI 聊天客户端（2026）

飞坦
7 阅读1分钟

上周三我们团队新来了个产品经理，第一天就问我："有没有一个界面能让我同时试 Claude Opus 4.7 和 GPT-5.5？不要让我注册一堆账号。"我说行，给你搭一个 OpenClaw。

结果折腾了一下午——不是 OpenClaw 本身难，是我之前一直用命令行手动 docker compose，端口冲突、证书配置、反向代理搞得头大。后来想起来服务器上装了 1Panel，试了一下用它的应用商店一键部署，整个过程大概 10 分钟就跑起来了。这篇把完整流程写下来，包括我踩的几个坑。

OpenClaw 是个开源的多模型 AI 聊天客户端，支持 OpenAI 兼容协议，改一下 base_url 就能接各种大模型 API，界面长得像 ChatGPT 但可以自己部署、自己控制数据。配合 1Panel（开源的 Linux 服务器运维面板），整个部署过程不需要手写 docker-compose.yml，鼠标点点就完事。

先说结论

步骤耗时难度
安装 1Panel约 3 分钟复制粘贴一行命令
1Panel 应用商店装 OpenClaw约 2 分钟点几下鼠标
配置 API Key + base_url约 3 分钟填表单
配置反向代理 + HTTPS约 2 分钟1Panel 自带

总共 10 分钟左右。前提是你有一台 Linux 服务器（2C4G 够用），有域名（可选，IP 直接访问也行）。

环境准备

我用的是一台腾讯云轻量 2C4G 的机器，系统 Ubuntu 22.04。CentOS、Debian 也都行，1Panel 都支持。

需要的东西：

  • 一台 Linux 服务器，最低 1C2G，推荐 2C4G
  • SSH 工具（我用 Termius）
  • 一个 AI API 的 Key（后面会说怎么配）
  • 域名（可选，不配也能用 IP:端口访问）

第一步：装 1Panel

如果你服务器上已经有 1Panel 了，跳过这步。

SSH 登上去，一行命令：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

装完会输出后台地址、用户名、密码，长这样：

=== 1Panel 安装完成 ===
面板地址: http://your-server-ip:18443/random-path
用户名: username
密码: xxxxxxxx

把这三个记下来，浏览器打开登录。

有个小坑：如果你用的云服务器，安全组/记得放行 18443 端口。我第一次装完死活打不开页面，查了 5 分钟才想起来安全组没开。

第二步：1Panel 应用商店安装 OpenClaw

登录 1Panel 后台，左边菜单找到「应用商店」。

搜索栏输入 OpenClaw，能看到它在列表里。点「安装」。

安装界面会让你填几个参数：

  • 端口：默认 3210，不冲突就别改
  • 数据目录：默认就行
  • 是否启用外部访问：开

点确认，等个一两分钟，容器拉下来就跑起来了。

这时候访问 http://your-server-ip:3210 应该能看到 OpenClaw 的界面了。

graph TD
 A[浏览器访问 1Panel 后台] --> B[应用商店搜索 OpenClaw]
 B --> C[点击安装 / 填写端口]
 C --> D[1Panel 自动拉取 Docker 镜像]
 D --> E[容器启动完成]
 E --> F[访问 IP:3210 进入 OpenClaw]
 F --> G[配置 API Key + base_url]
 G --> H[开始聊天]

第三步：配置 API Key 和模型

OpenClaw 装好之后是个空壳，需要配上 API Key 才能用。

进入 OpenClaw 界面 → 左下角设置（齿轮图标）→ 语言模型 → 添加 AI 服务商。

选 OpenAI（因为大部分聚合 API 都兼容 OpenAI 协议），填入：

API Key: sk-xxxxxxxxxxxxxxxx
API 代理地址: https://api.ofox.ai/v1

填完点「检查」，如果返回模型列表就说明通了。

然后你可以在模型列表里勾选你要用的模型。我一般勾这几个：

claude-opus-4-20250918
claude-sonnet-4-20250514
gpt-5.5
deepseek-chat
gemini-3.1-pro

保存。回到聊天界面，右上角选模型，就能开聊了。

如果你想同时配多个服务商也行，比如一个 Key 走 OpenRouter，一个走 ofox.ai（这俩都兼容 OpenAI 协议，OpenRouter 收 5.5% 手续费，ofox 是 0% 加价对齐官方价格），OpenClaw 支持多个 provider 并存，聊天时随时切换。

第四步：配反向代理和 HTTPS（可选但推荐）

用 IP:端口裸奔不太安全，特别是你要给团队其他人用的时候。

1Panel 自带网站管理功能，操作很简单：

左边菜单「网站」→「创建网站」→ 选「反向代理」：

  • 主域名填你的域名，比如 chat.yourdomain.com
  • 代理地址填 http://127.0.0.1:3210

创建完之后，点这个网站进去 → 「HTTPS」→ 申请 Let's Encrypt 证书 → 开启强制 HTTPS。

整个过程鼠标点点，不用手写 Nginx 配置。说实话这是我用 1Panel 最爽的地方，以前手动改 nginx.conf 改到想骂人。

踩坑记录

坑 1：WebSocket 连接断开

配完反向代理后，OpenClaw 的对话流式输出不工作了，消息发出去没反应，浏览器控制台报：

WebSocket connection to 'wss://chat.yourdomain.com/api/ws' failed: 
Error during WebSocket handshake: Unexpected response code: 502

原因是 1Panel 默认的反向代理配置没有加 WebSocket 支持。

解决办法：在 1Panel 的网站设置里找到「配置文件」，在 location / 块里加三行：

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

保存，重载 Nginx，刷新页面就好了。

坑 2：API 返回 401

我一开始把 API Key 复制进去，检查连接时报：

{"error":{"message":"Incorrect API key provided: sk-xxxx...xxxx.","type":"invalid_request_error","code":"invalid_api_key"}}

查了半天，发现是复制的时候前面多了个空格。删掉空格就通了。这种低级错误真的很容易犯，特别是从密码管理器里复制的时候。

坑 3：1Panel 应用商店搜不到 OpenClaw

4 月 22 号那天有个群友说搜不到，后来发现是 1Panel 版本太老。v1.10 以上才有 OpenClaw。在 1Panel 后台「面板设置」→「关于」里看版本号，低于 v1.10 的话先升级：

1pctl update

进阶：给团队多人用

如果你是给团队部署的，OpenClaw 支持多账户。但默认的账户系统比较简单，我的建议是：

  1. 在 OpenClaw 设置里开启访问密码，至少不让外人随便进来
  2. 每个人用自己的浏览器账户，对话记录存在浏览器本地，互不干扰
  3. API Key 是共用的，所有人的调用都走同一个 Key 计费

如果你需要看每个人分别花了多少钱，单靠 OpenClaw 做不到。我目前的做法是在 API 聚合平台的管理后台看——按 API Key 维度能看到每笔调用的 Token 消耗和费用。这个话题展开又是一篇文章了。

小结

1Panel + OpenClaw 这套组合确实省事。以前我觉得"一键部署"都是噱头，实际试了之后，比手写 docker-compose 再配 Nginx 快太多。特别是 HTTPS 证书那块，1Panel 的 Let's Encrypt 自动续期真的香。

OpenClaw 本身作为多模型聊天客户端，功能够用了——多模型切换、Markdown 渲染、代码高亮、文件上传都有。插件生态我还没深入看，不确定插件市场里的东西质量怎么样，后面有时间再折腾。

整个部署跟着上面的步骤走，10 分钟内应该能搞定。最容易卡住的就是 WebSocket 那个坑，记得加那三行 Nginx 配置就行。

avatar
文章
阅读
粉丝