什么是 OpenClaw？

OpenClaw（中文昵称"小龙虾"）是一个开源的AI助手平台，可以让你通过多种渠道（如Telegram、WhatsApp、Discord等）与AI助手交互。它支持本地运行，保护隐私，并且高度可定制。

系统要求

• 操作系统：macOS、Linux 或 Windows（推荐使用 WSL2）
• Node.js：版本 22 或更高
• 内存：至少 4GB RAM（推荐 8GB+）
• 存储空间：至少 2GB 可用空间

安装方法（推荐）

方法一：一键安装脚本（最简单）

macOS / Linux / WSL2

# 使用 curl 下载并运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）

# 使用 PowerShell 安装
iwr -useb https://openclaw.ai/install.ps1 | iex

方法二：通过 npm 安装（已有 Node.js 环境）

# 1. 安装 OpenClaw
npm install -g openclaw@latest

# 2. 如果遇到 sharp 库构建错误，尝试：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# 3. 运行初始化向导
openclaw onboard --install-daemon

方法三：通过 pnpm 安装

# 1. 安装 OpenClaw
pnpm add -g openclaw@latest

# 2. 批准构建脚本（首次安装时需要）
pnpm approve-builds -g

# 3. 重新运行安装以执行 postinstall 脚本
pnpm add -g openclaw@latest

# 4. 运行初始化向导
openclaw onboard --install-daemon

详细安装步骤（以 macOS/Linux 为例）

步骤 1：检查系统环境

# 检查 Node.js 版本
node -v

# 检查 npm 版本
npm -v

# 如果 Node.js 版本低于 22，需要先升级

步骤 2：安装 OpenClaw

# 使用安装脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash

# 安装过程会：
# 1. 检查 Node.js 环境
# 2. 安装或更新 Node.js（如果需要）
# 3. 全局安装 openclaw
# 4. 启动初始化向导

步骤 3：初始化配置

安装完成后，会自动进入初始化向导。如果没有，可以手动运行：

openclaw onboard --install-daemon

初始化向导会引导你完成：

1. 设置工作目录
2. 安装 Gateway 守护进程
3. 配置基本设置

步骤 4：验证安装

# 检查 CLI 是否可用
openclaw --version

# 检查 Gateway 状态
openclaw status

# 运行健康检查
openclaw doctor

# 打开 Web 控制台
openclaw dashboard

常见问题解决

问题 1：openclaw 命令找不到

# 检查 PATH 环境变量
echo $PATH

# 添加 npm 全局安装路径到 PATH
export PATH="$(npm prefix -g)/bin:$PATH"

# 永久添加到 shell 配置文件（~/.zshrc 或 ~/.bashrc）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

问题 2：sharp 库安装失败

# 方法 1：忽略系统 libvips
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# 方法 2：安装构建工具
# macOS
xcode-select --install
npm install -g node-gyp

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y build-essential

问题 3：权限问题

# 如果遇到权限错误，尝试使用 sudo（不推荐）
sudo npm install -g openclaw@latest

# 更好的解决方案：修复 npm 权限
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

配置和使用

基本命令

# 启动 Gateway
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看日志
openclaw logs

# 打开 Web 界面
openclaw dashboard

连接消息渠道

OpenClaw 支持多种消息渠道：

• Telegram：通过 BotFather 创建机器人
• WhatsApp：使用 WhatsApp Business API
• Discord：创建 Discord 机器人
• Web Chat：内置 Web 聊天界面

配置方法参考官方文档或运行 openclaw help 查看详细指南。

更新和卸载

更新 OpenClaw

# 通过 npm 更新
npm update -g openclaw@latest

# 或重新运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

卸载 OpenClaw

# 卸载 CLI
npm uninstall -g openclaw

# 删除配置和数据
# 默认位置：~/.openclaw
rm -rf ~/.openclaw

高级功能

技能扩展

OpenClaw 支持技能（Skills）扩展，可以安装各种功能模块：

# 查看可用技能
openclaw skills list

# 安装技能
openclaw skills install <skill-name>

自定义模型

支持多种 AI 模型：

• OpenAI GPT 系列
• Anthropic Claude
• 本地模型（通过 Ollama）
• 自定义 API 端点

总结

OpenClaw（小龙虾）是一个功能强大且灵活的 AI 助手平台，通过简单的安装步骤即可在本地部署。它提供了：

1. 隐私保护：数据本地处理
2. 多平台支持：多种消息渠道
3. 高度可定制：技能扩展和模型选择
4. 开源免费：完全开源，社区驱动

按照本教程的步骤，你应该能够顺利安装并开始使用 OpenClaw。如果在安装过程中遇到问题，可以查阅官方文档或加入社区寻求帮助。

官方资源：

• 文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• 社区：https://discord.com/invite/clawd

祝你使用愉快！🦞