侧边栏壁纸
博主头像
yyzq博主等级

欢迎大家

  • 累计撰写 289 篇文章
  • 累计创建 250 个标签
  • 累计收到 818 条评论
标签搜索

目 录CONTENT

文章目录
AIGC

VPS使用Docker云端部署OpenClaw中文版教程-配置公网访问(不建议)-2000万Tokens免费领-通讯方式对接QQ

yyzq
yyzq
2026-03-12 / 0 评论 / 1 点赞 / 18 阅读 / 2,565 字

前言

在 AI 工具快速发展的今天，拥有一个真正属于自己的“本地 AI 助手”正在成为越来越多技术爱好者和内容创作者的刚需。
OpenClaw 中文版 基于原版 OpenClaw 深度优化，在保持与官方版本同步自动更新的前提下，进行了更符合国内用户习惯的增强与适配：

✅ 完整中文界面

✅ 非阉割版功能保留

✅ 自动跟进原版更新

✅ 内置飞书支持

✅ 针对国内网络环境优化

✅ 支持 Windows / macOS / Linux 等多平台

在之前的视频中，我们已经完成了OpenClaw在 Windows 和 macOS 还有Linux系统的部署教程。以及在飞牛NAS上使用Docker部署的教程
那么本期教程，我们在VPS上使用Docker的方式部署openclaw,并且配置成公网访问(虽然不推荐)，VPS上使用docker部署可以实现容器隔离对于VPS来说更安全。

暴漏在互联网上的龙虾们-🦞 OpenClaw 曝光观察板
image-1773240114113

OpenClaw特点

特性 说明 核心优势
🖥️ 本地运行 支持 Mac / Windows / Linux，在你的电脑上运行 数据不出本地，隐私优先
💬 聊天应用支持 可接入 WhatsApp、Telegram、Discord、Slack、Signal、iMessage等 无缝融入日常工作与沟通
🧠 持久记忆 记住用户偏好、历史上下文和使用习惯 越用越懂你，专属 AI 助手
🌐 浏览器控制 自动浏览网页、填写表单、抓取数据 可执行真实在线任务
⚡ 系统访问 读写文件、运行脚本、执行命令 真正具备“动手能力”的 AI
🔌 插件系统 支持社区技能扩展与自定义开发 功能可扩展、可定制

准备条件

1.OpenClaw官方

openclaw官网
image-1773054508919
openclaw官方的github
根据 star-history.com 统计的 GitHub 历史最高星标项目榜，OpenClaw 目前排名第 12，不过更靠前的项目都是教程、整合、讨论类项目，因此 OpenClaw 可以说是名副其实的开源软件星标第一。
image-1773054565378
本教程使用另一个
中文版OpenClaw的github
目前3k stars
image-1773240557782

中文社区
image-1773055116369

2.一台Linux服务器

我们主要演示在VPS上使用Docker部署的过程
购买VPS可以访问
JTTI
image-1773242351541
我们可以选择香港地区(可以解决部分网站的访问问题 )，系统可以推荐使用Debian系统(其他系统也可以),
配置
建议最低2G内存，4核处理器，20G硬盘

3.自己准备大模型API

（本教程演示硅基流动免费的API方法作为体验使用
还有其他跟多平台有免费的API可用）
比如智谱实名认证用户也有2000万tokens体验包
image-1772690782361
image-1772690861678
有兴趣的自取

一、获取免费的token

硅基流动对新用户有2000万的免费tokens
我们打开
硅基流动官网
注册好账号
image
我的邀请码

FDAbEsxU

登录成功之后需要实名认证才能成功领取
image-1772348734014
点击认证-使用支付宝扫码认证即可
image-1772348774111
使用各种API默认直接扣抵用金
image-1772348857955
申请API秘钥-后面使用
image-1772348916960
有多种大模型API可选
image-1773242613286

硅基流动的URL地址是这个，后面会用到
API Base URL

https://api.siliconflow.cn/v1

二、在VPS上用Docker部署OpenClaw

2.1、Docker环境部署

（已经有docker的可以跳过）
在vps安装docker和docker-compose
Docker官方安装文档（英文）
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档（英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose（中文）
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose（中文）
https://duan.yyzq.eu.org//04

推荐直接用一键脚本

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

执行以下命令查看docker版本

docker --version

Docker version 29.1.3, build f52814d

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

执行以下命令查看docker-compose版本

docker-compose --version

Docker Compose version v5.0.1

2.2、部署命令

首先我们使用root用户在VPS创建一个目录,并进入此目录

mkdir openclaw-zh ;cd openclaw-zh

然后使用vi/vim工具新建docker-compose.yml文件

vim docker-compose.yml

docker-compose内容如下

services:
  openclaw:
    image: 1186258278/openclaw-zh:latest     #latest	稳定版，经过测试推荐使用 ，nightly	每小时同步上游最新代码
    container_name: openclaw                  # 容器名称为 openclaw
    ports:
      - "18789:18789"                        # 映射容器的 18789 端口到主机的 18789 端口
    volumes:
      - ./openclaw-data:/root/.openclaw      # 数据存放在当前目录的 openclaw-data 文件夹
    environment:
      - OPENCLAW_GATEWAY_TOKEN=owdiabshppoajs29uakjsnd09390bn891n!3  # 安全的 Gateway Token，建议创建 .env 文件设置,自定义修改
      - TZ=Asia/Shanghai                     # 设置容器时区为上海时区
    restart: always                           # 设置容器总是重新启动（即使容器崩溃或退出）
    command: openclaw gateway run --allow-unconfigured  # 默认启动 gateway（首次需要初始化，见下方说明）
    healthcheck:
      test: ["CMD", "wget", "-q", "--spider", "http://localhost:18789/health", "||", "exit", "0"]  # 健康检查请求
      interval: 30s                           # 健康检查间隔时间为 30 秒
      timeout: 10s                            # 健康检查超时时间为 10 秒
      retries: 3                              # 健康检查失败的重试次数为 3 次
      start_period: 10s                       # 容器启动后等待 10 秒再开始健康检查
volumes:
  openclaw-data:
    external: false                         # 禁用外部卷，确保使用当前目录的卷
镜像源 地址 适用场景
Docker Hub 1186258278/openclaw-zh 国内用户推荐
ghcr.io ghcr.io/1186258278/openclaw-zh 海外用户

可用标签
标签 说明
latest 稳定版，经过测试推荐使用
nightly 每小时同步上游最新代码

不建议使用nightly虽然与官方保持更新，可能有新问题，我们本教程演示稳定版latest

然后执行运行容器的命令

docker-compose up -d

等待镜像拉取自动启动
image-1773243500118
查看是否运行成功

docker-compose ps 

docker-compose ps 
NAME       IMAGE                           COMMAND                  SERVICE    CREATED       STATUS                   PORTS
openclaw   1186258278/openclaw-zh:latest   "docker-entrypoint.s…"   openclaw   2 hours ago   Up 2 hours (unhealthy)   0.0.0.0:18789->18789/tcp

成功之后我们使用以下命令进入docker容器中

docker exec -it openclaw /bin/bash

输入命令初始化

openclaw onboard --install-daemon

image-1773243421874
稍等片刻就显示初始化向导了
同意安全风险-回车
我们选择快速开始
image-1773243608192
我们填入适合自己的厂商的API
我演示选择自定义服务商
image-1773243670879
API Base URL

https://api.siliconflow.cn/v1

image-1773243712124
填入厂商API的秘钥
image-1773243818105
Endpoint compatibility
选择
OpenAI-compatible就可以
image-1773243862634
Model ID我这边选择，
Pro/MiniMaxAI/MiniMax-M2.5
大家自定义选择
image-1773243901127
验证成功- Endpoint ID
默认 custom-api-siliconflow-cn即可
image-1773243932542
Model alias (optional)直接回车即可

选择渠道 (快速开始)
我们选择适合自己的通讯方式
由于QQ目前对接很简单我本期演示QQ的方式
暂时跳过
image-1773244004252
如果退出了，我们再次执行

docker exec -it openclaw /bin/bash

进入
image-1773244034117
执行以下命令进入TUI先保证通话正常

openclaw tui

image-1773244207743

2.3、配置公网访问

此步骤可以实现互联网公网访问18789配置界面
首先我们停止容器

docker-compose down

然后我们进入本地配置文件目录中

cd openclaw-data

养成修改配置先备份的好习惯

cp -r openclaw.json openclaw.json.202603

然后我们使用vim直接修改这个配置文件

vim openclaw.json

将openclaw.json配置中的

  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "owdiabshppoajs29uakjsnd09390bn891n!3"
    },

修改成

  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "http://192.168.31.115:18789",
        "http://127.0.0.1:18789"
      ],
      "allowInsecureAuth": true,
      "dangerouslyDisableDeviceAuth": true  
    },
    "auth": {
      "mode": "token",
      "token": "owdiabshppoajs29uakjsnd09390bn891n!3"
    },

说明：
bind由loopback改成lan
然后新增

    "controlUi": {
      "allowedOrigins": [
        "http://192.168.31.115:18789",
        "http://127.0.0.1:18789"
      ],
      "allowInsecureAuth": true,
      "dangerouslyDisableDeviceAuth": true  
    },

其中192.168.31.115改成你服务器的公网IP
注意自己的token一定要自己修改下，为了安全

如果服务器上不好操作的可以下载下来使用文本修改
image-1773245704292
然后再回到项目目录执行运行容器的命令

docker-compose up -d

此时我们打开
http:vpsip:18789
配置好网管令牌即可在网页使用云端的openclaw了
image-1773245897005
测试对话正常
image-1773246042866

2.4、通讯方式对接QQ

第一步：创建 QQ 机器人

  1. 打开 QQ 开放平台
    image-1772971770553
  2. 使用手机 QQ 扫码登录（如未实名需先完成实名登记）
    image-1772971857182
  3. 点击页面上的「创建机器人」按钮
  4. 搞定！每个 QQ 号最多可创建 5 个机器人

第二步：绑定 OpenClaw

创建机器人后，平台会提供 3 条配置指令，复制到终端执行即可：

# 安装 QQ 插件
openclaw plugins install @sliverp/qqbot@latest

# 添加机器人频道（替换为你的 token）
openclaw channels add --channel qqbot --token "你的机器人Token"

# 重启网关
openclaw gateway restart

image-1773058387138

进入容器内执行以下命令

docker exec -it openclaw /bin/bash

依次执行3个命令即可成功对接QQ
1.安装OpenClaw开源社区QQBot插件
image-1773246542212
2.配置绑定当前QQ机器人
image-1773246590272
3.重启本地OpenClaw服务-对接成功
image-1773246643275
对话正常
image-1773246728048

三、更换模型或者配置其他通讯方式

可以运行安装向导-重新配置

openclaw onboard --install-daemon

可以用以下命令添加其他通讯方式

openclaw channels add

四、常用命令

重启容器

docker restart openclaw

查看日志

docker logs openclaw

Compose 启动

docker-compose up -d

Compose 停止

docker-compose down

五、卸载 OpenClaw中文版

直接删除整个项目即可

1
openclaw
  1. qrcode alipay
  2. qrcode weixin
版权归属： yyzq
本文链接： https://www.ywsj365.com/archives/vps-shi-yong-docker-yun-duan-bu-shu-openclaw-zhong-wen-ban-jiao-cheng---pei-zhi-gong-wang-fang-wen--bu-jian-yi--2000-wan-tokens-mian-fei-ling---tong-xun-fang-shi-dui-jie-qq
许可协议： 本文使用《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》协议授权
广告 广告

评论区