openclaw本地部署教程
适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。
发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。
# 官方网址 https://openclaw.ai/ # 官方文档 https://docs.openclaw.ai/zh-CN/install
1 前置条件
建议在虚拟机安装！
windows安装有些注意事项，以下仅演示Windows安装步骤，linux安装类似。
windows需要先自行安装git和Node.js；linux会自动检测有没有git和node，没有会自动安装
1.1 安装git和nodejs
下载地址
# git 官方下载地址 https://git-scm.com/install/windows # Node.js 官方下载地址 https://nodejs.org/zh-cn/download
下载后自行安装即可，都是下一步傻瓜式安装，这里就不演示了。
推荐使用 Node 24（出于兼容性考虑，仍支持 Node 22 LTS，目前为
22.16+；如果缺失，安装脚本会安装 Node 24）
如果不确定，请使用 node --version 检查 Node 版本。PS C:\Windows\system32> node --versionv24.14.1PS C:\Windows\system32>
1.2 配置环境
由于 Windows 默认限制 PowerShell 脚本运行，在首次执行安装脚本前，必须修改执行策略，否则脚本将无法运行。
# 打开powershell管理员模式执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y确定PS C:\Windows\system32> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 执行策略更改 执行策略可帮助你防止执行不信任的脚本。更改执行策略可能会产生安全风险，如 https:/go.microsoft.com/fwlink/?LinkID=135170中的 about_Execution_Policies 帮助主题所述。是否要更改执行策略? [Y] 是(Y) [A] 全是(A) [N] 否(N) [L] 全否(L) [S] 暂停(S) [?] 帮助 (默认值为“N”): YPS C:\Windows\system32>
配置node国内源
# 设置淘宝源PS C:\Windows\system32> npm config set registry https://registry.npmmirror.comPS C:\Windows\system32>
2 安装 OpenClaw
官方一键安装脚本
macOS/Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex
打开powershell管理员模式执行上面命令，等待几分钟后弹出下面页面
每个版本略有区别，此版本为2026.3.28
选择Yes同意
选择快速安装QuickStart
选择大模型，这里选择跳过（Skip for now），后边再配置
选择第一项所有
设置默认模型，暂时选第一个，后边可以改
选择跳过（Skip for now）
选择跳过（Skip for now）
不配置skills
全部选择 按空格选中后回车
此时会弹出窗口显示gateway启动
选择打开webui（Open the Web UI）
安装完成，显示一些配置信息（保存好这里的token，方便后面使用）
同时会打开webui
2.1 配置模型
Xiaomi MiMo目前延长至2026年4月2日晚12点，可以先用着。
先注册openrouter
https://openrouter.ai/ 如果打不开可能需要魔法
生成获取你的API key
https://openrouter.ai/workspaces/default/keys
Name输入名称 后全部默认 点击 Create即可生成key
保存好创建的key，后边会用到
配置模型
openclaw config
默认本地访问
选择模型Model
选择OpenRouter
输入上面创建的key
选择模型openrouter/xiaomi/mimo-v2-pro，按空格选中，回车继续
此时gateway会自己重启，不用管
选择Continue退出
这样就配置完成了，更换模型也是一样的操作
webui测试
默认配置文件地址为C:\Users\用户名\.openclaw\openclaw.json
修改默认模型为openrouter/xiaomi/mimo-v2-pro，文件保存立即生效
"agents": {
"defaults": {
"model": {
"primary": "openrouter/xiaomi/mimo-v2-pro",常用命令
openclaw onboard # 完整设置向导openclaw configure # 配置向导openclaw gateway # Gateway 网关服务管理openclaw doctor # 检查配置问题openclaw status # 查看运行状态openclaw dashboard # 打开浏览器 UIopenclaw logs # 查看日志
3 卸载
openclaw uninstall
非交互式（自动化 / npx）：
openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactive