说明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/Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bash或者如果你是windows点击开始搜索powershell记住不要直接在cmd里运行#Windows (PowerShell)iwr-usebhttps://openclaw.ai/install.ps1|iex运行这个命令它会自行帮你下载安装node和Openclaw所需要的所有安装包。问题解决如果出现以下报错iex:无法加载文件因为在此系统上禁止运行脚本。所在位置 行:1 字符:45 iwr-usebhttps://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运行以下命令#powershellSet-ExecutionPolicy RemoteSigned-ScopeCurrentUser然后输入 Y 确认更改。RemoteSigned 策略允许1、本地脚本正常运行2、远程下载的脚本需要有数字签名接下来出现的一些奇怪的关于node或者其他的报错均是因为网络原因导致的有包下载不下来安装不了只需要重新运行第一步的安装命令即可。第二步 选项配置安装完成后powershell界面会出现各种配置项让你依次进行设置1、其中Gatway选择local模式其他选项都选推荐或者跳过skip now2、认证方式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--sectionmodels3、重新启动Openclaw服务openclaw gateway
从零开始用最少的配置完成本地安装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/Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bash或者如果你是windows点击开始搜索powershell记住不要直接在cmd里运行#Windows (PowerShell)iwr-usebhttps://openclaw.ai/install.ps1|iex运行这个命令它会自行帮你下载安装node和Openclaw所需要的所有安装包。问题解决如果出现以下报错iex:无法加载文件因为在此系统上禁止运行脚本。所在位置 行:1 字符:45 iwr-usebhttps://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运行以下命令#powershellSet-ExecutionPolicy RemoteSigned-ScopeCurrentUser然后输入 Y 确认更改。RemoteSigned 策略允许1、本地脚本正常运行2、远程下载的脚本需要有数字签名接下来出现的一些奇怪的关于node或者其他的报错均是因为网络原因导致的有包下载不下来安装不了只需要重新运行第一步的安装命令即可。第二步 选项配置安装完成后powershell界面会出现各种配置项让你依次进行设置1、其中Gatway选择local模式其他选项都选推荐或者跳过skip now2、认证方式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--sectionmodels3、重新启动Openclaw服务openclaw gateway
