在 Windows 中安装并配置OpenClaw

原创 已于 2026-03-08 20:14:38 修改 · 1.1k 阅读 · 3 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#OpenClaw #wsl
于 2026-03-08 13:52:10 首次发布

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ，讲透 AI 如何接管脏活累活

一键订阅

在这里插入图片描述

在 Windows 中安装并配置OpenClaw

环境：Windows 11 25H2 + WSL2 (Ubuntu)，OpenClaw 版本 2026.3.2

各安装方式对比

以下是Openclaw官方支持的全部安装方式对比

Windows 下的安装方式对比

安装方式适用场景优点缺点
① Installer Script（WSL2 bash） curl -fsSL ...｜bash在 WSL2/Ubuntu 环境下运行全自动处理 Node 检测与安装，一步到位；Linux 生态完整，systemd 守护进程支持最好，两个系统间，文件能一定程度的隔离需要先配置 WSL2
② Installer Script（Windows PowerShell 原生）不想装 WSL2，直接在 Windows 运行无需 WSL2，上手门槛低Windows 下 systemd 不可用，守护进程能力受限；npm 全局路径问题较多
③ npm 手动安装 npm install -g openclaw@latest已有 Node 22+，想自己管理版本灵活，便于版本控制需自行处理 Node 版本及 sharp/node-gyp 等原生依赖问题
④ pnpm 安装 pnpm add -g openclaw@latest习惯使用 pnpm 的开发者磁盘利用率更高需要额外执行 pnpm approve-builds -g 批准 build script，步骤略繁琐
⑤ 源码构建 git clone + pnpm build开发者 / 贡献者可修改源码、调试配置复杂，不适合普通用户

官方推荐方式及原因

官方推荐：Installer Script（即方式①②）

官方文档原文：

“The installer script is the recommended way to install OpenClaw. It handles Node detection, installation, and onboarding in one step.”

推荐理由有三点：

  1. 全自动：自动检测系统中是否已有 Node.js，没有则自动安装，省去手动配置依赖的麻烦；
  2. 集成向导：安装完成后自动进入 onboarding 引导，降低遗漏配置的风险；
  3. WSL2 > 原生 Windows：官方文档特别写明 “On Windows, we strongly recommend running OpenClaw under WSL2”，原因是 WSL2 下 systemd 守护进程支持更完整，Node 生态原生依赖（如 sharp、node-llama-cpp）兼容性更好，整体稳定性优于 Windows 原生环境。

下文主要介绍在WSL2中安装OpenClaw的步骤

前置条件

  • 已安装Windows11并配置好 WSL2（Ubuntu）

如果尚未安装 WSL2，可参考 Microsoft 官方文档 完成安装。

安装步骤

1. 安装 OpenClaw

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

脚本会自动安装 Node.js 等依赖，完成后自动进入引导向导。

这一步骤持续时间根据网速的不同而不同，我大概等了30分钟。

2. 运行引导向导

如果安装后向导没有自动启动，手动执行：

# --install-daemon 表示同时将 Gateway 注册为 systemd 后台服务
openclaw onboard --install-daemon

按照向导提示依次完成：

  • 选择运行模式：local
  • 配置 OpenAI API Key
  • 配置 Agent 默认模型（如 openai/gpt-5.2-pro）
  • 配置 Gateway 端口（默认 18789）
  • ⚠️ 注意：所有步骤不要跳过，每一步都明确选择或确认后再继续

3. 启动 Gateway

openclaw gateway start

启动成功后，终端会提示 systemd service: openclaw-gateway.service 已启动。

4. 打开 Dashboard 并完成连接

  1. 浏览器访问：http://127.0.0.1:18789
  2. 进入左侧菜单 「控制」→「概览」
  3. 在「网关访问」区域确认 WebSocket URL 和网关令牌已自动填入
  4. 点击**「连接」**按钮
  5. 右上角显示 健康状况：正常 即表示连接成功 ✅

验证安装

Dashboard 右上角和「概览」页的「快照」区域应显示：

项目状态
健康状况正常
版本2026.3.2
状态正常
最后频道刷新just now

以下截图是我本机安装成功后，打开控制台的截图：
在这里插入图片描述

FAQ

Q1：执行 openclaw onboard 后，立刻又弹出了新的向导，循环不止？

原因：向导检测到配置不完整，触发了自动重新引导。

解决方法：重新运行向导，所有步骤不要跳过，每一步都明确选择或确认后再继续。

Q2：Dashboard 提示无法连接 / token 未授权？

原因：安装时跳过了某些步骤，导致 Control UI 没有完成与 Gateway 的握手。

解决方法：

  1. 浏览器访问 http://127.0.0.1:18789
  2. 进入左侧**「概览」**页面
  3. 确认「网关令牌」输入框中已有 token（token 保存在 ~/.openclaw/openclaw.json 的 gateway.auth.token 字段中）
  4. 直接点击**「连接」**按钮即可

也可以通过以下命令查看当前 token：

cat ~/.openclaw/openclaw.json | grep token

Q3：重启 Gateway 后问题依然存在怎么办？

如果 openclaw gateway restart 无效，可以尝试彻底重启：

openclaw gateway stop
sleep 3
pkill -f "openclaw.*gateway" 2>/dev/null
sleep 2
openclaw gateway start

Q4：如何确认 Gateway 正在正常运行？

systemctl status openclaw-gateway.service

或在 Dashboard 右上角查看**「健康状况」，显示「正常」**即可。

相关文件位置

文件路径
主配置文件~/.openclaw/openclaw.json
Workspace 目录~/.openclaw/workspace
Gateway 端口18789（默认）

如有问题，可先检查 ~/.openclaw/openclaw.json 配置是否完整，再尝试重启 Gateway 服务。

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏 ，讲透 AI 如何接管脏活累活

一键订阅
Windows 下 OpenClaw(小龙虾) 安装全记录：从零到一的保姆级图文教程（持续更新中）
热门推荐
weixin_43178406的博客
02-28 11万+
本文主要介绍了Windows 下 OpenClaw 安装全记录：从零到一的保姆级图文教程，希望能对学习使用OpenClaw 的同学们有所帮助。 文章目录 1. 背景 2. 实战教程 2.1 步骤一 安装Node.js 2.2 步骤二：安装并配置OpenClaw 2.3 步骤三：配置模型 2.4 步骤四：对话 3. 后续使用步骤
【OpenClaw从入门到精通】：环境搭建全攻略——Windows/macOS/Linux三平台部署指南（2026实测）
一键难忘的博客
03-10 1768
本文提供了OpenClaw在Windows、macOS和Linux三大平台上的详细部署指南。主要内容包括： 系统要求：详细列出了各平台的最低和推荐配置 Windows平台：提供WSL2和原生安装两种方案，包含环境配置、优化建议和防火墙设置 macOS平台：从Xcode工具安装到launchd服务配置，特别针对Apple Silicon芯片优化 通用步骤：Node.js安装、OpenClaw CLI部署和环境变量配置 文档还包含各平台的最佳实践、性能优化建议和常见问题解决方案，确保开发者能快速完成OpenCl
OpenClaw Mac本地部署保姆级教程：手把手教你“养龙虾”
AngelCryToo的专栏
03-08 2万+
聊天：直接与AI助理对话问你好后，AI回复下图内容：可以命令OpenClaw自动完成改名操作。管理技能：安装/卸载各种功能扩展查看日志：实时监控运行状态配置定时任务：让龙虾自动干活恭喜！现在你的Mac上已经有了一只功能强大的“小龙虾”。你可以通过Web界面或终端与它对话，让它帮你处理邮件、管理日程、编写代码，甚至控制智能家居。把它当实习生：初期多检查它的工作成果给最小权限：只授予完成任务所需权限定期审计：查看行为日志，发现异常及时处理及时更新保持最新版本。
OpenClaw从入门到应用——安装：更新OpenClaw
冯·诺依曼
03-28 2969
在 Gateway 运行时使用 Bun（因其存在 WhatsApp/Telegram 相关的已知问题）。注意：对于 npm 安装，Gateway 启动时会自动检查当前通道是否有新版本并提示更新。如果无法检测到安装方式，请改用上方“更新（全局安装）”中的方法。的更新方式是重新运行官网提供的安装脚本。如果 rebase 失败，Gateway 会中止更新并直接重启，不会应用任何更改。，它是 Gateway 的核心功能（而非插件）。小技巧：要查看当前发布的最新版本，可运行。安装的（即没有 git 元数据），
OpenClaw官方一键脚本使用指南，告别复杂配置
一键难忘的博客
02-15 1196
OpenClaw官方一键脚本提供全自动部署方案，支持x86_64和ARM64架构，最低配置仅需1.5GHz单核CPU、1GB内存和5GB存储空间。脚本智能检测系统环境，自动安装Python、Node.js、Redis等依赖，并配置开机自启服务。支持Ubuntu、Debian、CentOS等主流Linux发行版，通过简单命令即可完成安装和配置。脚本还提供完善的错误处理和卸载功能，适合各类用户快速部署OpenClaw服务。
【OpenClaw 安装教程：Windows/macOS/Linux 全平台保姆级指南】
小云的博客
03-08 2万+
OpenClaw是一款开源的AI助手工具，支持Windows、macOS和Linux三大平台。安装前需确保系统满足16GB内存、2-4GB存储等基本要求，并预先安装Node.js和Git。Windows用户推荐使用官方一键脚本安装，macOS可通过终端执行安装脚本，Linux需先更新系统并安装依赖。安装完成后可通过命令验证版本号确认安装成功。国内用户可使用加速版安装脚本提升下载速度。该工具不仅能回答问题，还能执行操作系统、访问网页等实际任务，实现AI自动化操作。
Clawdbot (OpenClaw/Moltbot) 内网穿透部署方案(安全有效-Linux-2026.01.30)
This blog is a space to document my professional learnings, personal reflections, and everything in between.
01-31 4748
本文将手把手教你如何部署 Clawdbot，并通过 Tailscale Funnel 将其安全地暴露到公网，实现即使在复杂网络环境下也能随时随地远程访问。
windows安装openclaw，并配置大模型
最新发布
山顶极客
06-12 174
本文主要介绍windows下龙虾openclaw的两种安装方式，以及配置
windows配置WSL2，并安装openclaw
qq_45576745的博客
02-16 3534
Opwnclaw配置在windows过程的一些命令
（windows）本地安装openclaw，完成配置并接入本地大模型（ollama）全流程指南
sazass的博客
03-10 1639
这个字段是可选的模型别名，说白了就是给你刚才配置的 qwen3.5:9b 模型起一个「好记的昵称」，方便后续在 OpenClaw 里快速识别这个模型（比如你以后加多个模型时，能一眼分清哪个是 Ollama 上的 qwen3.5:9b）。选择模型，可以选择云服务器商的API服务，也可以选择本地（局域网）部署的大模型。然后就是选择url，会默认给出一个，默认的格式和ollama的url格式一致，如果是本地的大模型可以不用修改，如果是局域网内某服务器的大模型，下载完成后打开安装包，按以下配置安装即可。
Windows 下安装 OpenClaw 及如何配置 Claude 代理 ApiKey (0011.ai)
非零非非零
02-11 2430
本文详细介绍了在Windows 10系统下安装配置OpenClaw并连接Claude代理的完整流程
Windows 环境下安装最 OpenClaw 详细教程
晨曦蜗牛
03-26 6480
至此，OpenClaw 已在 Windows 系统上完整部署并运行。升级 PowerShell 7（推荐）— 获得更好的终端体验安装 WSL2（可选，路线 B）— 在 Windows 上运行 Linux 环境安装 Node.js v24.14.1— 满足运行时要求，并配置国内镜像加速安装 Git— 用于管理组件依赖安装 OpenClaw— 四种方式按需选择：一键安装 / 标准安装 / 镜像加速 / 离线安装初始化配置— 通过交互式向导完成首次设置进阶配置— 修改权限配置文件，释放完整功能。
OpenClaw 安装指南：Linux 与 Windows 系统详细教程
unsynchronized的博客
03-10 3599
本文是一篇完整的 OpenClaw 安装指南。OpenClaw 是开源的个人 AI 助手，可在本地运行，支持多种聊天渠道接入。文章涵盖：① Linux 系统的三种安装方式（官方脚本/npm/Docker）；② Windows 系统通过 WSL2 的安装步骤；③ 从源码编译的开发者指南；④ 安装后的 Gateway 配置与健康检查；⑤ 常见问题排查。适合想要部署私有化 AI 助手的开发者参考。
从零开始：OpenClaw本地 AI 助手部署指南
积跬步，至千里。
03-11 6743
OpenClaw 是本地 AI 助手框架，运行在你的电脑上。支持自动化任务、多平台集成（Telegram、Discord 等）、浏览器自动化和系统监控。通过自定义个性配置，让 AI 理解你的工作方式，构建专属生产力工具。让 AI 真正为你工作。
Windows也能跑OpenClaw：完整安装教程+飞书接入，一步步带你避坑
人工智能AI技术
02-08 1万+
最近OpenClaw简直是AI本地部署圈的“顶流”，能本地跑、能接各种IM、还能帮你干活，关键是Windows也能完美跑起来，不用折腾双系统或虚拟机。今天这篇保姆级教程，从环境准备、OpenClaw安装、初始化配置，到飞书接入、常见坑点排查，全程照做就能成功，零编程基础也能跟着走，数学不好也完全没压力，主打一个快速落地、少走弯路。先简单说下OpenClaw是啥，用大白话讲：它就是个本地优先的开源AI智能体。
手把手本地部署 OpenClaw （安全篇）
2401_85026643的博客
03-11 4982
OpenClaw 是一款开源可私有化部署的 AI 智能体 / 自动化助手，支持多模型接入、工作流自动化、代码辅助等能力；本地部署可实现数据完全可控、隐私合规、权限自主管控，完美契合网络安全人员对环境隔离、安全审计的核心需求。本篇覆盖3 种方案，全平台兼容，附带网安专属安全加固与踩坑排查指南。
OpenClaw 在Windows下的安装
sunnytony的专栏
03-08 3515
本文介绍了在windows下安装OpenClaw的方法
OpenClaw 在 Windows 上的完整安装教程
笃行其道的博客
02-05 2万+
本文介绍了在Windows系统上通过WSL2运行OpenClaw的详细安装指南。主要内容包括：1）安装WSL2和Ubuntu系统；2）启用systemd支持；3）克隆OpenClaw仓库并构建项目；4）安装Gateway服务的多种方式；5）配置局域网访问的端口转发方案；6）验证安装和常见问题排查。文章强调WSL2能提供更好的Linux兼容性，并提供了从基础安装到高级配置的完整流程，包括自动化脚本和诊断工具使用方法。最后还提供了项目GitHub地址和相关活动信息。
Windows上安装openclaw，并使用本地ollama
wang6421453的专栏
03-01 1192
如果报没权限创建目录npm error syscall mkdir npm error path。详细安装步骤和配置请参考网上其他文章，本文只是记录自己安装过程中碰都的一些问题。只需使用管理员身份运行PowerShell即可。前提安装了较新版本的nodejs。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值