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 --version
v24.14.1
PS 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”): Y
PS C:\Windows\system32>

配置node国内源

# 设置淘宝源
PS C:\Windows\system32> npm config set registry https://registry.npmmirror.com
PS 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      # 打开浏览器 UI
openclaw logs           # 查看日志

3 卸载

openclaw uninstall

非交互式（自动化 / npx）：

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

关于我
全网可搜《阿贤Linux》
CSDN、知乎、哔哩哔哩、博客园、51CTO、掘金、思否、阿里云、腾讯云、华为云、今日头条、百家号、GitHub、个人博客
公众号：阿贤Linux
个人博客：blog.waluna.top

原文链接: [openclaw本地部署教程超详细](https:// blog.waluna.top/2026/03/31/1518/).