从零开始：OpenClaw汉化版v2026.4.1-zh.3 详细安装指南-酒店常州论坛

适用版本：OpenClaw中文汉化版 v2026.4.1-zh.3（2026年4月最新稳定版）
支持系统：Ubuntu 22.04+/Debian 11+/macOS 14+/Windows 10/11（WSL2推荐）
核心优势：100%全中文界面、国内网络优化、兼容所有官方技能、开箱即用

一、安装前必做准备（90%的失败都在这里）

1. 系统与硬件要求

使用场景	最低配置	推荐配置
基础聊天+文档处理	2核4G内存+20G硬盘	4核8G内存+50G硬盘
代码开发+复杂任务	4核8G内存+50G硬盘	8核16G内存+100G硬盘
运行Ollama本地模型	8核16G+6G显存	16核32G+12G显存

2. 国内用户专属准备（必须做）

临时关闭杀毒软件：360、电脑管家、火绒、Windows Defender等，避免误删安装文件和拦截脚本，安装完成后再开启
确保所有路径全英文：不要用中文、空格、特殊字符作为安装路径，比如D:\OpenClaw可以，D:\软件\小龙虾绝对不行

配置国内npm镜像：提前配置淘宝镜像，解决下载慢、安装失败问题

# Linux/macOS/WSLnpmconfigsetregistry https://registry.npmmirror.comnpmconfigsetdisturl https://npmmirror.com/dist# Windows PowerShell（管理员身份）npmconfigsetregistry https://registry.npmmirror.comnpmconfigsetdisturl https://npmmirror.com/dist

3. 基础依赖安装

Ubuntu/Debian/WSL

sudoaptupdate&&sudoaptupgrade-ysudoaptinstall-ycurlgitwgetbuild-essential ca-certificates

macOS

# 先安装Homebrew（如果未安装）/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 安装基础依赖brewinstallcurlgit

Windows

推荐使用WSL2 + Ubuntu 22.04，体验和Linux完全一致，避免Windows特有的路径和权限问题
纯Windows用户需要先安装Node.js 24.x LTS：https://nodejs.org/zh-cn/download/

二、三种安装方式（按需选择）

方式一：国内镜像一键脚本（新手首选，100%成功率）

这是最简单、最稳定的安装方式，专门针对国内网络优化，自动解决所有环境和依赖问题，全程复制粘贴即可。

Linux/macOS/WSL

# 国内镜像一键安装（推荐）curl-fsSLhttps://openclaw.cn/scripts/install.sh|bash

Windows PowerShell（管理员身份）

# 先解锁执行权限（仅第一次需要）Set-ExecutionPolicyRemoteSigned-Scope CurrentUser-Force# 国内镜像一键安装iwr-useb https://openclaw.cn/scripts/install.ps1|iex

脚本自动完成的操作

检测系统环境和依赖
自动安装Node.js 24.x LTS（如果未安装）
配置国内npm和Docker镜像
全局安装OpenClaw中文汉化版
创建配置目录和工作区
自动打开初始化配置向导

验证安装

安装完成后，在终端输入以下命令，显示版本号即成功：

openclaw-cn--version# 输出：v2026.4.1-zh.3

方式二：Docker Compose部署（服务器推荐）

适合在云服务器上长期运行，隔离性好，易于管理和升级。

步骤1：创建部署目录

mkdir-p/opt/openclaw-cncd/opt/openclaw-cn

步骤2：创建docker-compose.yml

version:'3.8'services:openclaw:image:1186258278/openclaw-zh:latestcontainer_name:openclaw-cnrestart:unless-stoppedports:# 只绑定本地地址，不要直接暴露到公网！-"127.0.0.1:18789:18789"volumes:# 数据持久化：所有配置、技能、记忆都存在这里-openclaw-data:/root/.openclaw# 挂载你的工作目录，让AI可以访问你的文件-./workspace:/root/workspaceenvironment:-TZ=Asia/Shanghai-NODE_ENV=production# 默认中文界面，无需额外配置-OPENCLAW_LANGUAGE=zh-CNhealthcheck:test:["CMD","openclaw-cn","gateway","status"]interval:30stimeout:10sretries:3start_period:60svolumes:openclaw-data:name:openclaw-data

步骤3：初始化配置

dockercompose run--rmopenclaw openclaw-cn onboard

步骤4：启动服务

dockercompose up-d# 查看服务状态dockercomposeps

当看到容器状态显示为Up (healthy)时，说明服务启动成功。

方式三：NPM手动安装（开发者首选）

适合需要自定义修改代码或汉化内容的用户。

步骤1：安装Node.js 24.x

# Ubuntu/Debian/WSLcurl-fsSLhttps://deb.nodesource.com/setup_24.x|sudo-Ebash-sudoaptinstall-ynodejs# 验证版本node-v# 输出v24.x.xnpm-v# 输出10.x.x

步骤2：全局安装汉化版

npminstall-g@qingchencloud/openclaw-zh@latest

步骤3：安装系统守护进程

openclaw-cn onboard --install-daemon

三、初始化配置向导（一步步跟着走）

安装完成后，会自动打开交互式配置向导，按照以下步骤操作即可：

1. 接受用户协议

? 我已阅读并同意OpenClaw用户协议和隐私政策 (Y/n) 输入 Y 回车

2. 设置管理员密码

? 设置管理员密码（用于登录Web控制台）： 输入你的密码，回车确认

重要：密码至少8位，包含字母和数字，不要使用简单密码。

3. 配置大模型（最关键的一步）

OpenClaw本身不包含大模型，需要接入第三方大模型API。以下是最常用的三种选择：

选项A：接入豆包4.5（国内推荐，性价比最高）

访问豆包开放平台：https://console.volcengine.com/ark/
注册账号并创建API Key
在向导中选择「字节跳动豆包」
输入你的API Key
选择默认模型：doubao-4.5-pro

选项B：接入通义千问3.5

访问阿里百炼平台：https://bailian.aliyun.com/
注册账号并创建API Key
在向导中选择「阿里云通义千问」
输入你的API Key
选择默认模型：qwen3.5-72b-instruct

选项C：接入Ollama本地模型（完全离线）

先安装Ollama：https://ollama.com/
下载模型：ollama pull qwen2.5:7b
在向导中选择「Ollama本地模型」
输入Ollama地址：http://localhost:11434
选择默认模型：qwen2.5:7b

4. 配置聊天平台（可选）

? 现在要配置哪些聊天平台？ [ ] 微信 [ ] 钉钉 [ ] 飞书 [ ] Telegram [ ] 稍后配置（推荐）

新手建议先选「稍后配置」，等熟悉基本使用后再添加聊天平台。

5. 安装系统服务

? 将OpenClaw安装为开机自启的系统服务？ (Y/n) 输入 Y 回车（强烈推荐）

这样电脑重启后，OpenClaw会自动启动，不需要手动运行。

6. 配置国内技能镜像（国内用户必须做）

初始化完成后，执行以下命令配置国内技能市场镜像，解决技能安装慢、失败的问题：

openclaw-cn configsetskillRegistry https://openclaw.cn/skills

四、验证安装是否成功

1. 检查服务状态

openclaw-cn status

输出以下内容说明服务正常运行：

✅ OpenClaw Gateway is running on http://localhost:18789 ✅ 大模型连接正常 ✅ 系统服务已启用，开机自启

2. 访问Web控制台

打开浏览器，访问：

http://localhost:18789

输入你设置的管理员密码，即可登录全中文的OpenClaw控制台。

3. 测试基本功能

在聊天框中输入以下命令，测试AI是否正常工作：

你好，介绍一下你自己

如果AI正常回复中文，说明大模型配置成功。

再输入：

列出当前工作区的所有文件

如果AI能正确列出./workspace目录下的文件，说明文件系统访问正常。

五、新手必做的5个配置

1. 确认中文界面

默认已经是中文界面，如果界面还是英文，执行以下命令：

openclaw-cn configsetlanguage zh-CN openclaw-cn restart

然后清除浏览器缓存，刷新页面即可。

2. 添加文件访问白名单

默认只允许访问./workspace目录，如果你需要AI访问其他目录，添加到白名单：

# 添加你的项目目录openclaw-cn directoryadd~/projects# 添加文档目录openclaw-cn directoryadd~/Documents# 查看已允许的目录openclaw-cn directory list

3. 安装必装核心技能

# 一键安装精选100个常用技能curl-fsSLhttps://openclaw.cn/scripts/install-top-100-skills.sh|bash# 单独安装5个核心技能openclaw-cn skillsinstallcode-simplifier openclaw-cn skillsinstallralph-loop openclaw-cn skillsinstallgit-tools openclaw-cn skillsinstallemail-assistant openclaw-cn skillsinstallweb-browser

4. 安装VS Code插件

打开VS Code，点击左侧「扩展」
搜索「OpenClaw Chinese」，安装官方插件
插件会自动连接本地OpenClaw服务
现在你可以在VS Code里直接使用所有OpenClaw功能

5. 设置自动备份

创建自动备份脚本，每天凌晨2点自动备份所有数据：

# 创建备份脚本sudonano/usr/local/bin/openclaw-backup.sh

写入以下内容：

#!/bin/bashBACKUP_DIR="/backup/openclaw"DATE=$(date+%Y%m%d)mkdir-p$BACKUP_DIR# 备份所有数据tarczf$BACKUP_DIR/openclaw-backup-$DATE.tar.gz ~/.openclaw# 删除7天前的备份find$BACKUP_DIR-name"openclaw-backup-*.tar.gz"-mtime+7-delete

添加执行权限并配置定时任务：

sudochmod+x /usr/local/bin/openclaw-backup.sh# 添加到crontabcrontab-e# 添加以下内容02* * * /usr/local/bin/openclaw-backup.sh

六、常见问题排查手册

1. 安装失败提示网络错误

解决方案：重新配置国内npm镜像，然后重新运行安装脚本
检查网络是否能正常访问registry.npmmirror.com

2. 服务启动失败提示端口被占用

# 查找占用18789端口的进程lsof-i:18789# 结束进程kill-9进程ID# 或者修改默认端口openclaw-cn configsetport18790openclaw-cn restart

3. 汉化不生效，界面还是英文

确认执行了openclaw-cn config set language zh-CN
清除浏览器缓存，按Ctrl+Shift+R强制刷新
重启OpenClaw服务：openclaw-cn restart

4. AI不回复，一直转圈

检查API Key是否正确，是否有余额
测试网络是否能访问大模型API
查看日志排查错误：openclaw-cn logs --follow

5. 技能安装失败

确认配置了国内技能镜像：openclaw-cn config get skillRegistry

如果还是失败，手动克隆技能仓库：

gitclone https://ghproxy.com/https://github.com/xxx/skill-name.git ~/.openclaw/skills/skill-name openclaw-cn restart

6. 无法访问本地文件

检查文件是否在白名单中：openclaw-cn directory list
添加文件所在目录到白名单
重启OpenClaw服务

七、升级与卸载

升级到最新版本

# 一键脚本/NPM安装方式openclaw-cn update# Docker安装方式cd/opt/openclaw-cndockercompose pulldockercompose up-d

完全卸载

# 停止服务openclaw-cn stop# 卸载系统服务openclaw-cn onboard --uninstall-daemon# 卸载软件包npmuninstall-g@qingchencloud/openclaw-zh# 删除所有数据（谨慎操作）rm-rf~/.openclaw

总结

按照本文的步骤，你可以搭建好一个完整的、全中文界面的OpenClaw私有化AI助手。它不仅能帮你写代码、调试bug、处理文档，还能接入微信、钉钉、飞书等平台，成为你24小时待命的数字同事。

如果遇到本文未覆盖的问题，可以访问OpenClaw中文社区 https://openclaw.cn 寻求帮助，或者运行万能诊断命令自动修复：

openclaw-cn doctor--fix

企业官网建设流程全解析