OpenClaw安装避坑指南 这份操作手册帮你快速通关

这款名为OpenClaw（小龙虾）的AI代理工具最近真的太火了。但火归火，我去各大开发者社区潜水刷了一遍，发现一个扎心的现状：10个下载OpenClaw的新手，有8个都卡在了安装配置的路上。Node.js版本不对、权限报错、Token无效、装完启动不了……这些坑几乎每个新手都会踩一遍。今天就给大家整理一份OpenClaw安装避坑指南，保证你能顺利养上这只“小龙虾”。

坑一：Node.js版本“老少配”

很很多新手第一步就栽了跟头，兴冲冲地在终端输入 openclaw --version，结果却显示command not found或不支持的Node版本。原因很简单，OpenClaw依赖Node.js 22或以上来调用系统资源和API，如果版本过低，自然跑不起来。

解决方法：

打开终端（Windows请用管理员权限的PowerShell），输入：node --version。如果显示低于 v22.x.x，就需要升级。

坑二：Windows执行策略拦路虎

在PowerShell运行安装脚本，系统提示“此系统上禁止运行脚本”。这是Windows默认安全策略阻止未签名脚本执行造成的。

解决方法：

以管理员身份打开PowerShell，执行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认即可。

这样，本地脚本可以正常运行，网上下载的脚本仍需签名，保证安全。

坑三：WhatsApp/飞书等渠道连接不上

如果安装完成后发现WhatsApp、飞书或钉钉无法连接，通常是网络或配置问题导致的。

以 WhatsApp为例，手机和电脑必须在同一局域网才能扫码成功。

遇到这种情况，只需先退出旧的登录状态：openclaw channels logout WhatsApp

然后重新登录：openclaw channels login WhatsApp

确保手机和电脑连接同一个Wi-Fi，再生成新的二维码扫码即可。

飞书和钉钉则稍有不同，最常见的问题是回调地址配置不正确，或忘记将应用发布，只停留在草稿状态。

这时，需要确认回调地址格式正确，例如：http://<你的公网ip或域名>:18789/

然后在开发者后台点击“发布版本”，不然草稿状态是不会生效的。

做完以上设置，机器人就能顺利响应消息。

坑四：服务器部署要注意内存和地域

在云服务器上部署OpenClaw，如果配置不足或地域选择不当，也会遇到频繁崩溃或海外技能不可用的问题。因为OpenClaw对内存要求较高，低配置容易被系统kill，此外大陆内地服务器访问海外网站可能受限。

建议配置：

内存：最低 2vCPU + 4GB 内存

地域：推荐中国香港或美国弗吉尼亚，网络通达性好

这样既保证小龙虾（OpenClaw）运行流畅，又能顺利使用海外技能。

OpenClaw安装部署教程

为了让新手少踩坑，推荐使用【OpenClaw部署助手】一键安装OpenClaw，它会自动处理环境配置和依赖，基本无需手动操作。

步骤 1：点击下方OpenClaw部署助手安装包，下载到电脑。

OpenClaw部署助手（官方版）

一键本地部署OpenClaw，真正能干活的AI Agent

立即下载

好评率97%

下载次数：3358190

步骤 2：安装完成后，打开软件，“点击开始部署”按钮。它会自动下载OpenClaw核心文件和依赖，并处理Node.js、权限策略、环境变量等常见问题。安装过程中，如果防火墙或安全软件弹出提示，选择“允许”即可。

步骤 3：安装完成后，助手界面会显示“已经成功部署”的提示。

步骤 4：点击“配置AI模型”，选择你需要使用的大模型，例如智谱GLM、DeepSeek等，并点击软件提供的链接，到对应平台官网获取API Key。

步骤 5：将获取到的API Key粘贴到软件对应位置，然后点击“保存模型配置”。完成后，OpenClaw就具备智能对话能力。

步骤 6：返回软件“首页”，确认OpenClaw服务已运行，然后点击“打开聊天”，即可进入聊天界面，开始使用你的AI助手。

这份指南把最容易踩的四个坑和解决方法都列出来了。新手跟着做，保证顺利养上“小龙虾”。养好了，它不仅能陪你聊天，还能帮你完成很多日常自动化任务，让AI助手真正为你服务。