OpenClaw（原Clawdbot／Moltbot）本地部署快速指南

# Windows 10 安装
OpenClaw 详细步骤
指南 环境准备与前置条件 系统要求检查 在开始安装
OpenClaw 之前，请确保您的 Windows 10 系统满足以下基本要求： | 组件 | 最低要求 | 推荐配置 | |——|———-|———-| | 操作系统 | Windows 10 64位 | Windows 10/11 最新版本 | | Node.js | v18.0.0+ | v22.13.1+ | | 内存 | 4GB | 8GB 或更高 | | 存储空间 | 2GB 可用空间 | 5GB 可用空间 | | 网络 | 稳定互联网连接 | 高速网络连接 | Node.js 环境安装与配置 步骤1：安装 Node.js 版本管理器（nvm-windows） “`bash # 下载 nvm-windows 安装包 # 访问 https://github.com/coreybutler/nvm-windows/releases # 下载 nvm-setup.exe 并安装 # 安装完成后验证 nvm nvm version “` 步骤2：安装指定版本的 Node.js “`bash # 查看可用的 Node.js 版本 nvm list available # 安装推荐的 Node.js v22.13.1 nvm install 22.13.1 # 使用该版本 nvm use 22.13.1 # 设置为默认版本 nvm on # 验证安装 node openclaw 部署 –version npm –version “` 如果使用 nvm 遇到问题，也可以直接从 Node.js 官网下载安装包进行安装 [ref_2]。 Visual C++ 构建工具安装
OpenClaw 的部分依赖需要 C++ 编译环境，需要安装 Visual Studio Build Tools： “`bash # 下载并安装 Visual Studio Build Tools # 访问 https://visualstudio.microsoft.com/visual-cpp-build-tools/ # 安装时选择 “C++ build tools” 工作负载 “` 缺少此工具可能导致 `npm install` 失败 [ref_5]。
OpenClaw 安装方法 方法一：使用 npm 全局安装（推荐） 步骤1：清理 Git 代理配置（如有） “`bash # 检查当前 Git 代理配置 git config –global –get http.proxy git config –global –get https.proxy # 如有配置，建议清理以避免网络问题 git config –global –unset http.proxy git config –global –unset https.proxy “` 步骤2：全局安装
OpenClaw “`bash # 使用 npm 全局安装
OpenClaw npm install -g
openclaw –ignore-scripts # –ignore-scripts 参数可避免某些编译问题 [ref_2] “` 步骤3：验证安装 “`bash # 检查
OpenClaw 是否安装成功
openclaw –version # 查看可用命令
openclaw –help “` 如果官方脚本安装失败，可以尝试手动安装方式 [ref_3]。 方法二：源码编译安装 步骤1：克隆源码 “`bash # 使用 Gitee 镜像（国内用户推荐） git clone https://gitee.com/mirrors/
openclaw.git # 或使用 GitHub git clone https://github.com/open-claw/
openclaw.git cd
openclaw “` 步骤2：配置包管理器和镜像源 “`bash # 安装 pnpm（如果未安装） npm install -g pnpm # 配置国内镜像源 pnpm config set registry https://registry.npmmirror.com/ # 验证配置 pnpm config get registry “` 步骤3：安装依赖并构建 “`bash # 安装项目依赖（约968个包） pnpm install # 构建项目 pnpm run build # 如果使用 TypeScript 开发 pnpm run build:ts “` 源码安装方式适合需要定制化开发的用户 [ref_1]。 配置与初始化 基础配置 步骤1：创建配置文件 在用户目录下创建
OpenClaw 配置文件： “`json // ~/.
openclaw/config.json { “version”: “2026.2.2”, “language”: “zh-CN”, “model”: { “provider”: “ollama”, “name”: “qwen2.5:7b” }, “skills”: { “enabled”: true, “autoUpdate”: true } } “` 步骤2：初始化
OpenClaw “`bash # 运行初始化命令
openclaw init # 或使用交互式初始化
openclaw init –interactive “` Ollama
本地模型集成（可选） 如果想要在
本地运行 AI 模型，需要安装和配置 Ollama： 步骤1：安装 Ollama “`bash # 下载 Ollama for Windows # 访问 https://ollama.ai/download 下载安装包 # 或使用 winget 安装 winget install Ollama.Ollama “` 步骤2：下载并运行模型 “`bash # 启动 Ollama 服务 ollama serve # 在另一个终端下载模型 ollama pull qwen2.5:7b # 或使用其他模型 ollama pull llama3.2:3b “` 步骤3：配置
OpenClaw 使用
本地模型 “`json // 更新配置文件 { “model”: { “provider”: “ollama”, “baseUrl”: “http://localhost:11434”, “name”: “qwen2.5:7b”, “contextWindow”: 32768 } } “`
本地模型配置可以提供更好的隐私保护和离线使用能力 [ref_6]。 启动与使用 启动
OpenClaw 服务 步骤1：启动 API 网关 “`bash # 启动
OpenClaw 服务
openclaw start # 或指定端口
openclaw start –port 3000 # 后台运行
openclaw start –daemon “` 步骤2：访问 Web 界面 打开浏览器访问：`http://localhost:3000` 或 `http://localhost:3000/dashboard` 创建桌面快捷方式 为了方便日常使用，可以创建桌面快捷方式： “`bash # 创建启动脚本 echo ‘@echo off cd /d %~dp0
openclaw start’ > start_
openclaw.bat # 右键批处理文件，选择”发送到”->”桌面快捷方式” “` 常见问题排查 安装问题解决 | 问题现象 | 可能
原因 | 解决方案 | |———-|———-|———-| | npm install 失败 | 网络问题或代理配置 | 配置国内镜像源，清理代理设置 [ref_1] | | 编译错误 | 缺少 C++ 构建工具 | 安装 Visual Studio Build Tools [ref_5] | | 权限不足 | Windows 用户权限 | 以管理员身份运行 PowerShell | | 命令未找到 | 环境变量未配置 | 重新安装或手动添加 PATH | 网络连接问题 “`bash # 测试网络连接 ping registry.npmjs.org # 如果连接不畅，配置淘宝镜像 npm config set registry https://registry.npmmirror.com/ npm config set disturl https://npmmirror.com/dist # 或使用 cnpm npm install -g cnpm –registry=https://registry.npmmirror.com cnpm install -g
openclaw “` 性能优化建议 对于想要获得更好体验的用户，建议： 1. 硬件加速：如果有 NVIDIA GPU，可以配置 CUDA 加速 2. 模型选择：根据硬件配置选择合适的模型大小 3. 内存管理：确保系统有足够可用内存 4. 存储优化：使用 SSD 硬盘提升加载速度 进阶配置 技能插件安装
OpenClaw 支持通过技能插件扩展功能： “`bash # 查看可用技能
openclaw skills list # 安装特定技能
openclaw skills install weather
openclaw skills install calculator # 更新所有技能
openclaw skills update –all “` 外部 API 集成 可以配置
OpenClaw 使用外部 AI 服务： “`json { “model”: { “provider”: “openai”, “apiKey”: “your-api-key”, “baseUrl”: “https://api.openai.com/v1”, “model”: “gpt-4” } } “` 通过以上详细步骤，您应该能够在 Windows 10 系统上成功安装和配置
OpenClaw，开始使用这个强大的 AI 助手工具。如果在安装过程中遇到任何问题，建议参考对应的参考资料获取更详细的故障排除信息。