惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Scott Helme
Scott Helme
N
Netflix TechBlog - Medium
AI
AI
Security Latest
Security Latest
GbyAI
GbyAI
P
Proofpoint News Feed
Y
Y Combinator Blog
A
Arctic Wolf
G
Google Developers Blog
U
Unit 42
爱范儿
爱范儿
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
V
Vulnerabilities – Threatpost
Know Your Adversary
Know Your Adversary
Cisco Talos Blog
Cisco Talos Blog
T
Tor Project blog
C
CXSECURITY Database RSS Feed - CXSecurity.com
T
Threatpost
L
Lohrmann on Cybersecurity
C
CERT Recently Published Vulnerability Notes
C
Check Point Blog
B
Blog RSS Feed
The GitHub Blog
The GitHub Blog
Microsoft Azure Blog
Microsoft Azure Blog
博客园 - 【当耐特】
博客园 - Franky
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
C
Cisco Blogs
云风的 BLOG
云风的 BLOG
NISL@THU
NISL@THU
D
Darknet – Hacking Tools, Hacker News & Cyber Security
Microsoft Security Blog
Microsoft Security Blog
T
The Blog of Author Tim Ferriss
阮一峰的网络日志
阮一峰的网络日志
Latest news
Latest news
L
LINUX DO - 最新话题
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
美团技术团队
WordPress大学
WordPress大学
L
LangChain Blog
Stack Overflow Blog
Stack Overflow Blog
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
酷 壳 – CoolShell
酷 壳 – CoolShell
大猫的无限游戏
大猫的无限游戏
The Hacker News
The Hacker News
Simon Willison's Weblog
Simon Willison's Weblog
V
V2EX
Project Zero
Project Zero
博客园_首页

博客园 - 陈晓猛

验证网络ipv6的可用性 docker compose对应的内容,创建thread网络后连接设备 ONVIF协议与RTSP协议 OpenClaw:接入minimax-2.5的新手指引 使用zigbee2mqtt模拟发送信息 HA上配置MQTT esphome模拟IOT设备连接到HA ESPHome模拟设备脚本 自制hash_v1和hash_v2种子文件 接口 CDN(动态 CDN/API 网关 CDN)测试用例 cf-cache-status共有几种状态分别会在什么情况下产生 接口接入cdn和网页接入cdn的区别 pip安装依赖包报错内容为User defined options,Native files 如何解决 MCP:Trae中集成Playwright 实现网页自动化测试 测试用例设计检查项 如何给Playwright 添加 MCP(Microsoft Playwright Component Testing) npm 无法加载文件npm.ps1 文档收集地址 Ugreen记录验证不同国家码对应的跳转链接 error: command 'C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\bin\HostX86\x64\cl.exe' failed with exit code 2 解决方案 - 陈晓猛 VScode在顶部生成作者信息 Cursor使用小技巧(待更新) Trae 接入 Claude 3.7:AI 编程工具界的“卷王”,完全免费 提高研发效能——基于 DeepSeek-V3的本地化实践 大模型&ai学习课程一些笔记 P图训练模型 python3安装crypto出错及解决方法 windows搭建syncthing中继服务器和发现服务器
Windows 端 OpenClaw 安装教程(保姆级)
陈晓猛 · 2026-03-13 · via 博客园 - 陈晓猛

Windows 端 OpenClaw 安装教程(保姆级)

OpenClaw 是基于 Node.js 的 AI 助手框架,Windows 安装有一键脚本(新手首选)、npm 手动安装、WSL2 稳定部署三种方式,以下是详细步骤。

一、前置准备(所有方式通用)

1. 安装 Node.js(必须)

OpenClaw 依赖 Node.js v22+ LTS 版本:

  1. 访问 Node.js 中文官网,下载 Windows 64 位 .msi 安装包(推荐 LTS 22.x/24.x)。
  2. 双击安装包,全程默认下一步,务必勾选 Add to PATH 和 Automatically install necessary tools。
  3. 安装完成后,重启电脑,打开 PowerShell 验证:
    node --version  # 输出版本号(v22.x+)即成功
    npm --version   # 输出版本号即成功

2. 临时关闭安全软件

安装前关闭杀毒、防火墙、安全卫士,避免拦截脚本 / 依赖下载 


二、方式一:PowerShell 一键脚本(新手首选,最快)

步骤 1:以管理员身份打开 PowerShell

  1. 开始菜单搜索 PowerShell → 右键 → 以管理员身份运行
  2. 首次运行需修改执行策略(允许脚本运行):
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  3. 提示时输入 Y 并回车确认

步骤 2:执行一键安装脚本

  • 官方脚本(海外网络):

    powershell

    iwr -useb https://openclaw.ai/install.ps1 | iex 
  • 国内加速脚本(推荐,速度更快):

    powershell

    iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

步骤 3:等待安装完成

脚本会自动:检测 Node.js、安装 OpenClaw、配置环境变量、安装依赖,全程 3–8 分钟,不要关闭终端。

步骤 4:验证安装

openclaw --version  # 输出版本号即安装成功

步骤 5:初始化配置(首次必做)

openclaw onboard --install-daemon

按提示选择模型、设置端口、安装守护进程(开机自启)。

如果过程中有选项选择错误的话,可以点击ESC直接退出后再重新进行选择

选择选项可以用上下左右键再按下enter键选择答案,也可以直接用键盘打首字母进行选择

image

✅ 直接选择 Local gateway (this machine)

  • 这是个人使用 OpenClaw 的标准方式,会在你当前的电脑上完整部署并启动网关服务。
  • 操作:保持当前光标位置,按回车键确认即可。

image

 选择盘符的时候我这边选了 D盘

选择模型默认选择当前的 OpenAI 模型

image

 默认选择OpenAI Codex  

image

 

image

由于国内不支持openai

image

所以esc 重新走一遍前面的选项,可以选择kimi或者minimax

17ad0415913411dab07adfb434fcf439

image

注册minimax账号

📝 MiniMax API Key 完整获取步骤(国内版)

1. 注册 / 登录 MiniMax 平台

  1. 访问 MiniMax 官网:https://www.minimaxi.com/
  2. 点击右上角「登录 / 注册」,使用手机号完成注册(支持国内手机号)。
  3. 登录后,进入「控制台」页面。

image

image

image

选择对接的聊天工具,也可以直接不选择

  • 目标达成:你已经完成了核心的 MiniMax M2.5 (CN) 模型配置,这是 OpenClaw 的 “大脑”。
  • 工具非必选:Telegram、飞书等是外接聊天界面(让 AI 帮你在微信 / 飞书里回复),这是锦上添花的功能。
  • 最简方案:对于个人测试开发来说,浏览器的 Web 面板(http://localhost:18789) 就足够好用了,完全不需要配置第三方聊天软件。

image

image

选择 Finished

image

image

image

image

 是否要为 goplaces 插件配置 GOOGLE_PLACES_API_KEY,用于地点搜索、POI 查询等功能,选择NO

  1. 非核心功能:你当前的核心需求是接入 MiniMax 模型进行测试开发,地点搜索功能并非必需。
  2. 国内访问限制:Google Places API 在国内无法直接稳定访问,即使配置了 API Key 也很难正常使用。
  3. 后续可配置:和之前的工具插件一样,这个配置之后随时可以通过 openclaw configure 或编辑配置文件来添加,现在跳过完全不影响核心功能。

image

 询问是否为 nano-banana-pro 技能配置 GEMINI_API_KEY。

为什么选择 No?

  1. 非核心必装:你已经搭好 MiniMax M2.5,这是核心大脑,Google Gemini 只是额外的备选插件,现在不配置完全不影响你正常使用。
  2. 国内访问不便:Gemini 在国内网络环境下访问和连接不稳定,配置了密钥也很难稳定调用。
  3. 后续可补装:如果之后想换模型或者想多模型联动,随时可以通过 openclaw configure 命令重新配置,现在跳过毫无影响。

image

 Skip for now,最后一个环节(Hooks 自动化钩子配置),也是最不需要担心的一步

为什么选择这个?

  1. 完全无关核心:Hooks 是用来在你执行命令时自动触发后续动作的(比如保存对话记忆、添加文件),和你已经配置好的 MiniMax 模型 无关,不启用不会影响 AI 回答。
  2. 新手无需:对于刚部署完成的用户,先把核心功能跑稳最重要,复杂的自动化流程之后随时可以添加。
  3. 可随时开启:如果之后想体验 session-memory(会话记忆)等功能,之后用 openclaw configure 命令就能重新开启。

image

推荐选择:Node (recommended)

这是最后一步,选择网关服务的运行时环境

为什么选 Node?

  1. 官方推荐:界面里明确标注 (recommended),兼容性最好,也是你本地已经安装的环境。
  2. 稳定性保障:Bun 被提示 “可能在重连时损坏内存”,对于个人部署来说,Node 更稳定可靠。
  3. 适配需求:你没有配置 WhatsApp/Telegram 等聊天渠道,Node 完全能满足本地网关的运行需求。

🎉 部署 100% 完成!

所有配置流程到此结束,系统会自动保存配置并启动网关。

🌟 立即使用你的 OpenClaw

  1. 启动网关(如果未自动启动): 
  2. 访问管理面板:
    打开浏览器,访问:
    👉 http://localhost:18789

你现在已经拥有了一套完整的、接入 MiniMax M2.5 模型的 AI 网关,可以开始进行代码辅助、测试开发等工作了!

image

❌ 报错原因

提示 "Gateway service install failed: schtasks create failed" 是因为:
你当前的 PowerShell 没有管理员权限,无法创建系统计划任务(schtasks)来把网关设为开机自启服务,安装失败但核心功能不受影响。


2. 进入 API 密钥管理页面

  1. 在控制台左侧菜单栏,找到并点击 「API 密钥」(或「API Keys」)选项
  2. 首次使用会提示你完成实名认证(国内用户需实名认证后才能获取 API 调用权限)

3. 创建新的 API Key

  1. 点击「新建密钥」或「Create new secret key」。
  2. 给密钥起一个便于识别的名称(比如 openclaw-test)。
  3. 点击确认后,系统会生成一串以 sk- 开头的密钥字符串。
    ⚠️ 重要提示:这串密钥只会显示一次,请立即复制并妥善保存到安全位置(比如密码管理器),关闭页面后将无法再次查看。

4. 充值与额度管理

  1. 回到控制台,找到「余额」或「充值」入口。
  2. 选择适合的充值金额(支持支付宝 / 微信支付),完成充值。
  3. 可以在「用量统计」页面查看 Token 消耗和余额情况。

🔌 在 OpenClaw 中配置 MiniMax M2.5 (CN)

  1. 回到终端配置界面,选择 MiniMax M2.5 (CN) 后按回车。
  2. 当提示输入 API Key 时,粘贴你刚才复制的密钥字符串。
  3. 按回车确认,完成模型接入配置。

💡 关键注意事项

  • 不要泄露 API Key:任何人拿到你的密钥都可以消耗你的额度,务必妥善保管,不要上传到代码仓库或公开平台。
  • 国内访问优先:选择 MiniMax M2.5 (CN) 时,OpenClaw 会自动配置国内节点,速度和稳定性最佳。
  • 用量提醒:可以在 MiniMax 控制台设置「余额预警」,避免额度耗尽影响使用。

三、方式二:npm 手动安装(脚本失败时用)

步骤 1:配置 npm 国内镜像(加速)

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

步骤 2:全局安装 OpenClaw

# 官方版
npm install -g openclaw@latest
# 国内版(openclaw-cn,适配国内网络)
npm install -g openclaw-cn@latest

步骤 3:初始化与验证

# 初始化(官方版)
openclaw onboard --install-daemon
# 国内版初始化
openclaw-cn onboard --install-daemon

# 验证版本
openclaw --version
# 启动网关(默认端口 18789)
openclaw gateway --port 18789

浏览器访问 http://localhost:18789 打开管理面板。


四、方式三:WSL2 部署(官方推荐,最稳定)

原生 Windows 兼容性一般,WSL2(Linux 子系统) 是官方推荐方案,长期使用更稳定。

步骤 1:安装 WSL2

  1. 管理员 PowerShell 执行:
  2. 重启电脑,自动安装 Ubuntu,按提示设置用户名、密码。

步骤 2:WSL2 内安装依赖

打开 Ubuntu 终端,执行:

# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Node.js v22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证
node --version
npm --version

步骤 3:安装 OpenClaw

# 国内镜像
npm config set registry https://registry.npmmirror.com
# 全局安装
npm install -g openclaw@latest
# 初始化
openclaw onboard --install-daemon
# 启动网关
openclaw gateway --port 18789

五、常见问题与解决

  1. 脚本执行报错:确认以管理员运行 PowerShell,执行 Set-ExecutionPolicy RemoteSigned,关闭安全软件。
  2. node/npm 不是内部命令:重启电脑,或手动将 Node.js 安装目录添加到系统 PATH。
  3. 安装速度慢:使用国内脚本 / 镜像,或切换网络。
  4. 启动失败:检查 Node.js 版本(必须 ≥22),重新执行 openclaw onboard 初始化。

六、启动与使用

  • 启动网关:openclaw gateway --port 18789
  • 访问面板:浏览器打开 http://localhost:18789
  • 查看帮助:openclaw --help

声明 欢迎转载,但请保留文章原始出处:) 博客园:https://www.cnblogs.com/chenxiaomeng/ 如出现转载未声明 将追究法律责任~谢谢合作