什么是 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. 安装 OpenClawnpm install -g openclaw@latest# 2. 如果遇到 sharp 库构建错误,尝试:SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest# 3. 运行初始化向导openclaw onboard --install-daemon
方法三:通过 pnpm 安装
# 1. 安装 OpenClawpnpm 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初始化向导会引导你完成:
设置工作目录 安装 Gateway 守护进程 配置基本设置
步骤 4:验证安装
# 检查 CLI 是否可用openclaw --version# 检查 Gateway 状态openclaw status# 运行健康检查openclaw doctor# 打开 Web 控制台openclaw dashboard
常见问题解决
问题 1:openclaw 命令找不到
# 检查 PATH 环境变量echo $PATH# 添加 npm 全局安装路径到 PATHexport PATH="$(npm prefix -g)/bin:$PATH"# 永久添加到 shell 配置文件(~/.zshrc 或 ~/.bashrc)echo 'export PATH="$(npm prefix -g)/bin:PATH
配置和使用
基本命令
# 启动 Gatewayopenclaw gateway start# 停止 Gatewayopenclaw gateway stop# 重启 Gatewayopenclaw 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
# 卸载 CLInpm uninstall -g openclaw# 删除配置和数据# 默认位置:~/.openclawrm -rf ~/.openclaw
高级功能
技能扩展
OpenClaw 支持技能(Skills)扩展,可以安装各种功能模块:
# 查看可用技能openclaw skills list# 安装技能openclaw skills install
自定义模型
支持多种 AI 模型:
OpenAI GPT 系列 Anthropic Claude 本地模型(通过 Ollama) 自定义 API 端点
总结
OpenClaw(小龙虾)是一个功能强大且灵活的 AI 助手平台,通过简单的安装步骤即可在本地部署。它提供了:
- 隐私保护
:数据本地处理 - 多平台支持
:多种消息渠道 - 高度可定制
:技能扩展和模型选择 - 开源免费
:完全开源,社区驱动
按照本教程的步骤,你应该能够顺利安装并开始使用 OpenClaw。如果在安装过程中遇到问题,可以查阅官方文档或加入社区寻求帮助。
官方资源:
文档:https://docs.openclaw.ai GitHub:https://github.com/openclaw/openclaw 社区:https://discord.com/invite/clawd
祝你使用愉快!🦞
夜雨聆风