OpenClaw 安装实践

本地部署 OpenClaw 推荐使用官方一键安装脚本，它会自动检测系统并配置环境。以下是基于最新官方文档整理的通用步骤：

一、 系统要求

• 操作系统：macOS、Linux 或 Windows（强烈建议在 Windows 上开启 WSL2 以获得最佳稳定性）。

• 环境依赖：Node.js 22+（安装脚本通常会自动处理，若手动安装请确保版本符合要求）。

二、 一键安装（推荐）

打开终端（macOS/Linux）或 PowerShell（Windows），执行对应命令：

• macOS / Linux / WSL2：

bash
bash
复制
curl -fsSL https://openclaw.ai/install.sh | bash



Windows (PowerShell)：


powershell
powershell
复制
iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动检测环境并完成安装。若你是国内用户遇到网络问题，可尝试配置 npm 国内镜像或寻找国内镜像源脚本 。
三、 初始化配置（Onboarding）
安装完成后，运行以下命令启动交互式配置向导：
bash
bash
复制
openclaw onboard

根据终端提示完成以下关键设置：


安全确认：阅读风险提示并确认。


模型提供商：选择你使用的 AI 模型（如 OpenAI、Anthropic、阿里云百炼等），并填入对应的 API Key。


运行模式：建议选择“Local”（本地运行，数据不出本地设备）。


聊天渠道：选择你希望接入的通讯工具（如 Telegram、WhatsApp 等），或者选择“Skip”暂时跳过 。


四、 启动与验证
配置完成后，你可以通过以下方式启动服务：


启动服务（前台运行）：


bash
bash
复制
openclaw start



启动服务（后台守护进程）：


bash
bash
复制
openclaw start --detach



验证状态：
服务启动后，浏览器访问 http://127.0.0.1:18789即可打开 Web 控制台。你也可以在终端执行 openclaw gateway status查看运行状态 。


五、 进阶与维护


更新版本：重新执行上述一键安装脚本即可覆盖更新。


查看日志与诊断：使用 openclaw doctor检查配置问题，或查看终端输出的日志信息。


官方文档：如需配置特定模型或渠道的详细参数，可参考 OpenClaw 官方文档。