1. 跨平台安装OpenClaw(小龙虾)全攻略
OpenClaw(小龙虾)作为一款新兴的AI开发工具链,其跨平台特性让开发者可以在不同操作系统上快速搭建AI应用环境。本文将详细演示Windows、macOS和Linux三大平台下的完整安装流程,包含你可能遇到的所有技术细节和避坑指南。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:打好基础才能事半功倍
2.1 Windows系统准备
在Windows上安装OpenClaw需要先配置好两个核心工具:
Node版本管理工具(nvm-windows)安装:
- 访问官方GitHub发布页下载最新nvm-setup.exe
- 安装时注意勾选"Add to PATH"选项(默认不勾选)
- 安装完成后必须重启所有终端窗口才能使环境变量生效
常见问题:如果遇到权限错误,请确保使用管理员身份运行PowerShell。Windows 11新版终端默认不是管理员权限,需要右键显式选择"以管理员身份运行"。
Git安装注意事项:
- 安装向导中选择"Use Git and optional Unix tools from the Command Prompt"(这将把git添加到系统PATH)
- 换行符配置选择"Checkout as-is, commit Unix-style line endings"(避免后续脚本执行问题)
- 安装完成后必须重启终端,否则git命令可能无法识别
2.2 macOS环境配置
macOS用户推荐使用Homebrew进行依赖管理:
bash复制# 安装Homebrew(如已安装可跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装nvm和git
brew install nvm git
# 配置nvm环境(添加到~/.zshrc或~/.bash_profile)
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
source ~/.zshrc
2.3 Linux系统准备
对于基于Debian的发行版(如Ubuntu):
bash复制sudo apt update
sudo apt install -y git curl build-essential
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
对于RHEL系(如CentOS):
bash复制sudo yum install -y git curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
3. Node.js版本管理实战
3.1 多版本Node.js管理
无论哪个平台,nvm的基本使用命令一致:
bash复制# 安装指定Node版本(推荐LTS版本)
nvm install 20.14.0
# 切换使用版本
nvm use 20.14.0
# 设置默认版本
nvm alias default 20.14.0
版本选择建议:OpenClaw官方推荐Node 18+,但实测20.x LTS版本兼容性更好。避免使用奇数版本(如19.x),这些是非LTS版本。
3.2 常见问题排查
Windows特有问题:
- 如果nvm命令无效,检查环境变量PATH是否包含nvm安装目录(默认在
C:\Users\[用户]\AppData\Roaming\nvm) - 出现"exit status 1"错误时,尝试删除nvm安装目录下的
settings.txt文件后重试
macOS/Linux权限问题:
bash复制# 如果遇到EACCES权限错误
sudo chown -R $(whoami) ~/.nvm
4. OpenClaw核心安装流程
4.1 Windows PowerShell安装
powershell复制# 先设置执行策略(只需执行一次)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 官方一键安装命令
iwr -useb https://openclaw.ai/install.ps1 | iex
安全提示:执行远程脚本前,建议先检查脚本内容:
iwr -useb https://openclaw.ai/install.ps1 | Select-Object -ExpandProperty Content
4.2 macOS/Linux安装
bash复制# 使用curl安装
bash <(curl -s https://openclaw.ai/install.sh)
# 或使用wget
bash <(wget -qO- https://openclaw.ai/install.sh)
4.3 安装后初始化
安装完成后会自动进入配置向导,若意外退出可手动启动:
bash复制openclaw onboard --flow quickstart
配置流程包含:
- 模型选择(Qwen/GPT等)
- API密钥设置
- 联网搜索功能配置
- 插件管理
实测建议:初次使用建议选择Qwen模型,它对中文支持更好且无需API密钥即可体验基础功能。
5. 服务管理与故障排查
5.1 核心服务命令
bash复制# 启动网关服务
openclaw gateway start
# 查看服务状态
openclaw status
# 实时日志监控(调试必备)
openclaw logs follow
# 重置配置
openclaw config reset
5.2 常见问题解决方案
网关连接失败:
- 检查18789端口是否被占用:
netstat -ano | findstr 18789(Windows) - 尝试指定不同端口:
openclaw gateway start --port 18888
插件加载异常:
bash复制# 重新安装核心插件
openclaw plugins reinstall @openclaw/core
Web界面无法访问:
- 先确认网关服务已启动
- 尝试禁用防火墙临时测试:
sudo ufw disable(Linux/macOS)
6. 多平台使用技巧
6.1 Windows优化建议
- 在PowerShell配置文件中添加别名:
powershell复制Add-Content $PROFILE "function oc { openclaw $args }"
- 使用Windows Terminal替代默认终端,支持多标签和更好看的UI
6.2 macOS效率提升
bash复制# 创建桌面快捷方式
ln -s $(which openclaw) ~/Desktop/openclaw
# 使用iTerm2的分屏功能同时查看日志和操作
6.3 Linux生产环境部署
bash复制# 创建systemd服务(以Ubuntu为例)
sudo tee /etc/systemd/system/openclaw.service <<EOF
[Unit]
Description=OpenClaw AI Gateway
[Service]
ExecStart=$(which openclaw) gateway start
Restart=always
User=$(whoami)
[Install]
WantedBy=multi-user.target
EOF
# 启用服务
sudo systemctl enable --now openclaw
7. 进阶配置与优化
7.1 模型缓存管理
OpenClaw默认会下载模型到~/.openclaw/cache,可通过环境变量修改:
bash复制# 更改缓存位置(适用于SSD空间不足的情况)
export OPENCLAW_CACHE_DIR="/mnt/data/.openclaw_cache"
7.2 网络代理配置
如果需要通过代理访问:
bash复制# 设置HTTP代理
openclaw config set proxy.http http://proxy.example.com:8080
# 或者使用环境变量
export HTTP_PROXY="http://proxy.example.com:8080"
7.3 插件开发环境
准备本地插件开发:
bash复制# 安装开发工具包
npm install -g @openclaw/cli
# 创建新插件
openclaw plugins create my-plugin
8. 安全最佳实践
- API密钥管理:
bash复制# 使用系统密钥环存储(推荐)
openclaw config set api_key --secure
- 定期更新:
bash复制# 检查更新
openclaw update check
# 执行更新
openclaw update apply
- 访问控制:
bash复制# 限制只允许本地访问
openclaw gateway start --host 127.0.0.1
