乐于分享
好东西不私藏

OpenClaw(小龙虾)安装教程

OpenClaw(小龙虾)安装教程

什么是 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

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

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

步骤 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 助手平台,通过简单的安装步骤即可在本地部署。它提供了:

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

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

官方资源

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

祝你使用愉快!🦞