OpenClaw 安装教程(Windows + WSL2)
================================================================================
一、安装前环境准备
================================================================================
1.1 硬件与系统要求
─────────────────────────────────────────────────────────────────────────────
项目 最低要求 推荐配置
─────────────────────────────────────────────────────────────────────────────
操作系统 Windows 10(版本19041+)或 Windows 11 Windows 11
内存 4GB 8GB 或以上
磁盘空间 20GB 可用空间 SSD,30GB+
处理器 双核 四核及以上
─────────────────────────────────────────────────────────────────────────────
1.2 WSL2 环境搭建
─────────────────────────────────────────────────────────────────────────────
【步骤 1:启用 WSL2】
以管理员身份打开 PowerShell,执行:
wsl --install -d Ubuntu-24.04
执行后按提示重启计算机。
【步骤 2:初始化 Ubuntu】
重启后 Ubuntu 终端会自动打开,按提示设置:
• 用户名(建议与 Windows 用户名一致)
• 密码(输入时不显示,正常现象)
【步骤 3:启用 systemd(必须)】
在 Ubuntu 终端中执行:
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
【步骤 4:重启 WSL 使配置生效】
回到 PowerShell:
wsl --shutdown
重新打开 Ubuntu 终端,验证 systemd:
systemctl --user status
【步骤 5:更新系统】
sudo apt update && sudo apt upgrade -y
================================================================================
二、安装前工作准备(API Key)
================================================================================
2.1 选择 AI 模型提供商
─────────────────────────────────────────────────────────────────────────────
OpenClaw 支持多种模型,以下是常用免费/低成本方案:
提供商 模型 费用 适用场景
─────────────────────────────────────────────────────────────────────────────
DeepSeek DeepSeek-V3 极低成本 通用任务,国内访问快
Google Gemini Gemini 2.0 Flash 免费(有限额) 快速响应
Groq Llama 3.3 70B 免费(限速) 高速度需求
OpenAI GPT-4o mini 付费 高质量任务
─────────────────────────────────────────────────────────────────────────────
2.2 获取 API Key
─────────────────────────────────────────────────────────────────────────────
【推荐方案:DeepSeek(国内首选)】
1. 访问:https://platform.deepseek.com/
2. 注册账号并登录
3. 进入 API Keys 页面
4. 创建新的 API Key(形如:sk-xxxxxxxx)
5. 保存 Key(仅显示一次)
【备选方案:Google Gemini】
1. 访问:https://aistudio.google.com/apikey
2. 登录 Google 账号
3. 创建 API Key
【备选方案:Groq】
1. 访问:https://console.groq.com/keys
2. 注册并创建 API Key
2.3 Node.js 环境检查(可选)
─────────────────────────────────────────────────────────────────────────────
安装脚本会自动安装 Node.js 22+,如需手动检查:
node --version # 应显示 v22.x.x 或更高
npm --version # 应显示 v10.x.x 或更高
================================================================================
三、正式安装 OpenClaw
================================================================================
3.1 一键安装(推荐)
─────────────────────────────────────────────────────────────────────────────
【方式 A:国内镜像(速度更快)】
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
【方式 B:官方镜像】
curl -fsSL https://openclaw.ai/install.sh | bash
安装成功后会显示:
✓ OpenClaw installed successfully!
Run "openclaw onboard" to get started.
3.2 初始化配置
─────────────────────────────────────────────────────────────────────────────
执行初始化向导:
openclaw onboard --install-daemon
按照向导提示完成以下步骤:
1. 安全确认:输入 yes 同意风险提示
2. 选择 Provider:选择 DeepSeek(如使用其他模型选择对应选项)
3. 输入 API Key:粘贴您的 DeepSeek API Key
4. 配置通道:可选择配置微信、飞书等(可跳过,稍后配置)
5. 技能配置:可跳过,稍后安装
6. 安装网关:选择安装并启动网关服务
3.3 验证安装
─────────────────────────────────────────────────────────────────────────────
执行以下命令验证:
# 健康检查
openclaw doctor
# 查看状态
openclaw status
# 打开控制面板
openclaw dashboard
预期输出:
• doctor:显示"没有发现问题"
• status:显示 running(运行中)
• dashboard:浏览器自动打开控制面板
3.4 常用命令速查
─────────────────────────────────────────────────────────────────────────────
功能 命令
─────────────────────────────────────────────────────────────────────────────
启动网关 openclaw gateway start
停止网关 openclaw gateway stop
重启网关 openclaw gateway restart
查看日志 openclaw logs follow
添加模型 openclaw agents add main --provider deepseek --key "你的Key"
设置默认模型 openclaw config set model.defaults.primary deepseek/deepseek-chat
卸载 openclaw uninstall --all --yes
3.5 第一个任务测试
─────────────────────────────────────────────────────────────────────────────
在控制面板或命令行中输入:
请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件,内容是:大道至简,实战落地。
如果成功创建文件,说明安装完成!
================================================================================
常见问题排查
================================================================================
【问题 1:openclaw 命令找不到】
export PATH="$HOME/.npm-global/bin:$PATH"
source ~/.bashrc
【问题 2:网关无法启动】
openclaw doctor --deep
【问题 3:systemd 未启用】
重新执行第1.3节的步骤,确保 /etc/wsl.conf 配置正确并重启 WSL。
【问题 4:API Key 配置错误】
openclaw agents add main --provider deepseek --key "你的新Key"
openclaw config set model.defaults.primary deepseek/deepseek-chat
openclaw gateway restart
================================================================================
恭喜!您已成功在 Windows + WSL2 环境下部署 OpenClaw。
现在可以开始探索这个强大的本地 AI 助手了。
================================================================================
夜雨聆风