教程类型：图文并茂详细教程
预计时间：30-60分钟
难度等级：初级到中级
适用系统：macOS / Linux
通过本教程，您将完成龙虾（OpenClaw）的完整安装配置，包括环境准备、核心安装、基础配置、测试验证和故障排查。适合完全新手到有一定技术基础的用户。
第一章：环境准备与检查
1.1 系统要求检查
在开始安装前，请确保您的系统满足以下最低要求：
- 操作系统：macOS 12+ 或 Linux 发行版
- 内存：8GB RAM（推荐16GB）
- 存储空间：10GB 可用空间
- 网络连接：稳定的互联网连接
1.2 必备工具安装
首先检查并安装必备的系统工具：
1. 检查系统工具
# 检查bash/zsh版本 echo "Shell版本检查:" echo /bin/zsh --version # 检查curl是否安装 echo "\nCURL检查:" curl --version # 检查git是否安装 echo "\nGit检查:" git --version
2. 安装缺失工具（macOS）
# 安装Homebrew（如果未安装） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 安装必备工具 brew install curl git wget # 安装Python3（如果未安装） brew install python@3.11 # 验证安装 python3 --version pip3 --version
3. 安装缺失工具（Linux）
# Ubuntu/Debian系统 sudo apt update sudo apt install -y curl git wget python3 python3-pip # CentOS/RHEL系统 sudo yum install -y curl git wget python3 python3-pip # 验证安装 python3 --version pip3 --version
第二章：龙虾核心安装
2.1 官方安装方法
推荐使用官方安装脚本，这是最简单可靠的方式：
方法一：一键安装脚本（最简单）
# 下载并运行官方安装脚本 curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/install.sh | bash # 或者使用wget wget -qO- https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/install.sh | bash
这是最推荐的安装方式，脚本会自动检测系统环境并完成所有必要安装步骤。
方法二：分步手动安装（更可控）
# 1. 创建工作目录 mkdir -p ~/.qclaw cd ~/.qclaw # 2. 克隆OpenClaw仓库 git clone https://github.com/openclaw/openclaw.git # 3. 进入项目目录 cd openclaw # 4. 安装Node.js依赖（如果需要） npm install # 5. 安装Python依赖 pip3 install -r requirements.txt # 6. 设置环境变量 echo 'export PATH="$PATH:$HOME/.qclaw/openclaw/bin"' >> ~/.zshrc echo 'export QCLAW_HOME="$HOME/.qclaw"' >> ~/.zshrc # 7. 重新加载配置 source ~/.zshrc
2.2 安装过程详解
安装过程分为以下几个关键步骤：
- 环境检测：脚本会自动检测操作系统、Python版本、Node.js版本等环境信息。
- 依赖安装：自动安装所有必要的依赖包，包括Python包、Node模块等。
- 核心组件安装：安装OpenClaw核心组件和必要的配置文件。
- 权限设置：设置正确的文件权限和执行权限。
- 环境配置：配置系统环境变量和路径。
- 验证测试：运行基本测试验证安装是否成功。
第三章：安装验证与测试
3.1 验证安装成功
安装完成后，请运行以下命令验证安装是否成功：
# 检查openclaw命令是否可用 openclaw --version # 检查配置文件 ls -la ~/.qclaw/ # 运行状态检查 openclaw status # 测试基本功能 openclaw help
3.2 常见验证问题
如果遇到验证问题，请检查以下内容：
- 环境变量：确保PATH环境变量包含openclaw路径
- 文件权限：检查相关文件是否有执行权限
- 依赖包：确认所有依赖包都已正确安装
- 网络连接：确保网络连接正常，可以访问必要资源
第四章：基础配置
4.1 配置文件说明
OpenClaw的主要配置文件位于：
~/.qclaw/config.yaml # 主配置文件 ~/.qclaw/workspace/ # 工作空间目录 ~/.qclaw/plugins/ # 插件目录 ~/.qclaw/logs/ # 日志目录
4.2 基本配置示例
创建基本配置文件：
# 创建配置文件目录
mkdir -p ~/.qclaw/config
# 创建基础配置文件
cat > ~/.qclaw/config.yaml << EOF
# OpenClaw基础配置
version: "1.0"
workspace: "~/.qclaw/workspace"
logs: "~/.qclaw/logs"
# 模型配置
models:
default: "deepseek/deepseek-chat"
available:
- "deepseek/deepseek-chat"
- "gpt-4"
- "claude-3"
# 插件配置
plugins:
enabled: true
directory: "~/.qclaw/plugins"
# 网络配置
network:
proxy: null
timeout: 30
EOF
第五章：故障排查
5.1 常见安装问题
以下是一些常见的安装问题及解决方案：
问题1：命令未找到
# 错误信息：command not found: openclaw # 解决方案： echo 'export PATH="$PATH:$HOME/.qclaw/openclaw/bin"' >> ~/.zshrc source ~/.zshrc
问题2：权限错误
# 错误信息：Permission denied # 解决方案： chmod +x ~/.qclaw/openclaw/bin/* chmod -R 755 ~/.qclaw/
问题3：依赖包缺失
# 错误信息：ModuleNotFoundError # 解决方案： pip3 install -r ~/.qclaw/openclaw/requirements.txt
5.2 日志查看
如果遇到问题，可以查看安装日志：
# 查看安装日志 tail -f ~/.qclaw/logs/install.log # 查看运行日志 tail -f ~/.qclaw/logs/runtime.log # 查看错误日志 tail -f ~/.qclaw/logs/error.log
第六章：进阶配置
6.1 自定义工作空间
您可以自定义工作空间目录：
# 创建自定义工作空间 mkdir -p /path/to/your/workspace # 更新配置文件 openclaw config set workspace "/path/to/your/workspace" # 验证配置 openclaw config get workspace
6.2 插件管理
安装和管理插件：
# 查看可用插件 openclaw plugins list # 安装插件 openclaw plugins install plugin-name # 启用/禁用插件 openclaw plugins enable plugin-name openclaw plugins disable plugin-name
第七章：后续步骤
7.1 学习资源
- 官方文档：https://docs.openclaw.ai
- GitHub仓库：https://github.com/openclaw/openclaw
- 社区支持：https://discord.com/invite/clawd
- 技能市场：https://clawhub.com
7.2 下一步建议
- 熟悉基本命令：花时间熟悉openclaw的基本命令和功能
- 安装常用技能：根据需求安装有用的技能包
- 配置个性化设置：根据使用习惯调整配置
- 加入社区：加入OpenClaw社区获取帮助和分享经验
通过以上步骤，您应该已经成功安装并配置了龙虾（OpenClaw）。如果在安装过程中遇到任何问题，请参考故障排查章节或访问官方文档获取帮助。
本教程基于OpenClaw官方文档和实际安装经验编写，旨在提供详细的安装指导。具体安装细节可能因版本更新而有所变化，请以官方最新文档为准。