小龙虾（openClaw）新手安装操作教程

小龙虾（openClaw）新手安装操作教程

一、安装前准备

（一）系统与硬件要求

系统：Windows10+/macOS12+/Ubuntu22.04+（推荐）。

内存：≥2GB（推荐4GB+），存储空间≥2GB。

权限：Windows需PowerShell管理员权限，Linux/macOS需sudo权限。

网络：稳定联网，用于下载安装包与依赖。

（二）核心依赖

Node.js≥v22（一键脚本可自动安装）、npm/pnpm、Git（源码安装需）。

二、新手安装详细步骤（Windows一键部署，最推荐）

步骤1：下载并解压安装包

1.访问openClaw官网（https://openclaw.ai），下载Windows一键部署包（约43MB）。

2.用WinRAR/7Zip解压（避免系统自带解压导致文件损坏），生成`Openclawwin`文件夹。

步骤2：启动安装程序并绕过系统拦截

1.进入文件夹，双击「OpenclawWindows一键启动.exe」（红色龙虾图标）。

2.弹出「Windows已保护你的电脑」时，点击「更多信息」→「仍要运行」。

步骤3：配置安装路径并开始部署

1.点击「开始使用」，设置纯英文路径（无中文、空格、特殊符号），推荐`D:\OpenClaw`，勿装C盘。

2.勾选协议，点击「开始安装」，等待35分钟自动部署（勿关闭窗口）。

步骤4：初始化配置与启动

1.安装完成后自动启动，首次启动需13分钟初始化Gateway服务。

2.按引导配置模型（新手可先跳过，后续补充APIKey），访问地址：http://localhost:18789。

三、安装常见难题及解决办法

（一）权限不足（报错EACCES:permissiondenied）

原因：非管理员权限运行。

解决：Windows以管理员身份打开PowerShell；Linux/macOS用`sudo`执行命令。

（二）端口被占用（Port18789isalreadyinuse）

原因：18789端口被其他程序占用。

解决：执行`openclawstop`停止服务，再`openclawstart`重启；或关闭占用端口的程序。

（三）依赖缺失/Node.js版本不符

原因：Node.js＜v22或依赖未安装。

解决：

1.检查版本：`nodeversion`。

2.升级Node.js至v22+，或用一键脚本自动安装依赖。

（四）下载缓慢/超时失败

原因：国内网络访问海外源不稳定。

解决：管理员PowerShell执行`npmconfigsetregistryhttps://registry.npmmirror.com`，配置国内镜像源后再安装。

（五）访问页面失败（localhost:18789无法访问）

原因：防火墙拦截、服务未启动或端口未放行。

解决：

1.检查服务状态：`openclawstatus`。

2.关闭防火墙或放行18789端口。

3.确认以管理员身份运行程序。

（六）模型调用失败（API报错401/不响应）

原因：APIKey错误、无余额或模型名称不匹配。

解决：

1.重新复制APIKey（无空格），检查账户余额。

2.确认模型名称与API提供商一致。

四、小龙虾（openClaw）对日常生活的作用总结

智能办公提效：自动处理文档、邮件、数据统计，生成报告与PPT，减少重复工作，提升办公效率。

便捷生活辅助：智能规划日程、设置提醒、整理待办事项；自动搜索美食、天气、出行路线，简化日常决策。

学习创作助力：辅助查阅资料、翻译文本、总结知识点；生成文案、诗歌、绘画灵感，降低创作门槛。

自动化任务执行：模拟键鼠操作、控制浏览器，自动完成网页签到、数据抓取、表单填写等重复任务，节省时间精力。

个性化智能服务：可接入大模型，定制专属AI助手，满足聊天互动、问题解答、情感陪伴等个性化需求。