从零开始：OpenClaw汉化版v2026.4.1-zh.3 详细安装指南

适用版本OpenClaw中文汉化版 v2026.4.1-zh.32026年4月最新稳定版支持系统Ubuntu 22.04/Debian 11/macOS 14/Windows 10/11WSL2推荐核心优势100%全中文界面、国内网络优化、兼容所有官方技能、开箱即用一、安装前必做准备90%的失败都在这里1. 系统与硬件要求使用场景最低配置推荐配置基础聊天文档处理2核4G内存20G硬盘4核8G内存50G硬盘代码开发复杂任务4核8G内存50G硬盘8核16G内存100G硬盘运行Ollama本地模型8核16G6G显存16核32G12G显存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/dist3. 基础依赖安装Ubuntu/Debian/WSLsudoaptupdatesudoaptupgrade-ysudoaptinstall-ycurlgitwgetbuild-essential ca-certificatesmacOS# 先安装Homebrew如果未安装/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装基础依赖brewinstallcurlgitWindows推荐使用WSL2 Ubuntu 22.04体验和Linux完全一致避免Windows特有的路径和权限问题纯Windows用户需要先安装Node.js 24.x LTShttps://nodejs.org/zh-cn/download/二、三种安装方式按需选择方式一国内镜像一键脚本新手首选100%成功率这是最简单、最稳定的安装方式专门针对国内网络优化自动解决所有环境和依赖问题全程复制粘贴即可。Linux/macOS/WSL# 国内镜像一键安装推荐curl-fsSLhttps://openclaw.cn/scripts/install.sh|bashWindows 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.ymlversion:3.8services:openclaw:image:1186258278/openclaw-zh:latestcontainer_name:openclaw-cnrestart:unless-stoppedports:# 只绑定本地地址不要直接暴露到公网-127.0.0.1:18789:18789volumes:# 数据持久化所有配置、技能、记忆都存在这里-openclaw-data:/root/.openclaw# 挂载你的工作目录让AI可以访问你的文件-./workspace:/root/workspaceenvironment:-TZAsia/Shanghai-NODE_ENVproduction# 默认中文界面无需额外配置-OPENCLAW_LANGUAGEzh-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-gqingchencloud/openclaw-zhlatest步骤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本地模型完全离线先安装Ollamahttps://ollama.com/下载模型ollama pull qwen2.5:7b在向导中选择「Ollama本地模型」输入Ollama地址http://localhost:11434选择默认模型qwen2.5:7b4. 配置聊天平台可选? 现在要配置哪些聊天平台 [ ] 微信 [ ] 钉钉 [ ] 飞书 [ ] 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 list3. 安装必装核心技能# 一键安装精选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-browser4. 安装VS Code插件打开VS Code点击左侧「扩展」搜索「OpenClaw Chinese」安装官方插件插件会自动连接本地OpenClaw服务现在你可以在VS Code里直接使用所有OpenClaw功能5. 设置自动备份创建自动备份脚本每天凌晨2点自动备份所有数据# 创建备份脚本sudonano/usr/local/bin/openclaw-backup.sh写入以下内容#!/bin/bashBACKUP_DIR/backup/openclawDATE$(date%Y%m%d)mkdir-p$BACKUP_DIR# 备份所有数据tarczf$BACKUP_DIR/openclaw-backup-$DATE.tar.gz ~/.openclaw# 删除7天前的备份find$BACKUP_DIR-nameopenclaw-backup-*.tar.gz-mtime7-delete添加执行权限并配置定时任务sudochmodx /usr/local/bin/openclaw-backup.sh# 添加到crontabcrontab-e# 添加以下内容02* * * /usr/local/bin/openclaw-backup.sh六、常见问题排查手册1. 安装失败提示网络错误解决方案重新配置国内npm镜像然后重新运行安装脚本检查网络是否能正常访问registry.npmmirror.com2. 服务启动失败提示端口被占用# 查找占用18789端口的进程lsof-i:18789# 结束进程kill-9进程ID# 或者修改默认端口openclaw-cn configsetport18790openclaw-cn restart3. 汉化不生效界面还是英文确认执行了openclaw-cn config set language zh-CN清除浏览器缓存按CtrlShiftR强制刷新重启OpenClaw服务openclaw-cn restart4. AI不回复一直转圈检查API Key是否正确是否有余额测试网络是否能访问大模型API查看日志排查错误openclaw-cn logs --follow5. 技能安装失败确认配置了国内技能镜像openclaw-cn config get skillRegistry如果还是失败手动克隆技能仓库gitclone https://ghproxy.com/https://github.com/xxx/skill-name.git ~/.openclaw/skills/skill-name openclaw-cn restart6. 无法访问本地文件检查文件是否在白名单中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-gqingchencloud/openclaw-zh# 删除所有数据谨慎操作rm-rf~/.openclaw总结按照本文的步骤你可以搭建好一个完整的、全中文界面的OpenClaw私有化AI助手。它不仅能帮你写代码、调试bug、处理文档还能接入微信、钉钉、飞书等平台成为你24小时待命的数字同事。如果遇到本文未覆盖的问题可以访问OpenClaw中文社区 https://openclaw.cn 寻求帮助或者运行万能诊断命令自动修复openclaw-cn doctor--fix