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

保姆级教程:OpenClaw(Clawdbot)汉化版本地搭建+Docker隔离部署及阿里云极速部署指南2026 年初 GitHub 开源项目 OpenClaw 曾用名 Clawd Moltbot 迎来爆发式增长 一周内 Star 数从 7800 飙升至 12 万 成为史上增长最快的开源项目之一 这款由 PSPDFKit 创始人 Peter Steinberger 打造的通用 AI 助手 突破了传统聊天机器人的局限 能真正执行系统控制 浏览器自动化 邮件管理等实际任务 但原版全英文界面对中文用户并不友好

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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

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










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

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

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

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等编程类工具形成明显差异,更适合日常办公、个人效率提升等场景,核心对比见下表:

对比项 OpenClaw Claude Code Cursor 核心定位 通用AI助手 编程专用助手 IDE+AI编程工具 运行方式 本地/Docker/云端 终端CLI 桌面IDE界面 交互渠道 多平台社交工具+控制台 仅终端 仅IDE内 系统控制 完整本地文件/脚本权限 仅代码相关操作 有限文件操作 浏览器自动化 原生支持 不支持 不支持 持久记忆 原生支持 不支持 不支持 开源协议 MIT开源 MIT开源 不开源

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

安装方式 核心环境要求 辅助工具 一键脚本/npm安装 Node.js 22.12.0及以上版本 Git、终端/PowerShell Docker部署 Docker Engine(任意版本) Docker Compose(可选) 阿里云部署 阿里云服务器(2核2G起步) 浏览器、SSH工具
# 检测Node.js版本(需显示v22.x.x及以上) node -v # 检测Docker版本(Docker部署需执行) docker -v # 检测Git版本(拉取源码需执行) git --version 

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

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

Linux/macOS系统

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

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

Windows系统

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

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

若简写命令执行失败,可执行完整命令:

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

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

# 安装稳定版(推荐,兼容性强) npm install -g @qingchencloud/openclaw-zh@latest # 或安装最新版(小时级同步官方,含最新功能) npm install -g @qingchencloud/openclaw-zh@nightly # 启动初始化向导(汉化版中文交互) openclaw onboard # 启动后台守护进程(开机自启,无需一直打开终端) openclaw onboard --install-daemon # 直接启动OpenClaw主程序 openclaw 

无论哪种安装方式,首次启动都会进入中文交互式初始化向导,按提示完成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部署适合需要环境隔离的用户,如同时运行多个版本、NAS部署、服务器轻量运行等,避免与本地环境的依赖冲突,提供一键部署脚本手动配置部署两种方式,支持本地访问和远程访问。

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

Linux/macOS

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

Windows PowerShell

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

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

# 第一步:初始化配置(首次运行必须,创建配置文件) docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//openclaw-zh:nightly openclaw setup # 第二步:设置网关运行模式为本地 docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//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//openclaw-zh:nightly openclaw gateway run 

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

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

# 1. 创建独立数据卷(持久化配置) docker volume create openclaw-data # 2. 初始化配置文件 docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//openclaw-zh:nightly openclaw setup # 3. 设置网关本地模式 docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//openclaw-zh:nightly openclaw config set gateway.mode local # 4. 绑定到局域网(关键:允许外部设备访问) docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//openclaw-zh:nightly openclaw config set gateway.bind lan # 5. 设置访问令牌(密码,远程访问必须) docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//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//openclaw-zh:nightly openclaw gateway run 

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

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

version: '3.8' services: openclaw: image: ghcr.io//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需先手动执行初始化配置命令,否则容器会因缺少配置重启失败。

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

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

第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot
OpenClaw1.png
OpenClaw02.png
OpenClaw2.png
第二步:选购阿里云轻量应用服务器,配置参考如下:































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













































  • 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
  • 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
  • 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
  • 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
  1. 登录阿里云控制台,「访问阿里云轻量应用服务器OpenClaw一键部署专题页面」模块,点击「创建实例」;
    OpenClaw1.png
    OpenClaw02.png
    OpenClaw2.png

















  2. 「镜像选择」中选择「应用镜像」,在第三方镜像中找到OpenClaw汉化版2026(阿里云官方适配,预装Docker、Node.js 22.x);
    轻量应用服务器OpenClaw镜像.png



  3. 选择实例配置、地域、购买时长,完成支付,等待实例启动(约3-5分钟);
  4. 实例启动后,在「实例详情」中记录服务器公网IP,并在「防火墙/安全组」中放行18789端口(TCP协议),来源设为「0.0.0.0/0」。

通过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//openclaw-zh:nightly openclaw setup # 5. 配置公网访问(绑定局域网+设置访问令牌) docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//openclaw-zh:nightly openclaw config set gateway.bind lan docker run --rm -v openclaw-data:/root/.openclaw ghcr.io//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//openclaw-zh:nightly openclaw gateway run 
  1. 浏览器访问地址:http://你的阿里云公网IP:18789
  2. 输入步骤5设置的访问令牌密码,验证通过后进入中文控制台;
  3. 在控制台发送测试指令(如「帮我创建一个今日待办清单」),能正常回复即部署成功。

针对云端运行场景,可配置阿里云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 

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

页面名称 核心功能 常用操作 概览 系统状态监控 查看运行时间、活跃会话、节点状态 对话 直接与AI交互 发送自然语言指令、执行任务、文件传输 会话 历史记录管理 查看/删除历史对话、恢复会话上下文 渠道 多平台对接 配置Telegram/WhatsApp等渠道、查看连接状态 技能 扩展能力管理 安装/卸载社区技能、启用/禁用内置技能 节点 执行节点管理 配置本地/远程执行节点、分配任务权限 配置 系统参数设置 修改AI模型、访问权限、存储路径等300+配置项 日志 运行记录查看 排查问题、查看任务执行日志、过滤日志类型 调试 高级功能调试 生成系统快照、手动执行RPC、查看事件日志

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 

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

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

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

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

按以下检查清单逐一排查,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备案,否则公网无法访问,可临时切换为香港地域。

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

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

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

原因:镜像仓库认证问题,解决方案:

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

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

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

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

# 启动主程序 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 
# 查看容器运行状态 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//OpenClawChineseTranslation(源码、更新日志);
  3. npm包地址:https://www.npmjs.com/package/@qingchencloud/openclaw-zh(稳定版/最新版);
  4. Docker镜像:ghcr.io//openclaw-zh(nightly为小时级更新版);
  5. 官方上游文档:https://docs.openclaw.ai/(原生功能说明)。

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

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

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

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

小讯
上一篇 2026-04-23 23:09
下一篇 2026-04-23 23:07

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/276073.html