夜雨聆风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. 开始尝试用自然语言命令控制你的电脑
祝你使用愉快！如果在安装过程中遇到任何问题，欢迎查阅官方文档或在社区提问。