win OpenClaw龙虾保姆级完整安装教程指南

⚠️ 免责声明

本公众号所发布的内容仅供学习与交流参考。因传播或使用本文所提供信息而产生的任何直接或间接后果与损失，均由使用者本人自行承担，本公众号及作者概不负责。如操作不当造成任何损失，后果自负。如涉及侵权，烦请及时告知，我们将第一时间删除相关内容并致歉，谢谢理解与支持！

工具教程

手把手教你安装
OpenClawAI 助手

从零开始，在 Windows 上完整部署一个
可以自动执行任务的本地 AI 智能体

🦞 OpenClaw 2026.4.5📖 阅读约 5 分钟💻 Windows 10/11

①

什么是 OpenClaw？

OpenClaw 是一款开源的本地 AI 智能体，运行在你自己的电脑上。它不只是一个聊天机器人——它能真正帮你 执行任务 ：管理文件、控制浏览器、发送消息、自动化工作流程。

支持 Anthropic Claude、OpenAI GPT、Google Gemini 等主流模型，数据完全留在本地，隐私有保障。

🦞 小提示： OpenClaw 每次启动都会显示一句幽默的彩蛋语录，比如 "Your config is valid, your assumptions are not." ——这是正常现象，不是报错。

②

安装前准备

安装 OpenClaw 只需要一个前提条件： Node.js 22 或以上版本 。

以管理员身份打开 CMD

按 Win 键搜索"cmd"，右键选择「以管理员身份运行」

用 Winget 安装 Node.js 22

Windows 10/11 内置 winget 包管理器，一行命令搞定

重新打开 CMD 验证安装

安装完成后需要重开终端，环境变量才会生效

CMD — 安装 Node.js

# 安装 Node.js 22winget installOpenJS.NodeJS.22 --source winget --accept-package-agreements --accept-source-agreements# 重开 CMD 后验证node-vnpm-v

⚠️ 如果执行 npm -v 报“禁止运行脚本”错误，在 PowerShell 中执行： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force ，或改用 CMD 而非 PowerShell。

③

安装 OpenClaw

Node.js 准备好之后，用 npm 一行命令安装 OpenClaw：

CMD — 安装 OpenClaw

# 全局安装最新版npm install-g openclaw@latest

安装完成后，依次执行以下命令完成初始化：

CMD — 初始化配置

# 第一步：生成配置文件openclaw setup# 第二步：配置 AI 模型 API Keyopenclaw models auth login--provider anthropic# 或者 OpenAIopenclaw models auth login--provider openai# 第三步：启动服务（保持窗口开着）openclaw gateway

🔑 API Key 获取： Anthropic 用户前往 console.anthropic.comconsole.anthropic.com，OpenAI 用户前往 platform.openai.com 创建 API Key。

④

打开控制台

服务启动后，新开一个 CMD 窗口，执行：

CMD — 打开控制台

openclaw dashboard

会自动在浏览器打开控制台，地址为 http://127.0.0.1:18789/?token=xxx ，注意要用带 token 的完整链接访问。

⚠️ 如果浏览器显示「无法访问此页面」，检查是否开了 Clash 代理。需要在 Clash 的「Bypass」列表中添加 127.0.0.1 和 localhost ，让本地流量不走代理。

（5）

常见问题排查

问题	解决方法
npm 禁止运行脚本	PowerShell 执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force ，或改用 CMD
openclaw 命令找不到	将 npm 全局路径加入系统 PATH，执行 npm config get prefix 查看路径
浏览器无法访问 18789	Clash 排除 127.0.0.1，或临时关闭系统代理
服务未启动	先执行 openclaw setup 再执行 openclaw gateway
没有配置任何认证	执行 openclaw models auth login --provider anthropic 配置 API Key
最大通话堆栈已超过	从配置文件读取 token： type C：\Users\用户名\.openclaw\openclaw.json \| findstr token

⑥

常用命令速查

OpenClaw 常用命令

# 启动服务openclaw gateway# 打开控制台openclaw dashboard# 查看日志openclaw logs# 环境诊断openclaw doctor# 更新到最新版npm install-g openclaw@latest# 查看所有命令openclaw--help

🦞

手把手教你安装OpenClawAI 助手