OpenClaw 安装教程（优化版）

什么是 OpenClaw？

简单说，这就是你电脑上的 AI 小秘书。

它能帮你处理邮件、安排日程、管理文件，还能通过微信、飞书和你聊天干活。

不用复杂操作，说句话就能办事，真正实现 "聊天即操作"。

准备工作：3 分钟搞定环境

电脑要求

Windows 要 Win10 以上，Mac 要 macOS10.15 以上，Linux 用主流发行版就行。

最重要的是 Node.js 版本必须是 22 以上，不然装不上。

网络准备

需要稳定的网络，毕竟要下载安装包。

建议先设置国内镜像源，下载速度会快很多：

npm config set registry https://registry.npmmirror.com

三种安装方式，总有一款适合你

官方一键安装（推荐新手）

这是最简单的方法，一条命令搞定所有。

Windows 用户 先关闭杀毒软件，以管理员身份打开 PowerShell，输入：

iwr -useb https://openclaw.ai/install.ps1 | iex

Mac/Linux 用户 打开终端，直接输入：

curl -fsSL https://openclaw.ai/install.sh | bash

等待 5 分钟左右，安装就完成了。

WSL 安装（Windows 用户首选）

如果你用 Windows，强烈推荐用 WSL 方式，更稳定。

先启用 WSL：

wsl --install

重启电脑后，在 Microsoft Store 安装 Ubuntu。

打开 Ubuntu 终端，输入同样的安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash

npm 安装（适合有技术基础的）

如果你已经装了 Node.js，可以用 npm 安装。

先确保 Node.js 版本是 22 以上：

node -v

然后全局安装：

npm install -g openclaw@latest

中文版设置：3 步变中文界面

官方原生中文（推荐）

2026 年 3 月起，OpenClaw 官方已经支持中文了。

安装完成后，打开 Web 控制台：

openclaw dashboard

在设置页面找到语言选项，选择 "简体中文"，刷新页面就生效了。

社区汉化版（更完整的中文）

如果觉得官方中文不够完整，可以用社区汉化版。

先卸载原版：

npm uninstall -g openclaw

安装汉化版：

npm install -g @qingchencloud/openclaw-zh@latest

验证一下，版本号后面会有 - zh 后缀：

openclaw --version

初始化配置：跟着向导走就行

安装完成后，运行初始化命令：

openclaw onboard --install-daemon

配置要点

选择语言时选中文，模型推荐用国内的 Qwen 或 GLM。

API 密钥需要自己去对应平台申请，新手可以先跳过通道配置。

技能配置选 "否"，后面需要再装也不迟。

验证安装：确保一切正常

检查版本

openclaw -v

能显示版本号就说明安装成功了。

系统诊断

openclaw doctor

显示 "没有发现问题" 就放心用。

打开控制台

openclaw dashboard

浏览器会自动打开，能看到界面就没问题。

常见问题：新手必看避坑指南

安装失败怎么办？

权限不够 Windows 要以管理员身份运行 PowerShell，Mac/Linux 在命令前加 sudo。

网络连不上 检查网络连接，或者换个网络环境试试。

Node.js 版本太低 必须升级到 22 以上，推荐用 nvm 管理版本。

启动失败怎么解决？

端口被占用 换个端口启动：openclaw start --port 3001

服务没装对 重新运行初始化向导：openclaw onboard --install-daemon

中文相关问题

界面还是英文 确保版本是 2026.3.1 以上，清除浏览器缓存再刷新。

中文乱码 Windows 用户设置 UTF-8 编码：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

卸载方法：不想用了怎么删

Windows

npm uninstall -g openclaw
Remove-Item -Path $HOME\.openclaw -Recurse -Force

Mac/Linux

npm uninstall -g openclaw
rm -rf ~/.openclaw

写在最后

OpenClaw 是个很实用的 AI 工具，安装其实很简单。

跟着教程一步步来，5 分钟就能搞定。

如果遇到问题，多试试教程里的解决方法，总能搞定的。