夜雨聆风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 助手了。
================================================================================
