OpenClaw（小龙虾）安装教程

什么是 OpenClawOpenClaw中文昵称小龙虾是一个开源的AI助手平台可以让你通过多种渠道如Telegram、WhatsApp、Discord等与AI助手交互。它支持本地运行保护隐私并且高度可定制。系统要求操作系统macOS、Linux 或 Windows推荐使用 WSL2Node.js版本 22 或更高内存至少 4GB RAM推荐 8GB存储空间至少 2GB 可用空间安装方法推荐方法一一键安装脚本最简单macOS / Linux / WSL2# 使用 curl 下载并运行安装脚本 curl -fsSL https://openclaw.ai/install.sh | bashWindowsPowerShell# 使用 PowerShell 安装 iwr -useb https://openclaw.ai/install.ps1 | iex方法二通过 npm 安装已有 Node.js 环境# 1. 安装 OpenClaw npm install -g openclawlatest # 2. 如果遇到 sharp 库构建错误尝试 SHARP_IGNORE_GLOBAL_LIBVIPS1 npm install -g openclawlatest # 3. 运行初始化向导 openclaw onboard --install-daemon方法三通过 pnpm 安装# 1. 安装 OpenClaw pnpm add -g openclawlatest # 2. 批准构建脚本首次安装时需要 pnpm approve-builds -g # 3. 重新运行安装以执行 postinstall 脚本 pnpm add -g openclawlatest # 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常见问题解决问题 1openclaw命令找不到# 检查 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问题 2sharp 库安装失败# 方法 1忽略系统 libvips SHARP_IGNORE_GLOBAL_LIBVIPS1 npm install -g openclawlatest # 方法 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 openclawlatest # 更好的解决方案修复 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 APIDiscord创建 Discord 机器人Web Chat内置 Web 聊天界面配置方法参考官方文档或运行openclaw help查看详细指南。更新和卸载更新 OpenClaw# 通过 npm 更新 npm update -g openclawlatest # 或重新运行安装脚本 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 助手平台通过简单的安装步骤即可在本地部署。它提供了隐私保护数据本地处理多平台支持多种消息渠道高度可定制技能扩展和模型选择开源免费完全开源社区驱动按照本教程的步骤你应该能够顺利安装并开始使用 OpenClaw。如果在安装过程中遇到问题可以查阅官方文档或加入社区寻求帮助。官方资源文档https://docs.openclaw.aiGitHubhttps://github.com/openclaw/openclaw社区https://discord.com/invite/clawd祝你使用愉快