小龙虾安装教程

OpenClaw AI智能体框架（也称"小龙虾"），这是一个由奥地利程序员Peter Steinberger开发的免费开源AI智能体框架。OpenClaw不是聊天机器人，而是给AI装上手脚，让AI真正动手干活的数字执行引擎，能直接操作电脑、打开软件、处理文件、执行脚本等 。

我将为你提供OpenClaw在Windows、macOS和Linux三大主流操作系统下的详细安装教程，并涵盖常见问题及解决方法。

一、系统要求与准备工作

在开始安装前，请确保你的系统满足以下要求：

配置项 最低要求 推荐配置 

操作系统 Windows 10+、macOS 12+、Linux（Ubuntu 20.04+/Debian 11+） Windows 11、macOS 13+、Ubuntu 22.04+ 

内存 2GB 4GB及以上 

存储空间 500MB 10GB及以上 

CPU 双核处理器 四核或更高 

网络 需要联网调用AI API（可选Ollama本地模型离线使用） 高速稳定网络 

其他 Node.js 22+、Git（可选）、Python 3.10+（部分技能需要） pnpm包管理器（推荐） 

1.1 准备工作

1. 确认Node.js版本

OpenClaw需要Node.js 22或更高版本（推荐LTS版本）。在安装OpenClaw前，请先检查你的Node.js版本：

如果版本低于22.x，需要先升级Node.js。你可以通过以下方式安装最新版本：

2. 安装Node.js

- Windows：访问Node.js官网下载Windows LTS版本安装程序

- macOS：使用Homebrew安装： brew install node 

- Linux：使用包管理器安装（如Ubuntu/Debian： sudo apt install nodejs ）

3. 安装Git（可选但推荐）

Git用于克隆仓库和安装技能：

- Windows：下载Git for Windows，安装时勾选"Add to PATH"

- macOS： brew install git 

- Linux： sudo apt install git （Ubuntu/Debian）或 sudo dnf install git （Fedora）

4. 推荐安装pnpm

pnpm比npm更快且节省硬盘空间，强烈推荐使用：

二、Windows平台安装教程

2.1 方法一：使用官方一键脚本（推荐）

这是最简单快速的安装方式，适合大多数用户：

步骤1：以管理员身份运行PowerShell

按 Win + X 键，选择"Windows PowerShell (管理员)"或"终端 (管理员)"。如果出现用户账户控制（UAC）提示，点击"是"。

步骤2：设置执行策略（首次运行需要）

首次运行PowerShell脚本需要修改执行策略：

出现提示时输入 Y 并回车确认。

步骤3：执行安装脚本

国内用户加速版（如果官方脚本速度慢）：

步骤4：等待安装完成

安装过程会自动完成以下操作：

- 检测并安装Node.js（如果未安装）

- 安装OpenClaw核心程序

- 配置环境变量

- 安装必要的依赖

整个过程通常需要3-8分钟，请耐心等待。

步骤5：验证安装

安装完成后，运行以下命令验证：

如果输出了版本号（如v2026.2.22），说明安装成功！

2.2 方法二：手动安装（适合高级用户）

如果你已经熟悉Node.js环境，可以选择手动安装：

步骤1：安装Node.js

访问Node.js官网下载LTS版本（推荐v22.x），运行安装程序，按提示完成安装。验证安装：

步骤2：全局安装OpenClaw

打开PowerShell（管理员权限），执行：

国内用户加速安装：

2.3 方法三：使用国内版openclaw-cn

国内用户推荐使用 openclaw-cn ，针对国内网络环境优化：

验证安装：

三、macOS平台安装教程

3.1 方法一：使用官方一键脚本（推荐）

步骤1：打开终端

按 Command + 空格 打开Spotlight搜索，输入"终端"或"Terminal"，按回车打开终端。

步骤2：执行安装脚本

国内用户加速版：

步骤3：等待安装完成

脚本会自动检测系统环境并安装所需组件，包括：

- Homebrew（如果未安装）

- Node.js

- OpenClaw核心程序

3.2 方法二：使用Homebrew手动安装

步骤1：安装Homebrew（如果未安装）

安装完成后，根据提示将Homebrew添加到PATH：

步骤2：安装Node.js

验证安装：

步骤3：全局安装OpenClaw

国内用户加速安装：

3.3 方法三：使用国内版openclaw-cn

验证安装：

四、Linux平台安装教程

4.1 方法一：使用官方一键脚本（推荐）

步骤1：打开终端

根据你的Linux发行版，使用快捷键打开终端：

- Ubuntu/Debian： Ctrl + Alt + T 

- Fedora： Ctrl + Alt + T 

- 其他发行版：在应用菜单中搜索"终端"

步骤2：更新系统包管理器

- Ubuntu/Debian：

- Fedora：

- Arch Linux：

步骤3：安装必要的依赖

- Ubuntu/Debian：

- Fedora：

- Arch Linux：

步骤4：执行安装脚本

国内用户加速版：

4.2 方法二：使用包管理器手动安装

步骤1：安装Node.js

- Ubuntu/Debian（使用NodeSource）：

- Fedora：

- Arch Linux：

验证安装：

步骤2：安装Git

- Ubuntu/Debian：

- Fedora：

- Arch Linux：

步骤3：全局安装OpenClaw

国内用户加速安装：

4.3 方法三：使用nvm安装Node.js（推荐开发者）

步骤1：安装nvm（Node Version Manager）

步骤2：重新加载配置文件

步骤3：安装最新LTS版本的Node.js

步骤4：全局安装OpenClaw

五、从源代码安装（高级用户）

如果你想修改代码或使用最新开发版本，可以从GitHub克隆源代码安装：

步骤1：克隆GitHub仓库

步骤2：安装依赖并构建

步骤3：运行初始化向导

国内用户注意：为了确保国内访问速度，建议从Gitee镜像仓库下载：

在安装依赖前，务必设置pnpm镜像源以加速下载：

六、使用Docker容器安装（适合服务器环境）

如果你需要在服务器或隔离环境中运行OpenClaw，可以使用Docker：

步骤1：安装Docker

确保你已经安装了Docker Engine 20+或Docker Desktop。

步骤2：拉取Docker镜像

步骤3：运行Docker容器

使用Docker Compose（推荐，支持持久化配置）：

创建 docker-compose.yml 文件：

然后运行：

七、初始化配置

安装完成后，首次使用需要进行初始化配置：

7.1 启动初始化向导

运行以下命令启动交互式配置向导：

7.2 配置步骤说明

初始化向导会引导你完成以下配置：

1. 选择AI供应商

选择Anthropic (Claude)、OpenAI (GPT)、Google (Gemini)或通过Ollama跑本地模型。随时可以在配置里切换。

2. 添加API Key

从供应商后台粘贴你的API Key。Key存在本地 .env 文件里，除了AI供应商，不会发到任何地方。

3. 连接聊天平台

接入WhatsApp（扫二维码）、Telegram（粘贴@BotFather的Bot Token）、Discord（粘贴Bot Token）或其他支持的平台。

4. 发送测试消息

通过已连接的聊天软件给OpenClaw发条消息。如果它回复了，就说明一切就绪。试试发：'你能做什么？'

7.3 直接配置DeepSeek（国内用户推荐）

中国社区提供了更便捷的DeepSeek配置方式：

在向导的"Select Provider"步骤，直接选择 DeepSeek (Recommended for CN) ，系统会自动完成所有配置。

八、验证安装

完成安装和配置后，建议进行以下验证：

1. 检查版本号

应该输出版本号（如v2026.2.22）。

2. 运行环境诊断

对你的环境做一次全面诊断检查，包括Node.js版本、依赖、配置文件和网络连接。

3. 检查服务状态

4. 打开管理界面

浏览器会自动打开http://localhost:3000，进入OpenClaw管理界面。

九、常见问题及解决方案

9.1 通用问题

问题1：权限不足

- 现象：安装时提示权限不足

- 解决方案：

- macOS/Linux：在安装命令前加 sudo ，或用nvm等Node版本管理器免root安装

- Windows：以管理员身份运行PowerShell（右键 → 以管理员身份运行）

问题2：Node.js版本太旧

- 现象：安装失败，提示需要Node.js 22+

- 解决方案：

- 用 node --version 检查版本

- 使用nvm安装最新LTS版本： nvm install --lts && nvm use --lts 

问题3：端口被占用

- 现象：启动时提示EADDRINUSE错误

- 解决方案：

- OpenClaw的Web UI默认用3000端口

- 在 .env 文件里设置自定义端口： PORT=3001 

- 找到并关闭占用端口的进程

9.2 Windows平台问题

问题1：PowerShell执行策略错误

- 现象：无法加载文件，因为在此系统上禁止运行脚本

- 解决方案：

出现提示时输入 Y 并回车确认

问题2：找不到openclaw命令

- 现象：输入openclaw提示"无法将"openclaw"项识别为 cmdlet"

- 解决方案：

- 重启PowerShell或终端

- 检查环境变量PATH是否包含npm全局安装路径

- 手动添加路径：

问题3：WSL2相关问题

- 建议：OpenClaw在Windows上推荐通过WSL2使用

- 解决方案：

- 先安装WSL2：在PowerShell里运行 wsl --install 

- 然后在WSL2 Linux环境里安装OpenClaw，不要在原生Windows里装

- WSL2的网络访问和文件系统性能更好

9.3 macOS平台问题

问题1：权限被拒绝

- 现象：npm安装时提示权限错误

- 解决方案：

问题2：Homebrew安装失败

- 现象：无法安装Homebrew或安装过程中出错

- 解决方案：

- 确保网络连接正常

- 使用国内镜像安装Homebrew：

问题3：命令找不到

- 现象：输入openclaw提示command not found

- 解决方案：

- 检查Shell配置文件（ .zshrc 或 .bash_profile ），确保PATH配置正确

- 将npm全局路径添加到PATH：

9.4 Linux平台问题

问题1：权限不足

- 现象：npm安装时权限错误

- 解决方案：

或配置npm全局安装目录权限：

问题2：Node.js版本过低

- 解决方案：使用nvm安装最新版本

问题3：依赖包编译失败

- 现象：安装过程中出现编译错误

- 解决方案：安装编译工具

- Ubuntu/Debian：

- Fedora：

9.5 网络相关问题

问题1：安装脚本下载缓慢

- 现象：官方安装脚本下载速度极慢

- 解决方案：

- 使用国内镜像：

问题2：npm安装速度慢

- 解决方案：配置国内镜像源

问题3：无法访问OpenAI/Anthropic API

- 解决方案：

- 配置代理：

- 使用本地模型（如Ollama）

- 使用DeepSeek等国内模型服务

9.6 其他问题

问题1：WhatsApp二维码不显示

- 现象：运行 openclaw onboard 时，WhatsApp二维码无法显示

- 解决方案：

- 确保在支持二维码渲染的终端里运行

- 如果二维码显示不出来，换个终端模拟器试试

- 无头服务器上可以用WebChat界面扫码

问题2：API Key无法识别

- 现象：配置API Key后仍然提示认证错误

- 解决方案：

- 仔细检查API Key是否正确且未过期

- 确认在 ~/.openclaw/.env 里用了正确的变量名（如ANTHROPIC_API_KEY、OPENAI_API_KEY）

- 改完Key后重启OpenClaw

问题3：Docker容器启动失败

- 现象：Docker容器启动后立即崩溃

- 解决方案：

- 用 docker logs openclaw 查看日志

- 常见原因：缺少环境变量（用-e参数传API Key）、内存不足（至少分配512MB）、端口冲突

- 确保安装了Docker Engine 20+

十、安装完成后的配置建议

10.1 配置本地AI模型（推荐）

如果你想在本地运行AI模型，可以配置Ollama：

步骤1：安装Ollama

步骤2：拉取模型

步骤3：配置OpenClaw使用本地模型

10.2 安装技能扩展

OpenClaw支持通过ClawHub安装各种技能：

10.3 安全配置建议

1. 定期更新OpenClaw：

2. 备份配置文件：

OpenClaw的配置文件位于 ~/.openclaw 目录，建议定期备份。

3. 限制权限：

- 不要将OpenClaw配置为root权限运行

- 对敏感技能设置访问控制

十一、开始使用OpenClaw

安装和配置完成后，你可以通过以下方式与OpenClaw交互：

1. 命令行交互

2. 管理界面

运行 openclaw dashboard ，在浏览器中访问http://localhost:3000，通过Web界面管理和控制OpenClaw。

3. 聊天平台

如果配置了Telegram、Discord等聊天平台，可以通过这些平台与OpenClaw对话。

4. 第一个任务示例

试试给OpenClaw下达第一个指令：

"请帮我在桌面上创建一个名为hello_openclaw.txt的文件，并在里面写入：大道至简，实战落地。"

OpenClaw将会自动规划任务、调用文件系统API，并完成操作。

结语

通过本教程，你应该已经成功在Windows、macOS或Linux平台上安装并配置了OpenClaw。OpenClaw作为一个强大的本地AI执行框架，能够让AI真正"动手干活"，帮你完成各种重复性、流程化的任务。

安装要点回顾：

- Windows：推荐使用PowerShell一键脚本，记得先设置执行策略

- macOS：推荐使用Homebrew或官方脚本，确保安装了Xcode命令行工具

- Linux：根据发行版选择合适的包管理器，推荐使用nvm管理Node.js版本

下一步建议：

1. 配置你的AI模型API Key或本地模型

2. 探索ClawHub技能市场，安装你需要的技能

3. 加入OpenClaw社区（Discord），与其他用户交流经验

4. 开始尝试用自然语言命令控制你的电脑

祝你使用愉快！如果在安装过程中遇到任何问题，欢迎查阅官方文档或在社区提问。