整理了 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 CurrentUserSet-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 failedTip: 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 这个文件查看)。
好了,以上本次教程结束。
如果你对 AI、工作流、Agent,或者普通人怎么把 AI 真正用进工作这类内容感兴趣,也欢迎关注我。
后面我会继续写这方面的内容,尽量不讲空话,也不只讲概念,而是把我看到的趋势、踩过的坑和真正能落地的方法,整理成你看完就能用起来的东西。
夜雨聆风