乐于分享
好东西不私藏

手把手教你“养龙虾”:OpenClaw零基础部署保姆级教程(含报错速解)

手把手教你“养龙虾”:OpenClaw零基础部署保姆级教程(含报错速解)

最近AI圈最火的是什么?“Hermes当属顶流。但在那之前,还有一位老牌顶流依然在圈内稳坐江山——OpenClaw(小龙虾) 。GitHub上超31万Star的它,至今仍是3、4线AI从业者和普通人实现“AI自动化办公”的最强入口之一。

然而,部署一直是许多新手的“劝退门”。杀毒软件拦截、路径报错、下载链接失效……踩过一遍坑,热情就消了大半。

今天这篇教程,专为零基础用户打造。全程鼠标操作,零代码基础可上手,踩过的坑提前帮你填平,5分钟部署完成——没错,就是这么快。

一、什么是OpenClaw?先花1分钟了解它

OpenClaw被圈内称为“小龙虾”,是一款100%私有化部署的开源AI智能体框架。说人话就是:你可以在自己电脑或云服务器上跑一个AI助手,它不仅能和你聊天,还能直接操控电脑——帮你整理文件、浏览网页、发送邮件、操作软件,甚至执行命令行。

为什么值得部署?

  • 本地运行,数据完全归你:所有操作数据留在本地设备,不上传云端;

  • 免代码,可视化操作:无需编程基础,通过自然语言指令即可完成日常自动化任务;

  • 支持50+聊天平台接入:微信、QQ、钉钉、飞书、Discord、Telegram……随便挑;

  • 技能市场超过37000+个插件(Skills),从浏览器自动化到实时搜索,想加什么加什么。

二、部署前准备:先避3个大坑

在正式开始前,这3件事提前做好,直接避开80%的报错

坑1:安全软件先临时关闭 —— 安装前临时关闭360、电脑管家、火绒、Windows Defender等杀毒软件。OpenClaw需要调用系统权限,容易被误判拦截。安装完成后马上开回来,不影响电脑安全。

坑2:安装路径必须纯英文 —— 安装路径中严禁出现中文、空格或特殊符号。推荐直接使用 D:\OpenClaw,新手别自己改路径。

坑3:用专业解压工具,别用系统自带的 —— 用WinRAR或7-Zip解压压缩包,避免文件损坏。

📌 硬件最低要求:Windows 10/11 64位系统、2GB内存(推荐4GB以上)、至少5GB磁盘空间。这个配置,你手里随便一台电脑基本都满足。

三、两种部署方式,新手选第一种就够了

OpenClaw提供了多种部署方式,零基础用户直接选“方案一:Windows一键安装包” ,全程鼠标操作,不需要敲任何代码。

方案一:Windows一键安装包(新手首选)

第1步:下载安装包

复制官方下载地址(约361MB),在Chrome或Edge浏览器中打开。(划重点:用Chrome/Edge,不要用国产浏览器,否则可能被拦截导致下载失败。)

⚠️ 如果弹出报错“当前不支持该文件类型”怎么办?这是部署中最常见的报错。解决方法:

  1. 先试试换浏览器:关闭当前浏览器,用Chrome或Edge重新打开下载链接;

  2. 清理缓存:Ctrl+Shift+Del清理浏览器缓存后重试;

  3. 手动粘贴链接:把链接复制到地址栏手动回车。以上方法一般几十秒就能解决。

第2步:解压安装包

下载完成后,右键压缩包 → 选择“WinRAR/7-Zip → 解压到指定文件夹” → 输入解压路径 D:\OpenClaw(确认没有中文)→ 点击解压。

解压完成后,打开文件夹,找到红色龙虾图标(启动程序),能正常显示就没问题。

第3步:一键安装

双击红色龙虾图标 → 若弹出系统安全提示,点击 “更多信息” → “仍要运行”。进入安装界面后:

  • 点击“开始使用” → 确认安装路径为纯英文 → 勾选用户协议 → 点击“开始安装”

  • 等待3-5分钟自动完成,期间不要关闭窗口

第4步:等待初始化完成

安装结束后程序自动启动,界面显示“正在等待Gateway就绪…”,这个过程需要1-3分钟初始化。当右上角显示 “Gateway 在线” 时,部署完成✅。

至此,OpenClaw已经在你电脑上跑起来了!

方案二:官方一键脚本安装(适合想省事的用户)

如果你不怕敲一两行命令,这个方案更简洁,自动检测并安装Node.js和所有依赖,无需手动配置环境。

Windows用户(PowerShell管理员模式) :

  1. 开始菜单搜索“PowerShell”,右键选择“以管理员身份运行”

  2. 执行以下命令:

    text

    iwr -useb https://openclaw.ai/install.ps1 | iex
  3. 等待脚本自动完成Node.js检测、安装和OpenClaw配置

国内用户如果下载慢,可用国内加速镜像

text

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

macOS / Linux用户打开终端,执行:

text

curl -fsSL https://openclaw.ai/install.sh | bash

国内加速镜像:

text

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

方案三:阿里云服务器一键部署(适合24小时在线)

如果你想获得一个7×24小时在线的AI助手,可以考虑在阿里云上部署。操作极其简单:阿里云官方已经提供了OpenClaw一键部署镜像,购买服务器时直接选这个镜像就行,省去所有配置步骤。

零基础步骤

  1. 登录阿里云控制台,进入“轻量应用服务器” → “创建实例”

  2. 镜像选择:应用镜像 → OpenClaw(Clawdbot)2026官方稳定版

  3. 配置参考(新手直接照抄):2核4GB内存 + 40GB ESSD硬盘 + 5Mbps带宽

  4. 地域选择:中国香港或新加坡(免备案,大模型访问稳定)

  5. 购买后等待2-3分钟,实例变为“运行中”即完成✅

有了云服务器上的OpenClaw,你出差、关机都不影响它干活,真正实现AI随时在线。

四、配置大模型:给“小龙虾”装上大脑

OpenClaw安装完成后,还需要接入一个大模型(LLM)作为“大脑”,它才能听懂你的指令。官方推荐Kimi K2.5。

获取Kimi API Key

  1. 访问 https://platform.moonshot.cn/console 登录

  2. 点击左侧“API Key管理” → “创建API Key” → 复制弹出的密钥字符

在OpenClaw中配置

  1. 安装完成后自动进入引导界面,选择 Yes 并回车

  2. 选择 QuickStart(快速安装模式)

  3. 选择 Model → 选择 Moonshot AI .cn 接入点

  4. 粘贴复制的API Key → 选择 Moonshot/Kimi-K2.5 模型

  5. 聊天载体可以先跳过,直接使用 TUI 体验

  6. 网络搜索提供商选择 Kimi → 创建一个搜索专用的API Key并粘贴

  7. 选择要安装的Skills,按回车确认即可

💡 小提示:如果不想用Kimi,也可以选择阿里云千问(Qwen)、智谱GLM等国产模型,OpenClaw对它们都原生支持。

五、怎么用?几句话搞定日常任务

部署完成后,在TUI界面(终端交互界面)中,你可以直接用自然语言向OpenClaw下达指令:

常用指令示例

  • “帮我整理下载文件夹,按图片、文档、安装包分别存放”

  • “查找本周新建的所有Word文档,按时间顺序列出”

  • “清理桌面无效快捷方式,归类零散文件”

  • “提取当前文件夹内所有PDF的标题并汇总成清单”

指令描述越详细,执行准确率越高。

六、状态管理与常用命令

查看OpenClaw状态

text

openclaw status        # 查看整体状态openclaw gateway status # 查看Gateway状态openclaw tui           # 返回TUI继续聊天

连续按两次 Ctrl + C 可退出TUI。

重启服务:如果服务离线或遇到问题,执行openclaw gateway restart即可恢复。

七、常见问题速查表(建议收藏)

问题现象
解决方案
安装/启动失败
关闭杀毒软件,重新解压,以管理员身份运行
下载报错“当前不支持该文件类型”
用Chrome/Edge浏览器,清理缓存或手动粘贴链接
Gateway持续离线
确认杀毒防护已关闭,重启OpenClaw服务
路径报错
检查安装路径是否包含中文/空格,更换为纯英文路径
程序无响应
关闭代理/VPN,重启软件
模型API调用失败
检查API Key是否正确,确认网络可正常访问外部服务

📌 安全提醒:OpenClaw具有系统级操作权限,建议开启设备认证功能,确保只有授权的设备才能向本地电脑下发指令。安装完成后记得把杀毒软件重新打开。

八、别忘了做这3件事

部署完成后,顺手把这三件事做了,能省掉后面90%的麻烦:

  1. 把杀毒软件开回来:安装前临时关了,现在可以重新打开,不影响OpenClaw正常运行。

  2. 保存好API Key:模型API Key妥善保管,万一泄露及时到平台后台删除旧的重新生成。

  3. 用好本地网页版控制台:部署完成后,浏览器访问 http://localhost:18790 即可打开交互式操作界面,实时查看运行日志、调试技能调用、管理消息通道。

结语

从安装部署到配置使用,整个流程5分钟就能跑通。OpenClaw最厉害的地方在于,它不是一个“用完就扔”的聊天机器人,而是一个真正能为你干活的数字员工——文件整理、浏览器操作、代码编写、邮件收发,只要你想得到,它基本都能做。

而且它完全跑在你自己的设备上,所有数据由你掌控,不用担心隐私问题。

现在,你的“小龙虾”已经部署好了。去试试让它帮你做点什么吧。