整理了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 这个文件查看)。
好了,以上本次教程结束
接下来我要更新我的实际养虾教程了
下期见朋友们~

