Back to Articles
Mar 11, 20264 days ago

OpenClaw Windows Super Beginner Installation and Usage Tutorial: From You Can't Use a Computer (Copy in Order)—Already Deployed and Monetized 2k+

Z
Zephyr.在思考丨阿杭杭杭@Astronaut_1216

AI Summary

This article is a comprehensive, step-by-step guide designed to get anyone, even those with zero programming experience, up and running with the OpenClaw AI assistant framework on a Windows PC. Dubbed "Lobster," OpenClaw is not an AI itself but a powerful open-source shell that connects to models like DeepSeek, allowing you to automate tasks, manage files, write content, and even integrate with platforms like Feishu directly from your computer. The guide demystifies the entire process, promising a functional setup in about 30 to 45 minutes without any cost for the software. The tutorial meticulously walks you through every critical stage, from verifying your system is 64-bit and installing the necessary Node.js environment, to obtaining a DeepSeek API key and navigating the configuration wizard. It anticipates common pitfalls, such as PowerShell permission errors and installation hiccups, providing clear troubleshooting advice. Crucially, it explains the simple, repeatable process for starting the service each time you want to use it and how to access the user-friendly web control panel, ensuring you can reliably interact with your new AI assistant once everything is configured. By consolidating insights from multiple sources and the author's own successful deployment, this guide offers a rare, truly beginner-friendly path to leveraging local AI automation. For anyone curious about practical AI tools beyond just a chatbot website, this article provides the actionable, detailed roadmap you need to build your own digital helper from the ground up. Read the full tutorial to unlock the specific commands, key settings, and pro-tips required for a smooth installation and start exploring what OpenClaw can do for you.

整理了X、CSDN等16篇等安装教程基于我实际安装过程整理,使用 DeepSeek API,让大家都用得上小龙虾

一、先了解这是什么

OpenClaw(外号"龙虾")是一个开源的 AI 助手框架。它本身不是 AI,而是一个"壳子",需要连接 DeepSeek、通义千问等 AI 才能工作。你把 AI 的 API Key 填进去,它就能在你电脑上帮你自动干活:查文件、写内容、对话,甚至接入飞书自动回消息。

需要准备的东西:

Windows 10 或 Windows 11 的电脑(64位)

能上网

大约 30~45 分钟

不需要任何编程基础,不需要花钱买软件

二、安装前的准备:确认电脑是 64 位系统

点击左下角 Windows 图标

点"设置"(齿轮图标)

点"系统",拉到底部点"关于"

找到"系统类型"这一行,确认显示"64 位操作系统"即可继续

第 1 步:安装 Node.js(OpenClaw 的运行环境)

Node.js 是 OpenClaw 的运行基础,必须先装它。

打开浏览器,访问:https://nodejs.org/zh-cn/download

页面上选择:版本选 22.x.x LTS,系统选 Windows,格式选 x64,安装包类型选 .msi

点击下载,等待下载完成(约 30MB)

双击下载好的安装文件

安装过程全部点"Next",遇到勾选协议先打勾再 Next,不要修改任何路径

最后点"Install",弹出"是否允许更改"点"是"

看到"Finish"就点,安装完成

安装完成后重启电脑一次

第 2 步:验证 Node.js 安装是否成功

按 Win 键,搜索"PowerShell"

右键点击"Windows PowerShell",选"以管理员身份运行"

弹出确认框点"是"(以管理员身份打开的 PowerShell 标题栏会显示"管理员: Windows PowerShell")

在蓝色窗口里输入以下命令,按回车:

node --version

出现类似 v22.13.0 的版本号,说明成功

继续输入,按回车:

npm --version

出现版本号说明 npm 也正常

如果出现红色报错"无法加载文件",输入以下命令按回车,然后输入 Y 再按回车:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新试 npm --version,能显示版本号就没问题了。

第 3 步:解除 PowerShell 的运行限制

Windows 默认不允许随便运行脚本,需要先解锁,否则安装会失败。

在管理员 PowerShell 里,依次输入以下两条命令,每输一条按一次回车:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

如果提示"是否要更改执行策略",输入 Y 再按回车。

第 4 步:安装 OpenClaw 中文版

在管理员 PowerShell 里输入以下命令,按回车:

npm install -g openclaw-cn@latest

等待安装,期间会有大量文字滚动,这是正常的,不要关窗口。
同时会有很多黄色 warning(警告),不用管,不影响安装。
等到出现"added 6xx packages"字样就安装成功了。

整个过程大约需要 3~10 分钟,请耐心等待。

如果超过 10 分钟还没完成,按 Ctrl+C 中断,换这条命令试试:

iwr -useb https://openclaw.ai/install.ps1 | iex

第 5 步:验证 OpenClaw 安装成功

输入以下命令,按回车:

openclaw-cn --version

出现版本号(比如 2026.2.xx)说明安装成功。

第 6 步:获取 DeepSeek API Key

API Key 是连接 AI 的钥匙,OpenClaw 需要它才能工作。

打开浏览器,访问:https://platform.deepseek.com/

注册并登录 DeepSeek 开放平台账号

登录后,点击左侧菜单的"API Keys"或"密钥管理"

点击"创建 API Key",名称随便填(比如"openclaw")

出现一串以 sk- 开头的字符,这就是你的 API Key

点复制按钮,立刻粘贴到记事本或手机备忘录里保存好

这个弹窗关掉后就再也看不到完整 Key 了,一定要存好

注意:API Key 相当于密码,不能发给任何人。充值说明:DeepSeek 是按使用量收费的,新用户通常有免费额度,用完需要充值,费用很低(几块钱可以用很久)。

第 7 步:运行安装配置向导

在管理员 PowerShell 里输入以下命令,按回车:

openclaw-cn onboard --install-daemon

接下来会出现一个文字菜单向导。操作方式:用键盘上下方向键移动选项,按回车键确认选择。

按以下顺序操作:

第 1 问:安全提示
选 Yes,按回车

第 2 问:安装模式
选 QuickStart(快速开始),按回车

如果检测到现有配置,显示 Workspace / model / gateway 等信息
这说明之前装过,直接继续向导即可,选 Keep current(保留当前配置)

第 3 问:选择 AI 模型提供商
用方向键找到 DeepSeek,按回车

第 4 问:输入 API Key
在 PowerShell 里,鼠标右键就是粘贴,把刚才保存的 Key 右键粘贴进去,按回车

第 5 问:选择具体模型
选 保持当前 或选 deepseek-chat,按回车

第 6 问:验证方式
选 Token 验证,按回车

第 7 问:设置 Token
自己随便输一串字符(比如 abc123456),记住这串字符,按回车

第 8 问:选择通讯渠道
第一次使用选 Skip for now(先跳过),按回车

第 9 问:启用钩子(Hooks)
选 暂时跳过,按回车

第 10 问:安装守护进程
必须用管理员身份打开的 PowerShell 才能成功。
选 Yes,按回车。

关于"网关服务安装失败"的说明

如果出现以下报错:

Gateway service install failed: schtasks create failed
Tip: rerun from an elevated PowerShell (right-click → Run as administrator)

原因是 PowerShell 没有用管理员身份打开。

解决方法:关掉当前 PowerShell,重新右键以管理员身份打开,再重新运行 openclaw-cn onboard --install-daemon,这次选 Yes 安装守护进程就能成功。

如果还是失败也没关系,守护进程失败只影响一件事:重启电脑后 OpenClaw 不会自动在后台运行,需要你手动启动一次。功能本身完全正常,不影响使用。

第 8 步:启动 OpenClaw 网关服务

向导完成后,服务不会自动启动,需要手动运行以下命令:

在管理员 PowerShell 里输入,按回车:

openclaw-cn gateway --port 18789

出现类似以下内容说明启动成功:

OpenClaw-CN 0.1.x — ...
>>
Gateway listening on ws://127.0.0.1:18789

重要:这个 PowerShell 窗口必须一直开着,不能关。关掉窗口,服务就停止了,浏览器就访问不了了。

第 9 步:打开浏览器,进入控制面板

打开浏览器(Chrome 或 Edge),在地址栏输入以下地址,按回车:

http://127.0.0.1:18789/?token=你的Token

把"你的Token"替换成你在向导第 7 问里自己设的那串字符(比如 abc123456),完整示例:

http://127.0.0.1:18789/?token=abc123456

看到 OpenClaw 的控制界面,就可以开始使用了。

把这个带 Token 的完整网址收藏到浏览器书签,以后每次直接点书签打开即可。

如果进入后右上角出现"1008 错误",点左侧"概览",在"网关令牌"输入框里输入你的 Token,点连接即可。

第 10 步:开始使用

进入控制面板后,点左侧的"聊天"或"对话",在输入框里输入你想让 AI 做的事情,按回车发送,AI 就会回复你了。

三、以后每次使用的流程

每次开机想用 OpenClaw,按以下步骤操作:

第 1 步:右键以管理员身份打开 PowerShell

第 2 步:输入以下命令,按回车:

openclaw-cn gateway --port 18789

第 3 步:等出现启动成功的提示(大约等 5~15 秒)

第 4 步:打开浏览器,输入收藏的那个带 Token 的地址

第 5 步:开始使用

用完后:直接关掉 PowerShell 窗口即可停止服务

四、常用命令速查表

命令作用openclaw-cn gateway --port 18789启动服务(每次使用前必须运行)openclaw-cn gateway status查看服务是否在运行openclaw-cn doctor一键检查有没有问题,出现对号就正常openclaw-cn onboard重新配置(想换模型或改设置时用)openclaw-cn --version查看当前安装的版本号

五、常见问题解答

问:打开浏览器显示"拒绝连接"或"ERR_CONNECTION_REFUSED"
答:OpenClaw 网关还没启动。按第 8 步,在管理员 PowerShell 里运行启动命令,保持窗口开着,再去刷新浏览器。

问:PowerShell 里出现红色报错"无法加载文件"
答:输入以下命令并按回车,然后输入 Y 再按回车:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

问:npm install 命令一直卡着不动
答:等待超过 10 分钟,按 Ctrl+C 中断,换以下命令试试:

iwr -useb https://openclaw.ai/install.ps1 | iex

问:忘了自己设的 Token 是什么
答:在 PowerShell 里输入:

notepad ~\.openclaw\openclaw.json

用记事本打开配置文件,找到"token"那一行,旁边的字符串就是你的 Token。

问:想换成其他 AI 模型(比如通义千问)
答:在管理员 PowerShell 里运行向导重新配置:

openclaw-cn onboard

在选择模型那一步,选 Qwen 或其他你想用的即可。

问:想完全卸载 OpenClaw
答:在 PowerShell 里运行:

openclaw-cn uninstall

或者手动删除以下文件夹(把"你的用户名"换成你电脑的用户名):

C:\Users\你的用户名\.openclaw

六、重要信息请保存好

安装完成后,以下内容请务必找个地方记录下来:

你的 DeepSeek API Key(以 sk- 开头的那串字符)

你在向导里自己设的 Token

带 Token 的完整访问地址:http://127.0.0.1:18789/?token=你的Token

以上三样东西如果忘了,可以通过查看配置文件找回(打开 ~.openclaw\openclaw.json 这个文件查看)。

好了,以上本次教程结束

接下来我要更新我的实际养虾教程了

下期见朋友们~

By
ZZephyr.在思考丨阿杭杭杭