OpenClaw(俗称“龙虾”)软件说明及安装教程

OpenClaw（俗称“龙虾”）软件说明及安装教程

一、软件核心说明

1.1 基础信息

OpenClaw（简称“龙虾”）是一款近期爆火的开源个人AI执行代理工具，由前PSPDFKit创始人Peter Steinberger开发，核心定位是“能动手做事的自主AI助手”——区别于传统AI的被动问答，它可获取设备系统级权限，主动执行各类任务，所有数据默认存储在本地，兼顾便捷性与隐私安全，采用MIT开源许可证，完全免费且代码公开可扩展。

软件支持多系统适配，包括Windows（推荐WSL2）、Linux、macOS、iOS、Android，可通过WhatsApp、Telegram、钉钉、飞书等10+主流通信平台操控，无需额外下载专属APP，聊天窗口即可下达指令。

1.2 俗称“龙虾”的由来

OpenClaw被网友亲切称为“龙虾”，核心源于三点，既有趣又贴合项目基因：

1视觉标识：软件官方图标是一只鲜明的红色龙虾，直观易记，用户和开发者自然而然用“龙虾”指代它，甚至券商研报也会直接使用“OpenClaw小龙虾”的称呼；

1命名关联：项目曾用名Moltbot，“Molt”意为“龙虾蜕壳”，寓意项目不断迭代进化，就像龙虾换壳成长一样；最终定名OpenClaw，“Claw”（螯）也延续了龙虾的核心形象，官方还打趣“钳即是法”，将龙虾钳子与AI的执行力巧妙结合；

1社区文化：随着软件爆火，用户将部署、配置、训练OpenClaw的过程称为“养龙虾”，衍生出“龙虾安装站”等线下活动，甚至专属社交平台Moltbook，进一步强化了“龙虾”的昵称辨识度。

1.3 核心功能（新手必知）

OpenClaw的核心优势的是“主动执行”，打破传统AI“只说不做”的局限，高频实用场景包括：

1办公自动化：筛选邮件、生成回复草稿、整理文件、提取Excel数据、记录会议纪要并分发，告别重复劳动；

1内容创作：生成文案、代码、AI音乐，提取资料核心知识点，适配多平台文案格式并发布；

1生活助手：日程提醒、价格监控、定时备份文件、对比电商价格，24小时待命；

1技术拓展：服务器监控、智能家居控制、合规爬虫，支持社区565+模块化技能扩展，越用越贴合需求；

1隐私保护：所有数据（聊天记录、文件、凭证）默认存储在本地（路径~/.openclaw/），零云端依赖，避免隐私泄露。

1.4 注意事项（避坑重点）

1. 软件需Node.js 22及以上版本支持，低于该版本无法安装，新手需先确认Node.js版本； 2. Windows系统优先通过WSL2安装，原生Windows支持有限，部分功能可能无法正常使用； 3. 软件需要较高系统权限，避免安装来源不明的“技能包”，曾出现恶意技能包导致设备被控的安全事件（ClawHavoc事件）； 4. 安装过程需稳定网络，建议提前设置国内npm镜像源，提升下载速度； 5. 开源工具可自由修改，但新手不建议随意更改代码，避免程序异常。

二、安装前准备

2.1 硬件要求

项目	最低要求	推荐配置
内存	2GB	4GB及以上
磁盘空间	5GB可用空间	10GB及以上（预留技能扩展空间）
系统版本	Windows 10+、macOS 10.15+、主流Linux发行版	Windows 11（WSL2）、macOS 12+、Ubuntu 22.04+

2.2 软件依赖

核心依赖：Node.js（版本≥22），这是OpenClaw运行的基础，所有系统都需提前安装或确认版本。

可选依赖：pnpm（推荐，下载速度比npm更快）、Docker（用于容器化部署，适合技术玩家或云端部署）、Git（用于从源码安装）。

2.3 网络准备

1. 确保网络稳定，能访问npm仓库和GitHub（用于下载安装包和源码）；

2. 国内用户建议设置npm国内镜像源，提升下载速度，命令如下（终端/CMD中输入）：

bash                  npm config set registry https://registry.npmmirror.com

三、分系统安装教程（新手优先选官方一键安装）

3.1 Windows系统（推荐WSL2安装，最稳定）

方式一：WSL2 + 官方一键安装（新手首选）

1安装WSL2：以管理员身份打开PowerShell，输入以下命令，等待安装完成后重启电脑：          wsl –install

1安装Ubuntu发行版：重启后，在Microsoft Store搜索“Ubuntu”，下载并安装（默认即可，无需额外配置）；

1打开Ubuntu终端：启动Ubuntu，等待初始化完成（首次启动需设置用户名和密码）；

1一键安装OpenClaw：在Ubuntu终端中输入以下命令，等待5分钟左右（自动安装依赖、配置环境）：          curl -fsSL https://openclaw.ai/install.sh | bash

方式二：PowerShell直接安装（实验性，不推荐新手）

适用于不想安装WSL2的用户，注意：部分功能可能无法正常使用。

1以管理员身份打开PowerShell，关闭杀毒软件（避免拦截安装）；

1输入以下命令，执行安装脚本：          iwr -useb https://openclaw.ai/install.ps1 | iex

3.2 Linux系统（Ubuntu、Debian等主流发行版）

方式一：官方一键安装（推荐）

一条命令搞定所有依赖和安装，适用于大多数Linux用户：

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

方式二：npm/pnpm手动安装（有技术基础用户）

1确认Node.js版本：终端输入以下命令，显示版本≥22即可，否则需升级：          node –version

1使用npm安装（速度较慢）：          npm install -g openclaw@latest

1使用pnpm安装（推荐，需先安装pnpm：npm install -g pnpm）：          pnpm add -g openclaw@latest

方式三：Docker容器化安装（技术玩家）

1克隆仓库：          git clone https://github.com/openclaw/openclaw.git          cd openclaw

1运行Docker安装脚本：          ./docker-setup.sh

1（可选）使用远程镜像，跳过本地构建（速度更快）：          export OPENCLAW_IMAGE=”ghcr.io/openclaw/openclaw:latest”          ./docker-setup.sh

3.3 macOS系统

操作与Linux类似，支持一键安装和手动安装，步骤如下：

1打开终端（Finder→应用程序→实用工具→终端）；

1（可选）设置npm国内镜像源（提升下载速度）；

1一键安装（推荐新手）：          curl -fsSL https://openclaw.ai/install.sh | bash

1手动安装（有技术基础）：确认Node.js≥22后，使用npm或pnpm安装，命令同Linux方式二。

3.4 源码安装（开发者/追求最新功能用户）

适用于需要修改代码、体验最新开发版本的用户，步骤如下（全系统通用）：

1克隆仓库：          git clone https://github.com/openclaw/openclaw.git          cd openclaw

1安装依赖（推荐pnpm）：          pnpm install

1构建UI和项目：          pnpm ui:build          pnpm build

1运行安装向导：          pnpm openclaw onboard –install-daemon

四、安装后配置（必做步骤）

无论哪种安装方式，完成后都需进行简单配置，才能正常使用，步骤如下：

1运行安装向导：终端/ PowerShell输入以下命令，启动配置向导：          openclaw onboard –install-daemon

1跟随向导完成配置（全程中文，新手可按以下建议选择）：          

1语言选择：选“简体中文”（2026年3月起官方支持原生中文）；

1身份验证：可选择OpenAI或国内模型（如Qwen、GLM），新手可先跳过API Key配置，后续再补充；

1通讯渠道：选择自己常用的平台（如钉钉、Telegram），按提示完成绑定；

1技能配置：新手选“否”，后续需要再通过控制台安装；

1系统服务：选择“安装”，实现开机自动启动。

1验证安装：输入以下命令，若能显示版本号，说明安装成功：          openclaw –version

1系统诊断：输入以下命令，检查配置是否正常，显示“没有发现问题”即可：          openclaw doctor

1打开控制面板：输入以下命令，浏览器会自动打开Web控制台，可在此处修改设置、安装技能：          openclaw dashboard也可手动访问地址：http://127.0.0.1:18789/

五、常见问题解决（新手必看）

5.1 安装失败

1权限不足：Windows需以管理员身份运行PowerShell，Linux/macOS在命令前加sudo（如sudo npm install -g openclaw@latest）；

1Node.js版本过低：升级Node.js至22及以上，推荐用nvm管理版本（避免系统冲突）；

1网络问题：检查网络连接，切换网络或重新设置npm镜像源，若无法访问GitHub，可尝试科学上网；

1杀毒软件拦截：暂时关闭杀毒软件，安装完成后再开启。

5.2 启动失败

1端口被占用：输入命令更换端口启动：openclaw start –port 3001（3001可替换为其他未占用端口）；

1服务配置异常：重新运行安装向导：openclaw onboard –install-daemon；

1程序损坏：卸载后重新安装，卸载命令：npm uninstall -g openclaw，再删除目录~/.openclaw/。

5.3 中文界面设置

1官方原生中文：打开Web控制台（openclaw dashboard），在设置页面找到“语言”，选择“简体中文”，刷新页面即可生效；

1社区汉化版（更完整）：先卸载原版，再安装汉化版，命令如下：          npm uninstall -g openclaw          npm install -g @qingchencloud/openclaw-zh@latest安装后输入openclaw –version，版本号后带-zh后缀即成功。

5.4 Docker部署相关问题

1查看容器状态：docker compose ps；

1查看运行日志（排查故障）：docker compose logs -f openclaw-gateway；

1重启服务：docker compose restart；

1停止服务：docker compose down。

六、新手入门建议

1. 首次使用，先尝试简单指令（如“整理我的桌面文件”“提醒我明天10点开会”），熟悉操作逻辑；

2. 技能扩展：在Web控制台的“技能市场”安装常用技能，避免安装来源不明的技能，降低安全风险；

3. 数据备份：定期备份~/.openclaw/目录下的文件，避免误操作导致数据丢失；

4. 社区支持：遇到问题可访问官方文档（docs.openclaw.ai）或社区论坛，获取最新解决方案；

5. 安全提示：不要随意授予软件过高权限，定期更新软件版本，规避安全漏洞。