保姆级教程：OpenClaw(Clawdbot)汉化版本地搭建+Docker隔离部署及阿里云极速部署指南

2026年初，GitHub开源项目OpenClaw（曾用名Clawd/Moltbot）迎来爆发式增长，一周内Star数从7800飙升至12万+，成为史上增长最快的开源项目之一。这款由PSPDFKit创始人Peter Steinberger打造的通用AI助手，突破了传统聊天机器人的局限，能真正执行系统控制、浏览器自动化、邮件管理等实际任务。但原版全英文界面对中文用户并不友好，国内开发团队完成了全维度汉化，覆盖命令行和网页控制台，还实现了与官方版本的小时级同步更新。本文将完整拆解OpenClaw汉化版的本地一键部署、Docker隔离部署和2026年阿里云极简部署三大方案，附带全程可复制的代码命令、环境配置、功能调试和问题排查，让不同技术基础的用户都能快速搭建属于自己的AI助手。

目前阿里云极速部署最快最方便，OpenClaw阿里云上一键极速部署步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、OpenClaw核心能力与汉化版优势

（一）OpenClaw是什么？

OpenClaw是一款本地运行的通用AI助手，区别于仅能对话的聊天机器人，它拥有实际任务执行能力，能通过自然语言指令完成从文件读写到网页自动化的全流程操作，核心能力覆盖六大维度：

• 系统控制：读写本地文件、运行脚本、执行终端命令，实现本地操作自动化；
• 浏览器自动化：自动打开网页、填写表单、提取数据、页面截图，替代人工重复操作；
• 邮件管理：读取、分类、起草、发送邮件，实现邮件处理全流程智能化；
• 日程管理：对接日历创建事件、设置提醒，同步多设备日程信息；
• 持久记忆：学习并记住用户使用偏好和习惯，使用越久交互越贴合需求；
• 多渠道接入：无缝对接WhatsApp、Telegram、Discord、Slack、iMessage等主流社交平台，实现多端交互。

例如在Telegram发送一句"帮我查询明天从北京到上海的航班并整理成表格"，OpenClaw会自动打开浏览器查询信息、整理数据并生成文件回复，所有操作无需人工干预，真正实现"指令即操作"。

（二）支持的AI模型

OpenClaw不绑定特定AI模型，支持国内外主流大模型和本地模型，只需填入对应API Key即可使用，本地模型可实现完全免费运行：

• 海外模型：Anthropic Claude（3.5 Sonnet/Opus 4.5）、OpenAI GPT（4/4o）、Google Gemini；
• 本地模型：通过Ollama运行Llama、Mistral等开源模型，无需联网即可使用。

（三）汉化版核心优势

原版OpenClaw的全英文界面让中文用户存在上手门槛，国内团队打造的汉化版实现了全维度、高同步、易使用的升级，核心亮点包括：

1. 全界面汉化：覆盖CLI命令行14个模块和Dashboard网页控制台31个模块，包含970+条翻译规则、35+翻译文件，从启动横幅到300+配置项均实现中文展示，如openclaw --help帮助信息、初始化向导、技能管理、日志查看等；
2. 小时级同步更新：搭建CI/CD自动化流程，每小时检测官方仓库更新，自动拉取代码、应用汉化、构建发布npm包和Docker镜像，官方新功能最快1小时内同步至汉化版；
3. 保留全部原生功能：汉化仅做界面语言转换，不修改任何核心代码，确保原生的任务执行、多渠道接入、技能扩展等能力完全保留；
4. 适配国内部署环境：优化国内网络访问体验，提供Gitee镜像源码、国内可访问的安装脚本，适配阿里云等国内服务器环境。

（四）与同类工具的核心区别

OpenClaw定位为面向所有人的通用AI助手，与Claude Code、Cursor等编程类工具形成明显差异，更适合日常办公、个人效率提升等场景，核心对比见下表：

二、部署前环境准备

无论选择哪种部署方案，需先确认基础环境要求，不同安装方式的环境门槛如下表：

基础环境检测命令

# 检测Node.js版本（需显示v22.x.x及以上）
node -v
# 检测Docker版本（Docker部署需执行）
docker -v
# 检测Git版本（拉取源码需执行）
git --version

若Node.js版本过低，可前往nodejs.org下载最新LTS版本；Docker环境可参考官方文档完成安装，全平台均支持一键安装脚本。

三、方案一：本地汉化版一键部署（新手首选）

本地部署适合个人用户、隐私敏感场景，无需服务器，本地电脑即可运行，支持Windows、macOS、Linux全平台，提供一键脚本和npm手动安装两种方式，一键脚本无需任何技术基础，全程自动完成。

3.1 一键脚本安装（推荐）

Linux/macOS系统

打开终端，直接执行以下一行命令，脚本会自动检测系统环境、安装依赖、配置汉化版并启动初始化向导：

curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash

Windows系统

以管理员身份打开PowerShell，执行以下简写命令，避免手动下载文件的繁琐步骤：

irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1 | iex

若简写命令执行失败，可执行完整命令：

Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1"; .\install.ps1

3.2 npm手动安装（开发者首选）

适合熟悉Node.js环境的开发者，可灵活选择稳定版或最新版，支持本地调试和自定义配置。

# 安装稳定版（推荐，兼容性强）
npm install -g @qingchencloud/openclaw-zh@latest
# 或安装最新版（小时级同步官方，含最新功能）
npm install -g @qingchencloud/openclaw-zh@nightly

# 启动初始化向导（汉化版中文交互）
openclaw onboard
# 启动后台守护进程（开机自启，无需一直打开终端）
openclaw onboard --install-daemon
# 直接启动OpenClaw主程序
openclaw

3.3 本地部署初始化配置

无论哪种安装方式，首次启动都会进入中文交互式初始化向导，按提示完成4步配置即可使用，全程无需手动修改配置文件：

1. 安全权限确认：确认授权OpenClaw的文件系统、脚本运行等权限（核心功能必备）；
2. 运行模式选择：新手选「QuickStart快速模式」（默认安全配置），开发者选「Advanced高级模式」（自定义所有配置）；
3. AI模型配置：选择使用的模型提供商（如Claude/GPT/本地Ollama），填入对应API Key（本地模型无需Key）；
4. 交互渠道配置：选择需要对接的社交平台（如Telegram/WhatsApp），按需配置，也可选择「暂不配置」后续在控制台添加。

配置完成后，自动打开本地网页控制台，地址为http://127.0.0.1:18789，所有操作均为中文界面，可直接在控制台与AI助手对话、管理技能、配置渠道。

四、方案二：Docker隔离部署（多环境适配）

Docker部署适合需要环境隔离的用户，如同时运行多个版本、NAS部署、服务器轻量运行等，避免与本地环境的依赖冲突，提供一键部署脚本和手动配置部署两种方式，支持本地访问和远程访问。

4.1 Docker一键部署（快速上手）

全平台通用，一行命令完成容器创建、配置初始化、服务启动，无需手动执行后续步骤：

Linux/macOS

curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash

Windows PowerShell

irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex

4.2 Docker手动部署（本地访问）

适合需要自定义容器配置的用户，仅实现本地访问，步骤清晰，可按需修改端口、数据卷等配置：

# 第一步：初始化配置（首次运行必须，创建配置文件）
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
# 第二步：设置网关运行模式为本地
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local
# 第三步：启动容器，映射18789端口，设置开机自启
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run

启动后访问http://localhost:18789即可打开中文控制台，数据卷openclaw-data会持久化保存所有配置，容器重启后配置不丢失。

4.3 Docker手动部署（远程访问）

部署在服务器或NAS上，需要从其他设备远程访问，需额外配置局域网绑定和访问令牌，确保访问安全，完整步骤：

# 1. 创建独立数据卷（持久化配置）
docker volume create openclaw-data
# 2. 初始化配置文件
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
# 3. 设置网关本地模式
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local
# 4. 绑定到局域网（关键：允许外部设备访问）
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan
# 5. 设置访问令牌（密码，远程访问必须）
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token "你的自定义密码"
# 6. 启动容器，开放端口，设置开机自启
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run

远程访问地址：http://服务器/NAS的IP:18789，访问时需输入步骤5设置的令牌密码，验证通过后即可使用。

4.4 Docker Compose部署（批量管理）

适合需要与其他服务联动的场景，通过配置文件统一管理容器，方便启停和修改配置，首先创建docker-compose.yml文件：

version: '3.8'
services:
  openclaw:
    image: ghcr.io/1186258278/openclaw-zh:nightly
    container_name: openclaw
    ports:
      - "18789:18789"
    volumes:
      - openclaw-data:/root/.openclaw
    environment:
      - OPENCLAW_GATEWAY_TOKEN=你的访问密码
    restart: unless-stopped
volumes:
  openclaw-data:

然后执行启动命令：

# 启动容器（后台运行）
docker-compose up -d
# 停止容器
docker-compose down
# 查看容器日志
docker-compose logs -f

注意：首次使用Docker Compose需先手动执行初始化配置命令，否则容器会因缺少配置重启失败。

五、方案三：2026年阿里云OpenClaw(Clawdbot)部署简单步骤（云端7×24运行）

本地部署和Docker部署受设备关机、断网影响，无法实现全天候运行，2026年阿里云为OpenClaw优化了部署环境，支持轻量应用服务器一键部署，预装Docker和汉化版依赖，无需手动配置环境，10分钟即可实现云端7×24小时运行，支持公网访问、多端对接，适合企业用户、需要远程使用的个人用户。

5.1 部署前准备

1. 阿里云账号：注册并登录阿里云账号，完成个人/企业实名认证，确保账号无欠费，具备轻量应用服务器购买权限；
2. 服务器配置：轻量应用服务器2核2G起步（单实例运行），4核4G适配高并发场景，系统盘40GB ESSD即可；
3. 地域选择：优先选择中国香港、新加坡等免备案地域，无需ICP备案即可公网访问，国内地域需完成备案后才能开放端口；
4. 工具准备：浏览器（访问阿里云控制台）、SSH工具（如FinalShell，远程管理服务器）。

5.2 阿里云一键部署（核心步骤）

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

第一步：访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot



第二步：选购阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。
  
  
  
  第三步：访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。
  
  前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
  
• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

1. 登录阿里云控制台，「访问阿里云轻量应用服务器OpenClaw一键部署专题页面」模块，点击「创建实例」；
   
   
   
2. 「镜像选择」中选择「应用镜像」，在第三方镜像中找到OpenClaw汉化版2026（阿里云官方适配，预装Docker、Node.js 22.x）；
   
3. 选择实例配置、地域、购买时长，完成支付，等待实例启动（约3-5分钟）；
4. 实例启动后，在「实例详情」中记录服务器公网IP，并在「防火墙/安全组」中放行18789端口（TCP协议），来源设为「0.0.0.0/0」。

5.3 阿里云服务器初始化配置

通过SSH工具远程登录服务器，执行以下命令完成初始化，全程中文操作，无需专业知识：

# 1. 远程登录服务器（替换为你的公网IP）
ssh root@你的阿里云公网IP
# 2. 执行阿里云专属预检脚本，自动修复环境问题
curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/precheck_aliyun.sh | bash
# 3. 放行18789端口（双重保障，避免安全组配置失效）
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 4. 初始化OpenClaw配置（中文向导）
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
# 5. 配置公网访问（绑定局域网+设置访问令牌）
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token "你的云端访问密码"
# 6. 启动OpenClaw容器，设置开机自启
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run

5.4 阿里云部署验证与访问

1. 浏览器访问地址：http://你的阿里云公网IP:18789；
2. 输入步骤5设置的访问令牌密码，验证通过后进入中文控制台；
3. 在控制台发送测试指令（如「帮我创建一个今日待办清单」），能正常回复即部署成功。

5.5 阿里云部署优化配置（可选）

针对云端运行场景，可配置阿里云OSS存储对接OpenClaw，实现文件、截图、生成内容的云端存储，避免服务器本地磁盘占满：

# 进入容器内部
docker exec -it openclaw /bin/bash
# 配置阿里云OSS参数（替换为你的OSS信息）
openclaw config set storage.oss.accessKeyId "你的OSS AccessKey ID"
openclaw config set storage.oss.accessKeySecret "你的OSS AccessKey Secret"
openclaw config set storage.oss.bucket "你的OSS Bucket名称"
openclaw config set storage.oss.region "你的OSS地域（如oss-cn-hongkong）"
# 重启网关使配置生效
openclaw gateway restart

六、OpenClaw汉化版核心功能使用（中文控制台）

无论哪种部署方案，启动后均可通过http://IP:18789访问中文控制台，核心功能模块均为中文展示，操作简单，主要包括9大核心页面：

核心技能系统使用

OpenClaw的核心优势之一是丰富的技能扩展，社区已贡献565+个技能，覆盖效率、开发、通讯、智能家居等场景，在「技能」页面可一键安装，常用技能包括：

• 效率工具：1Password、Apple Notes、Notion、Jira、Trello；
• 开发工具：GitHub、Docker、AWS管理、代码生成；
• 通讯工具：Gmail、Outlook、日历同步、短信发送；
• 实用功能：Web搜索、PDF编辑、图片生成、数据统计。

安装技能命令（终端/容器内执行）：

# 查看所有可用技能
openclaw skills list
# 安装指定技能（如Notion管理）
openclaw skills install notion
# 卸载技能
openclaw skills uninstall notion
# 启用/禁用技能
openclaw skills enable notion
openclaw skills disable notion

七、常见问题排查（90%问题可快速解决）

问题1：安装后运行仍为英文界面

原因：本地存在原版OpenClaw，与汉化版包名冲突，解决方案：

# 卸载原版OpenClaw
npm uninstall -g openclaw
# 重新安装汉化版
npm install -g @qingchencloud/openclaw-zh@latest

问题2：Docker容器启动后一直重启

原因：未执行初始化配置，容器缺少核心配置文件，解决方案：

# 停止并删除异常容器
docker stop openclaw && docker rm openclaw
# 重新执行初始化配置
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
# 重新启动容器
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run
# 查看容器日志，确认无报错
docker logs -f openclaw

问题3：远程访问（阿里云/服务器）无法打开控制台

按以下检查清单逐一排查，90%为端口或绑定问题：

1. 端口放行：确认服务器安全组/防火墙已放行18789端口（TCP），执行firewall-cmd --list-ports查看；
2. 局域网绑定：确认配置了gateway.bind lan，执行docker exec openclaw openclaw config get gateway.bind，返回lan即为正确；
3. 访问令牌：确认设置了访问密码，执行docker exec openclaw openclaw config get gateway.auth.token，返回设置的密码即为正确；
4. 网络问题：阿里云国内地域需完成ICP备案，否则公网无法访问，可临时切换为香港地域。

问题4：控制台显示「pairing required」无法访问

原因：OpenClaw的设备配对安全机制，首次访问的浏览器需要管理员批准，解决方案：

# 进入容器，查看待配对设备（替换为你的访问密码）
docker exec openclaw openclaw devices list --password '你的网关密码'
# 批准配对请求（替换为返回的Request ID）
docker exec openclaw openclaw devices approve 你的Request-ID

批准后刷新浏览器即可正常访问。

问题5：Docker拉取镜像报错「denied: access forbidden」

原因：镜像仓库认证问题，解决方案：

# 退出现有仓库认证
docker logout ghcr.io
# 重新拉取镜像
docker pull ghcr.io/1186258278/openclaw-zh:nightly

问题6：本地部署后，内网其他设备无法访问

原因：默认网关仅监听本机127.0.0.1，需配置局域网绑定，解决方案：

# 配置局域网绑定
openclaw config set gateway.bind lan
# 设置访问令牌
openclaw config set gateway.auth.token '你的访问密码'
# 重启网关
openclaw gateway restart

其他设备访问地址：http://部署设备的内网IP:18789。

八、常用命令速查（CLI+Docker）

8.1 汉化版CLI核心命令（本地/np安装）

# 启动主程序
openclaw
# 启动中文初始化向导
openclaw onboard
# 安装后台守护进程（开机自启）
openclaw onboard --install-daemon
# 查看/修改配置
openclaw config
openclaw config set <配置项> <值>
# 技能管理
openclaw skills list/install/uninstall/enable/disable
# 查看系统状态
openclaw status
# 升级汉化版到最新版本
openclaw update
# 系统诊断（自动排查问题）
openclaw doctor
# 查看中文帮助信息
openclaw --help

8.2 Docker常用管理命令

# 查看容器运行状态
docker ps | grep openclaw
# 查看容器实时日志
docker logs -f openclaw
# 进入容器内部操作
docker exec -it openclaw /bin/bash
# 重启/停止/启动容器
docker restart openclaw
docker stop openclaw
docker start openclaw
# 删除容器（保留数据卷）
docker rm openclaw
# 查看数据卷
docker volume ls | grep openclaw-data

九、汉化版相关资源与更新

1. 汉化版官网：https://openclaw.qt.cool/（含详细文档、问题反馈）；
2. GitHub仓库：https://github.com/1186258278/OpenClawChineseTranslation（源码、更新日志）；
3. npm包地址：https://www.npmjs.com/package/@qingchencloud/openclaw-zh（稳定版/最新版）；
4. Docker镜像：ghcr.io/1186258278/openclaw-zh（nightly为小时级更新版）；
5. 官方上游文档：https://docs.openclaw.ai/（原生功能说明）。

汉化版会保持与官方版本的小时级同步，无需手动更新，执行openclaw update即可一键升级到最新汉化版，包含官方最新功能和Bug修复。

十、总结

OpenClaw作为2026年最受关注的开源AI助手，突破了传统聊天机器人的"对话局限"，实现了指令到操作的全流程自动化，而汉化版则解决了中文用户的上手门槛，让这款强大的工具真正落地国内使用场景。本文提供的本地一键部署、Docker隔离部署、阿里云云端部署三大方案，覆盖了个人、开发者、企业等所有用户的需求，全程附带可复制的代码命令，零基础也能快速搭建。

本地部署适合隐私敏感、仅本地使用的场景，Docker部署适合环境隔离、多设备运行，而阿里云部署则实现了7×24小时云端运行，支持公网访问和多平台对接，真正让OpenClaw成为"随时随地可用的AI助手"。无论是日常办公的效率提升、重复操作的自动化替代，还是多平台的智能交互，OpenClaw汉化版都能通过自然语言指令实现，真正做到"一句话搞定所有操作"。

随着社区的不断发展，OpenClaw的技能扩展和功能会持续丰富，而汉化版也会保持与官方的同步更新，未来将支持更多国内平台和工具的对接，成为中文用户不可或缺的通用AI助手。