OpenClaw（龙虾）部署手册：Windows 与 Linux 系统指南
一、部署前通用准备（必看，两大系统都需要）
1.1 硬件要求（普通电脑即可满足）
- 最低配置：2 核 CPU、4GB 内存、50GB 空闲硬盘（仅运行基础功能，不加载本地大模型）；
- 推荐配置：4 核 CPU、8GB+ 内存、100GB SSD（流畅运行多任务，加载轻量本地模型无压力）；
- 特殊说明：若需离线使用、加载本地大模型（如 Qwen、Llama），需 16GB+ 内存，优先选择 NVIDIA 显卡（RTX 3060 及以上），提升运行速度。
1.2 必备工具与账号（提前准备，避免中途卡壳）
- 网络：保证网络通畅，能正常访问 GitHub（拉取依赖必备）；若使用云端大模型，需确保网络能对接对应 API（国内用户优先选国内模型，无需特殊配置）；
- 模型 API Key：部署后需要用大模型驱动龙虾，新手推荐使用智谱 GLM-4.7（中文友好、免费额度充足），获取方法：打开智谱开放平台（open.bigmodel.cn）→ 注册登录 → 进入控制台 → 找到'API Keys'→ 创建并复制 Key（一串以 sk-开头的密钥），存到记事本备用（重要，别泄露）；
- 基础工具：两大系统均需安装 Node.js（核心依赖）和 Git（源码拉取工具），下文会分系统详细说明安装步骤，全程默认下一步即可。
1.3 注意事项
- 所有安装路径、文件夹名称，全程不要有中文、空格、特殊符号（比如'D:\Tools\OpenClaw'是正确的）；
- 安装过程中，若弹出'权限请求''是否允许'，一律点击'允许''确定'；
- 遇到报错不要慌，先看本文'常见问题排查'部分，90% 的问题都能解决；
- API Key 是核心密钥，不要分享给他人，避免被恶意调用产生额外费用。
二、Windows 系统（Win10/11）部署步骤（小白首选，最易操作）
Windows 系统推荐'一键脚本部署'，零代码、自动化完成，5 分钟即可搞定，新手无需尝试复杂方式。
步骤 1：安装基础工具（Node.js + Git）
1.1 安装 Node.js（核心依赖）
- 打开 Node.js 官方网站（https://nodejs.org/），官网会自动推荐适配 Windows 系统的版本，优先选择LTS 长期支持版（如 v22 LTS），稳定性更高；
- 下载完成后，双击安装包，全程点击'下一步'，重点步骤：在「Tools」环节，务必勾选「Automatically install the necessary tools…」（自动安装必要工具）；
- 安装完成后，关闭所有已打开的终端（命令提示符、PowerShell），重新打开一个，输入命令
node -v，按回车，若出现类似'v22.0.0'的版本号，说明安装成功。
1.2 安装 Git（源码拉取工具）
- 打开 Git 官方网站（https://git-scm.com/），点击「Click here to download for Windows」获取安装包；
- 双击安装包，全程点击'下一步'，无需额外设置，安装完成后，输入命令
git -v，按回车，出现版本号即安装成功。
1.3 配置国内加速镜像（可选，推荐）
国内用户直接下载依赖可能速度较慢，建议配置淘宝 npm 镜像，大幅提升下载速度：
- 按下 Win + R 组合键，输入'PowerShell'并回车，打开 PowerShell 终端；
- 复制粘贴以下命令，回车执行：
npm config set registry https://registry.npmmirror.com，执行完成后无需额外操作。
