从零开始用最少的配置完成本地安装Openclaw龙虾极简教程(2026-03-12版本)
说明:OpenClaw 是 Moltbot/Clawdbot 的最新正式名称。项目经历了多次更名:
Clawdbot → Moltbot → OpenClaw(当前名称)
本教程基于官方文档 https://docs.openclaw.ai/编写。
准备工作
1、电脑里要安装好git,自行下载一个git 安装包,安装时记得勾选add path选项。
2、官方文档要求要有node环境,如果你有可以忽略,如果没有也不用单独下载安装,因为以下安装步骤也会自动下载并安装node,这里要注意你的node要是22及以上版本。
3、准备一个大模型的API Key,推荐国内的deepseek,避免翻墙等问题,或者阿里的千问大模型(Openclaw对千问只支持Auth模式,因此注册的有账号就行)。其他大模型也可。
4、做好准备之后,其实总共安装只需要一条命令。
安装Openclaw
第一步 : 命令行安装
#macOS/Linux
curl -fsSL https://openclaw.ai/install.sh | bash
或者,如果你是windows,点击开始,搜索powershell,记住不要直接在cmd里运行
#Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
运行这个命令,它会自行帮你下载安装node和Openclaw所需要的所有安装包。
问题解决
如果出现以下报错:
iex : 无法加载文件,因为在此系统上禁止运行脚本。所在位置 行:1 字符: 45
+ iwr -useb https://openclaw.ai/install.ps1 | iex
+ CategoryInfo : SecurityError: (:) [Invoke-Expression],PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess,Microsoft.PowerShell.Commands.InvokeExpressionCommand
这个错误的根本原因是 Windows PowerShell 的默认执行策略(Execution Policy)限制:
Windows 默认的执行策略是 Restricted(禁止运行任何脚本),这种设置是为了防止恶意脚本在系统上运行。但 npm.ps1 是 Node.js 安装的合法脚本,需要被允许执行。
修改执行策略(推荐)
以管理员身份打开 PowerShell,运行以下命令:
#powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
然后输入 Y 确认更改。
RemoteSigned 策略允许:
1、本地脚本正常运行
2、远程下载的脚本需要有数字签名
接下来,出现的一些奇怪的关于node或者其他的报错均是因为网络原因导致的有包下载不下来安装不了,只需要重新运行第一步的安装命令即可。
第二步 选项配置
安装完成后,powershell界面会出现各种配置项让你依次进行设置:
1、其中Gatway选择local模式,其他选项都选推荐或者跳过skip now;
2、认证方式Provider选择Openai(龙虾默认的是Anthropic,如果你会用这个,相信你也不需要教程),我们用的大部分模型都是Openai模式的,在Openai模式下选择Qwen千问模型,选择千问之后它会在浏览器弹出千问的登录界面,登录之后再回到powershell界面模型就已经配好了;
3、剩下的选项都选默认或者跳过即可,我们现在要的是快速安装并打开聊天界面,后面想添加都可以再配置。
4、注意:最后一步会给你三种启动和访问 Gateway(网关)的方式。这三种选项主要是让你选择如何与这个核心服务进行交互:
Start Gateway(打开网页界面)
Open the Web UI (打开网页界面)
Install as Service (安装为服务/守护进程)
这里我们选择Open the Web UI,直接打开Web界面,就可以进行聊天了。
重新配置
如果以上配置选项选择错了,或者任何时候你想重新配置,只要输入命令:
openclaw onboard
这个命令会重新让你把以上配置项重新配置一遍。
其他
1、如果已经正常打开web网页界面,但是聊天时界面转半天并且报错类似HTTP 429 状态码,通常会附带类似 “rate limit” 或 “quota” 的关键词,则表示模型的免费额度用完了需要充值。
2、如果你需要换个模型,可以输入以下命令重新进行模型选择和配置:
openclaw configure --section models
3、重新启动Openclaw服务:
openclaw gateway
更多推荐



所有评论(0)