位置：AI门户网
> AI应用 > AI智能体 > OpenClaw安装命令全解析：新手小白也能轻松上手
在急匆匆地复制粘贴命令之前，咱们得先确保“战场”准备就绪。这就好比做饭，你得先检查下煤气灶和锅碗瓢盆齐不齐。对于OpenClaw来说，这个“战场”就是你的电脑环境。
首先，操作系统。Windows 10或11、macOS，或者Linux系统，基本上主流系统都支持。如果你是Windows用户，有个小建议，使用WSL2（Windows的Linux子系统）来安装，可能会更顺畅一些，能避开一些权限上的小麻烦。
其次，也是最关键的一环，就是Node.js。你可以把它理解成OpenClaw这个“软件”运行所需要的基础语言环境。它的版本必须不低于v22.0.0。怎么检查呢？很简单，打开你的命令行工具（Windows叫PowerShell或CMD，Mac叫终端），输入 `node -v` 然后回车。如果蹦出来一个版本号，而且数字大于等于22，那恭喜你，这一步就过了。如果没反应或者版本太低，那就得先安装或升级它。
这里有个好消息是，很多安装脚本其实会自动帮你检测和安装Node.js，所以你甚至可以暂时跳过手动安装这一步。不过，为了保险起见，知道怎么检查总没错。
最后，确保你的网络连接稳定，毕竟安装过程需要从网上下载不少东西。如果遇到下载特别慢的情况，咱们后面也有办法解决。
对于绝大多数Windows用户来说，最省心、官方也最推荐的方法，就是使用那个“一键安装脚本”。这个脚本就像个全自动安装管家，你只要给它开个门（用管理员权限），它就会帮你把该准备的都准备好。
具体的操作步骤，咱们一步一步来：
1.以管理员身份打开PowerShell。这步很重要！不然脚本可能因为权限不够而“罢工”。你可以按键盘上的 `Win + X` 键，然后在弹出的菜单里选择“Windows PowerShell（管理员）”。看到一个蓝色或黑色的窗口弹出来，就对了。
2.复制并执行“魔法命令”。在这个管理员窗口里，粘贴下面这行命令，然后按回车：
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
这条命令的意思是：从OpenClaw官网下载安装脚本，并立即执行。执行后，你会看到屏幕上开始滚动各种文字，它在自动检查环境、安装依赖。这时候，你要做的就是保持耐心，等待它完成，中间可能会提示你输入“Y”确认，照做就行。
3.验证安装是否成功。当滚动停止，命令行回到可以输入的状态时，输入：
```powershell
openclaw --version
```
如果屏幕上显示出版本号，比如“openclaw/2026.3.x”，那就说明核心安装已经大功告成了！
这里我必须插一句个人观点：对于新手，我强烈建议你就用上面这个官方的一键脚本。网上可能有很多不同的安装方法，比如通过npm直接安装（`npm install -g openclaw@latest`），但对于不常接触命令行的朋友来说，一键脚本的自动化程度最高，能帮你避开很多坑。所谓“大道至简”，有时候最直接的方法就是最好的。
当然，安装过程很少有一帆风顺的，尤其是咱们的电脑环境千差万别。下面这些常见问题，如果你碰到了，别紧张，按方抓药就能解决。
*问题一：脚本不让运行？有时候在PowerShell里执行命令，它会提示“无法加载脚本，因为在此系统上禁止运行脚本”。这是因为系统的安全策略限制。解决起来很简单，还是在那个管理员PowerShell里，先执行这条命令：
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
输入“Y”确认，然后再去运行那个一键安装命令就行了。
*问题二：下载慢或卡住？这多半是网络问题。可以尝试切换npm的下载源到国内的镜像，速度会快很多。在执行安装命令前，可以先执行：
```powershell
npm config set registry https://registry.npmmirror.com
```
然后再通过 `npm install -g openclaw@latest` 这种方式安装。
*问题三：命令找不到（command not found）？安装完成后，输入 `openclaw` 开头的命令却提示找不到，这通常是环境变量没生效。最有效的办法是：完全关闭你的PowerShell或终端窗口，重新打开一个再试。如果还不行，可能需要手动将Node.js的安装路径添加到系统的环境变量Path中。
*问题四：端口被占用了？OpenClaw默认会使用18789这个端口来运行它的Web界面。如果这个端口已经被其他程序（比如你电脑上的某个软件）用了，就会启动失败。这时你可以换一个端口启动，比如：
```powershell
openclaw gateway --port 19001
```
之后访问界面就用 `http://localhost:19001` 。
看，这些问题其实都有明确的解决路径，所以千万别被一时的报错吓退。
安装成功，只是把“龙虾”请进了家门，接下来还得给它“安家”，告诉它怎么工作。这就需要运行初始化配置命令：
```powershell
openclaw onboard
```
这个命令会启动一个交互式的配置向导，一步步引导你完成最关键的几个设置。这个过程非常友好，就像填一个问卷：
1.选择AI模型：这是核心一步。OpenClaw本身是个框架，需要你给它接入一个“大脑”。向导会列出几个选项，比如：
*Claude Opus：公认的聪明，对话体验好，但价格也贵。
*OpenAI的GPT系列：能力均衡，如果你已经有账号，接入很方便。
*国产模型（如智谱GLM、Kimi、DeepSeek等）：性价比极高，访问速度快，对于国内用户是很好的选择。
你可以根据自己的需求和预算来选。我个人试用下来，觉得对于中文场景和日常办公，像智谱GLM-4.7这样的国产模型已经完全够用，而且响应速度很快。
2.输入API Key：选好模型后，你需要提供对应模型的API密钥。这个密钥相当于你使用那个AI模型的通行证，需要你去相应模型的官网申请。
3.选择通信渠道：你可以选择跳过，后续再配置。也可以选择接入像飞书、钉钉这样的办公软件，让OpenClaw变成你团队里的一个机器人助手。
4.完成并启动：跟着向导走完，它通常会帮你启动OpenClaw的服务。之后，你打开浏览器，访问 `http://localhost:18789`，就能看到OpenClaw的Web操作界面了，在这里你就可以和你的AI助手对话，或者管理它的各种技能。
安装配置好之后，你可能会想，怎么让它一直运行着？或者想重启一下怎么办？这里有几个非常实用的命令：
*启动服务：`openclaw gateway start`
*停止服务：`openclaw gateway stop`
*重启服务（修改配置后常用）：`openclaw gateway restart`
*查看服务状态：`openclaw gateway status` 或 `openclaw status`
*让它后台运行（关闭终端窗口也不退出）：`openclaw daemon start`
把这些命令记下来，或者收藏这篇文章，以后管理你的OpenClaw就游刃有余了。
说到底，安装OpenClaw，或者说学习任何新工具，都是一个不断试错和学习的过程。你可能一次成功，那当然最好；也可能遇到几个报错，这太正常了。重要的是，别把报错当成洪水猛兽，那只是电脑在用它的语言告诉你“这儿需要调整一下”。利用好搜索引擎，或者参考像本文这样汇总了常见问题的指南，大部分问题都能找到答案。
我的观点是，技术工具存在的意义是服务于人，而不是让人感到焦虑。OpenClaw强大的地方在于它能连接你的文件、日历、邮件，真正成为一个懂你的工作伙伴。而迈出使用它的第一步，就是搞定安装。希望这篇从头到尾、充满细节的指南，能像一位有耐心的朋友，手把手带你走过这段最初的路。当你最终在浏览器里看到那个简洁的界面，并开始和你的AI助手对话时，你会觉得，之前的所有折腾都是值得的。好了，话不多说，现在就去打开你的PowerShell，开始行动吧！
版权说明：
