30分钟快速使用OpenClaw

#
OpenClaw 跨平台一键本地部署完整指南 本文将详细解析在 Windows、macOS 和 Linux 系统上实现
OpenClaw 一键本地部署的全流程，涵盖环境准备、安装方法、配置验证和常见问题解决方案。 🛠️ 环境准备与系统要求 在开始部署前，请确保您的设备满足以下基础要求： | 组件 | 要求规格 | 验证命令 | 说明 | |——|———-|———-|——| | 操作系统 | Windows 10/11、macOS 12+、Ubuntu 20.04+ | `systeminfo`(Win) / `sw_vers`(mac) / `lsb_release -aNano Banana 教程`(Linux) | 推荐在 WSL2 环境中运行 Windows 版本 [ref_1] | | Node.js | ≥ v22（推荐 v24 LTS） | `node –version` | 这是最常见的报错原因，请务必检查版本 [ref_1][ref_5] | | Git | 最新稳定版 | `git –version` | 用于拉取项目代码和依赖 [ref_1] | | Python | 3.10+（可选） | `python –version` | 部分插件依赖 [ref_1] | 环境验证步骤 “`bash # 检查 Node.js 版本（关键步骤） node –version # 预期输出：v22.x.x 或更高 # 检查 Git 安装 git –version # 预期输出：git version 2.x.x # 检查系统架构（可选） uname -m # 确保与安装包架构匹配 “` 🚀 一键部署实施方案 根据不同的操作系统，选择对应的安装方案： 方案 A：Windows 一键安装（PowerShell） 步骤 1：解锁脚本执行权限 “`powershell # 以管理员身份打开 PowerShell，执行以下命令 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser “` 系统会提示确认，输入 `Y` 并回车 [ref_1][ref_4]。 步骤 2：执行安装脚本 “`powershell # 在 PowerShell 中执行一键安装命令 iwr -useb https://
openclaw.ai/install.ps1 | iex “` 等待终端显示 ”
OpenClaw installed successfully” 即表示安装成功 [ref_1][ref_4]。 方案 B：macOS / Linux 一键安装 “`bash # 在终端中执行以下命令 curl -fsSL https://
openclaw.ai/install.sh | bash “` 该脚本会自动检测环境、安装依赖并配置路径，适用于大多数 Linux 发行版和 macOS 系统 [ref_1][ref_2]。 方案 C：通用 NPM 安装（适用于已配置 Node.js 的环境） “`bash # 通过 npm 全局安装最新版本 npm install -g
openclaw@latest # 验证安装是否成功
openclaw –version “` 此方案适合已有 Node.js 开发环境的用户，安装过程更加透明可控 [ref_1][ref_4]。 ⚙️ 初始化配置流程 安装完成后，必须运行初始化向导完成基础配置： “`bash # 启动初始化向导
openclaw onboard “` 配置流程详细说明： | 配置步骤 | 推荐选择 | 说明 | |———|———-|——| | 安全风险确认 | `Yes` | 系统提示 AI 具有文件读写权限，确认继续 [ref_1] | | 模式选择 | `QuickStart` | 新手推荐
快速启动模式 [ref_1] | | 模型提供商 | `Qwen` 或 `Ollama` | 国内用户推荐，网络稳定成本低 [ref_1][ref_3] | | 通信渠道 | `Skip for now` | 暂不接入 IM 工具，后续可配置 [ref_1] | | 技能安装 | `No` | 避免依赖冲突，按需安装 [ref_1] | 🔍 部署验证与基础
使用 服务启动与状态检查 “`bash # 启动网关服务（如果向导未自动启动）
openclaw gateway start # 检查服务运行状态
openclaw status # 系统健康检查（排查问题必用）
openclaw doctor “` Web 界面访问验证 1. 打开浏览器访问 `http://127.0.0.1:18789` 2. 获取 Token：首次访问需要 Token，位于： – 终端输出日志中 – 配置文件 `~/.
openclaw/
openclaw.json` 中 3. 登录验证：输入 Token 后应能看到
OpenClaw 控制面板 [ref_1][ref_3] 常用管理命令汇总 “`bash # 查看运行状态
openclaw status # 直接打开 Web 控制面板
openclaw dashboard # 重启服务（配置变更后）
openclaw gateway restart # 停止服务
openclaw gateway stop “` 🎯 进阶配置选项 接入本地大模型（Ollama） 如需完全离线运行，可配置 Ollama 本地模型： “`bash # 安装 Ollama（如尚未安装） curl -fsSL https://ollama.ai/install.sh | sh # 下载模型（示例） ollama run qwen2.5:7b # 在
OpenClaw 中配置 Provider 为 Ollama # 通过
openclaw onboard 重新配置或手动修改配置文件 “` 开启局域网访问 默认情况下仅本机可访问，如需局域网共享： “`bash # 修改绑定配置为局域网
openclaw config set bind lan # 重启服务生效
openclaw gateway restart “` 修改后可通过 `http://[你的IP]:18789` 在其他设备访问 [ref_1][ref_4]。 ❗ 注意事项与故障排查 安全注意事项 – 工作目录隔离：
OpenClaw 拥有文件系统操作权限，建议设置专门的工作目录，避免在生产环境根目录运行 [ref_1] – 网络访问控制：开启局域网访问前确保网络环境安全 [ref_4] – 定期更新：关注官方更新，及时获取安全补丁 [ref_3] 常见问题解决方案 | 问题现象 | 可能原因 | 解决方案 | |———|———-|———-| | 命令未找到 | Node.js 未正确安装或 PATH 配置问题 | 重新安装 Node.js ≥ v22，验证 `node –version` [ref_1] | | 安装脚本执行失败 | 系统权限限制或网络问题 | Windows：以管理员运行 PowerShell；检查网络连接 [ref_1][ref_4] | | 服务启动失败 | 端口冲突或依赖缺失 |
使用 `
openclaw doctor` 诊断；检查 18789 端口占用 [ref_1][ref_6] | | Web 界面无法访问 | Token 错误或服务未正常运行 | 确认服务状态，检查配置文件中的 Token [ref_1] | 通过以上完整的部署指南，您可以在任一主流操作系统上
快速完成
OpenClaw 的一键本地部署，并根据实际需求进行个性化配置。整个安装过程通常可在 3-5
分钟内完成，即使是初学者也能轻松上手 [ref_4]。