在AI工具爆发的2026年,OpenClaw(曾用名Clawd、Moltbot)以黑马之姿崛起——一周内GitHub Stars从7800飙升至12万+,成为历史上增长最快的开源项目之一。这款由PSPDFKit创始人Peter Steinberger打造的通用AI助手,打破了普通聊天机器人的功能局限,能真正执行系统控制、浏览器自动化、邮件管理等实用任务。但原版全英文界面对中文用户不够友好,第三方团队推出的汉化版完美解决这一痛点,实现命令行与网页控制台的全中文适配,让国内用户轻松上手。
本文将详细拆解OpenClaw汉化版的全平台安装流程,包括本地一键部署、Docker容器化部署、服务器远程访问等多种方案,所有代码命令可直接复制执行。同时新增阿里云快速部署步骤,兼顾新手入门与进阶用户需求,全程不改变原教程核心逻辑,不含无关平台信息,帮助不同场景的用户快速搭建属于自己的中文AI助手。
一、OpenClaw核心价值与汉化版优势
1. 不止于聊天的通用AI助手
OpenClaw区别于传统AI工具的核心在于其"任务执行能力",而非单纯的对话交互,核心功能覆盖六大场景:
| 能力类型 | 具体功能 |
|----------|----------|
| 系统控制 | 读写文件、运行脚本、执行终端命令 |
| 浏览器自动化 | 打开网页、填写表单、数据提取、页面截图 |
| 邮件管理 | 读取邮件、智能分类、起草编辑、一键发送 |
| 日程管理 | 查看日历、创建事件、设置多时段提醒 |
| 持久记忆 | 记录用户偏好、习惯,越用越懂用户需求 |
| 多渠道接入 | 支持WhatsApp、Telegram、Discord等主流通讯工具 |
举个实际场景:在Telegram发送"帮我查询明天从北京到上海的航班,并添加到日历",OpenClaw会自动打开浏览器查询航班信息,筛选符合条件的结果,并同步至你的日程表,全程无需手动操作。
2. 灵活的模型支持
OpenClaw不绑定特定AI模型,用户可根据需求自由选择,包括:
- 云端模型:Anthropic Claude(3.5 Sonnet、Opus 4.5)、OpenAI GPT(4、4o)、Google Gemini;
- 本地模型:通过Ollama运行Llama、Mistral等开源模型,无需API Key即可免费使用。
其中Claude系列模型与OpenClaw适配度最高,推荐优先使用。
3. 汉化版核心优势
原版OpenClaw的全英文界面给中文用户带来不小门槛,汉化版实现了两大核心界面的完整翻译,让操作更顺畅:
- CLI命令行界面:覆盖14个核心模块,包括启动横幅、帮助信息、初始化向导、安全警告、各类操作命令(status、update、skills等),所有终端输出均为中文;
- Dashboard网页控制台:翻译31个功能模块,涵盖顶栏导航、对话界面、渠道管理、技能配置、节点控制等,300+配置项全部中文标注,一目了然。
更重要的是,汉化版具备自动同步更新机制:每小时检测官方仓库更新,自动拉取代码、应用汉化规则并构建发布,延迟不超过1小时,确保中文用户能第一时间体验最新功能。
4. 与同类工具的核心区别
| 对比项 | OpenClaw | Claude Code | Cursor |
|---|---|---|---|
| 定位 | 通用AI助手 | 编程专用助手 | IDE+AI插件 |
| 运行方式 | 本地/Docker容器 | 终端CLI | 集成IDE界面 |
| 聊天渠道 | 多平台支持 | 仅终端内 | IDE内交互 |
| 系统控制 | 完整权限 | 仅代码相关 | 有限权限 |
| 浏览器控制 | 原生支持 | 不支持 | 不支持 |
| 持久记忆 | 支持 | 不支持 | 不支持 |
| 开源协议 | MIT | MIT | 不开源 |
二、环境准备与前置要求
不同安装方式对环境有不同要求,提前确认系统与依赖是否满足:
| 安装方式 | 环境要求 |
|---|---|
| 一键脚本/NPM安装 | Node.js 22.12.0及以上版本 |
| Docker部署 | Docker Engine(任意支持版本) |
| 阿里云部署 | 轻量应用服务器(2核2G以上配置) |
环境检查与依赖安装
检查Node.js版本:
node -v若显示v22.x.x及以上,说明已满足要求;若版本过低或未安装,前往nodejs.org下载最新LTS版本。
Docker环境检查(Docker部署需执行):
docker --version docker compose version若未安装Docker,执行以下命令快速安装(适用于Linux/macOS):
# 安装Docker curl -fsSL https://get.docker.com | sudo sh -s -- --mirror Aliyun # 启动Docker并设置开机自启 sudo systemctl start docker sudo systemctl enable docker
三、阿里云OpenClaw汉化版快速部署步骤(新手首选)
对于希望快速实现云端稳定运行的用户,阿里云轻量应用服务器提供便捷部署方案,无需复杂配置,10分钟即可完成:
- 账号与实名认证:注册阿里云账号,登录阿里云账号,完成实名认证(个人用户支持支付宝刷脸验证,即时生效),确保账号无欠费;
- 购买轻量应用服务器:访问阿里云轻量应用服务器购买页,选择适合的地域(推荐国内免备案或海外地域如新加坡),配置建议2核2G内存+40G ESSD(满足OpenClaw运行需求),购买时长按实际需求选择;
阿里云一键部署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对话页面。
- 配置Docker与镜像加速:登录服务器后,先安装Docker并配置阿里云镜像加速(提升镜像拉取速度):
```bash安装Docker
curl -fsSL https://get.docker.com | sudo sh -s -- --mirror Aliyun
sudo systemctl start docker
sudo systemctl enable docker
配置阿里云Docker镜像加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://你的加速地址.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
(注:加速地址需在阿里云容器镜像服务控制台获取,免费开通)
4. **一键部署OpenClaw汉化版**:
```bash
# 执行汉化版Docker一键部署脚本
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash
脚本会自动完成配置初始化、镜像拉取、容器启动等操作,无需手动干预。
配置远程访问:
# 设置网关绑定局域网(支持远程访问) 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 你的自定义密码 # 重启容器使配置生效 docker restart openclaw开放端口:进入阿里云服务器控制台,在「防火墙」配置中添加规则,放通18789端口(OpenClaw默认端口);
访问验证:打开本地浏览器,输入
http://服务器公网IP:18789,在登录页面输入设置的访问令牌,即可进入中文控制台,部署完成。
四、全平台安装教程(本地部署方案)
方案1:一键脚本安装(最简单,推荐新手)
适用于Linux、macOS、Windows(PowerShell)系统,一行命令完成全部安装:
Linux/macOS系统
# 执行一键安装脚本
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash
Windows系统(管理员身份运行PowerShell)
# 完整命令
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1"; .\install.ps1
# 或简写形式
irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1 | iex
安装后自动启动初始化向导,按以下步骤完成配置:
- 安全授权确认:阅读OpenClaw的权限说明(需访问文件系统、执行脚本等),输入「Yes」确认继续;
- 选择配置模式:新手推荐「QuickStart」(默认安全配置,快速上手),熟悉后可切换「Advanced」自定义配置;
- 配置AI模型:选择模型提供商(如Anthropic、OpenAI),输入API Key(本地模型无需填写);
- 设置聊天渠道:选择常用的通讯工具(Telegram、Discord等),按提示填入对应Token或扫码登录;
- 创建AI人格:自定义AI助手的名称、性格(如"严谨的工作助手"、"活泼的生活伙伴"),完成初始化。
初始化完成后,终端会显示启动成功提示,直接在聊天渠道或访问http://localhost:18789即可使用。
方案2:NPM安装(适合开发者)
熟悉Node.js的用户可通过NPM手动安装,灵活控制版本:
# 安装稳定版(推荐)
npm install -g @qingchencloud/openclaw-zh@latest
# 如需体验最新功能,安装 nightly 版(每小时更新)
# npm install -g @qingchencloud/openclaw-zh@nightly
# 启动初始化向导
openclaw onboard
# 启动OpenClaw主程序
openclaw
# 如需后台运行(Linux/macOS)
openclaw onboard --install-daemon
方案3:Docker手动部署(适合需要隔离环境的用户)
3.1 本地访问部署(仅本机使用)
# 1. 初始化配置(首次运行必须)
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
# 2. 设置网关模式为本地
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local
# 3. 启动容器
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
3.2 服务器远程访问部署
# 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
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan
# 4. 设置访问令牌(自定义密码)
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的密码
# 5. 启动容器
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://服务器IP:18789
3.3 Docker Compose部署(推荐生产环境)
# 1. 下载配置文件
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-compose.yml -o docker-compose.yml
# 2. 编辑配置文件(修改访问令牌)
# 打开docker-compose.yml,将OPENCLAW_GATEWAY_TOKEN的值改为自定义密码
# 3. 初始化配置(首次运行必须)
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.bind lan
# 4. 启动服务
docker compose up -d
# 停止服务命令:docker compose down
五、中文控制台(Dashboard)使用指南
启动OpenClaw后,访问http://localhost:18789(本地部署)或http://服务器IP:18789(远程部署),即可进入全中文控制台,核心功能分区如下:
| 页面名称 | 核心功能 |
|---|---|
| 概览 | 查看系统状态、运行时间、活跃会话、网关连接信息 |
| 对话 | 直接与AI助手聊天交互,支持发送图片、执行命令 |
| 会话 | 查看所有历史会话记录,支持搜索、删除、恢复会话 |
| 渠道 | 管理Telegram、Discord等聊天渠道的连接状态,配置新渠道 |
| 技能 | 浏览安装565+社区技能扩展,如Notion集成、GitHub管理、PDF编辑等 |
| 节点 | 管理本地或远程执行节点,配置节点绑定规则 |
| 配置 | 31个配置分区,自定义AI模型、权限控制、通知设置等300+参数 |
| 日志 | 查看系统运行日志,排查故障问题 |
| 调试 | 提供快照、手动RPC、事件日志等高级调试工具 |
技能安装示例(以Notion集成为例)
- 进入「技能」页面,在搜索框输入"Notion";
- 找到「Notion Connector」技能,点击「安装」;
- 安装完成后,进入「配置」页面,找到Notion相关设置,填入API Key;
- 完成配置后,即可通过指令让OpenClaw自动操作Notion(如"创建新数据库"、"添加页面内容")。
六、常见问题排查(90%问题可解决)
问题1:安装后运行仍是英文界面
- 原因:系统中同时存在原版OpenClaw与汉化版,优先级冲突;
- 解决方案:先卸载原版,重新安装汉化版:
npm uninstall -g openclaw npm install -g @qingchencloud/openclaw-zh@latest
问题2:Docker容器一直重启,无法稳定运行
- 原因:未执行初始化配置,容器缺少必要参数;
- 解决方案:查看日志定位问题,重新执行初始化:
```bash查看容器日志
docker logs openclaw
重新初始化配置
docker stop openclaw && docker rm openclaw
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
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
### 问题3:远程访问无法连接控制台
- 原因:防火墙未开放端口、网关未绑定局域网、未设置访问令牌;
- 解决方案:
1. 开放18789端口(以Linux为例):
```bash
# Ubuntu/Debian
sudo ufw allow 18789
# CentOS/RHEL
sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload
- 确认网关绑定设置:
docker exec openclaw openclaw config get gateway.bind # 应显示lan,否则执行: docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan - 确认访问令牌已设置:
docker exec openclaw openclaw config get gateway.auth.token
问题4:控制台显示"pairing required"(需要配对)
- 原因:OpenClaw的安全机制,新浏览器首次连接需管理员批准;
- 解决方案:
```bash1. 查看待配对设备(替换为你的网关密码)
docker exec openclaw openclaw devices list --password '你的密码'
2. 复制Pending状态的Request ID,执行批准命令
docker exec openclaw openclaw devices approve
执行后刷新浏览器,即可完成配对连接。
### 问题5:Docker拉取镜像时提示"denied: permission denied"
- 原因:镜像仓库认证失败或缓存问题;
- 解决方案:
```bash
docker logout ghcr.io
docker pull ghcr.io/1186258278/openclaw-zh:nightly
问题6:NPM安装后,内网其他电脑无法访问
- 原因:默认网关仅监听本机(127.0.0.1);
- 解决方案:配置网关绑定局域网并设置访问令牌:
openclaw config set gateway.bind lan openclaw config set gateway.auth.token '你的密码' openclaw gateway restart
七、常用命令速查
CLI核心命令
| 命令 | 功能描述 |
|---|---|
openclaw |
启动OpenClaw主程序 |
openclaw onboard |
启动初始化配置向导 |
openclaw onboard --install-daemon |
安装后台守护进程(开机自启) |
openclaw config |
查看当前配置 |
openclaw config set <key> <value> |
修改配置参数(如绑定地址、令牌等) |
openclaw skills |
管理技能扩展(安装、卸载、查看) |
openclaw status |
查看系统运行状态 |
openclaw update |
更新OpenClaw到最新版本 |
openclaw doctor |
诊断系统问题,生成排查报告 |
openclaw --help |
查看所有命令帮助信息 |
Docker操作命令
| 命令 | 功能描述 |
|---|---|
docker logs -f openclaw |
实时查看容器运行日志 |
docker exec -it openclaw sh |
进入容器终端 |
docker exec openclaw openclaw config |
查看容器内OpenClaw配置 |
docker restart openclaw |
重启容器 |
docker stop openclaw && docker rm openclaw |
停止并删除容器 |
docker compose up -d |
启动Docker Compose服务 |
docker compose down |
停止Docker Compose服务 |
八、总结:核心要点与使用建议
OpenClaw汉化版的推出,让中文用户无需再面对语言门槛,轻松享受这款强大AI助手的核心能力。无论是本地部署满足个人使用,还是阿里云部署实现团队共享,都能通过本文的步骤快速实现。
核心要点回顾
- 环境匹配:根据安装方式确认Node.js或Docker环境,阿里云部署需配置镜像加速提升效率;
- 安全优先:远程访问必须设置访问令牌,定期更换密码,避免未授权访问;
- 配置关键:远程部署需完成"绑定局域网+开放端口+设置令牌"三大步骤,缺一不可;
- 技能扩展:通过控制台「技能」页面安装扩展,可大幅提升OpenClaw的功能覆盖范围。
新手使用建议
- 首次安装推荐选择「一键脚本」或「阿里云快速部署」,降低配置难度;
- 模型选择:优先使用Claude 3.5 Sonnet,兼顾响应速度与功能完整性,本地用户可尝试Ollama+Llama 3;
- 渠道配置:新手先配置Telegram或Discord,操作简单易上手,后续再拓展其他渠道;
- 问题排查:遇到故障先查看日志(终端输出或Docker日志),多数问题可通过常见问题清单解决;
- 版本更新:定期执行
openclaw update(本地部署)或docker pull ghcr.io/1186258278/openclaw-zh:nightly(Docker部署),获取最新功能与bug修复。
OpenClaw的潜力远不止于现有功能,通过社区不断丰富的技能扩展,它可以适配更多个性化场景——无论是工作中的文档处理、代码开发,还是生活中的日程管理、信息查询,都能成为你的得力助手。如果你在使用过程中发现新的创意用法,不妨在社区分享,让更多用户受益。