1. 部署前环境准备
在开始之前，请确保您的设备满足以下基础要求，这是安装成功的关键：
- 操作系统：
- Windows：Windows 10/11（推荐使用 WSL2 环境以获得最佳稳定性，或直接使用 PowerShell）〔1〕〔31〕。
- macOS：macOS 12 (Monterey) 及以上版本〔20〕。
- Linux：Ubuntu 20.04+、Debian 11+ 等发行版〔24〕。
- 核心依赖软件：
- Node.js：必须版本 ≥ v22（推荐 v24 LTS）。这是最常见的报错原因，请务必检查版本〔5〕〔32〕。
- Git：用于拉取项目代码和依赖〔13〕。
- Python：建议 Python 3.10+（部分插件依赖）〔1〕。
2. OpenClaw 安装步骤
根据您的操作系统，选择以下一种方式进行安装。
方案 A：Windows 一键安装（PowerShell）
powershell复制
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
〔15〕
powershell复制
iwr -useb https://openclaw.ai/install.ps1 | iex
等待终端显示 “OpenClaw installed successfully” 即表示安装成功〔13〕〔31〕。
方案 B：macOS / Linux 一键安装
在终端（Terminal）中执行以下命令：
bash复制
curl -fsSL https://openclaw.ai/install.sh | bash
该脚本会自动检测环境、安装依赖并配置路径〔15〕〔26〕。
方案 C：通用 NPM 安装（适用于已安装 Node.js 的环境）
如果您熟悉前端开发环境，可以直接通过 npm 全局安装：
bash复制
npm install -g openclaw@latest
安装完成后，可通过 openclaw –version 验证是否成功〔5〕〔25〕。
3. 初始化配置 (Onboarding)
安装完成后，必须运行初始化向导来生成密钥和配置文件。
启动向导： 在终端输入以下命令：
bash复制
openclaw onboard
〔12〕〔33〕
配置流程指引：
- 安全风险确认：系统会提示 AI 具有文件读写权限，选择 Yes 确认继续〔28〕。
- 模式选择：新手推荐选择 QuickStart（快速启动模式）〔12〕。
- 选择模型提供商 (Provider)：
- 国内用户：推荐选择 Qwen (通义千问) 或 Ollama (本地模型)，网络连接更稳定且成本较低〔12〕〔32〕。
- 海外用户：可选择 OpenAI、Anthropic 等。
- 通信渠道 (Channels)：如果暂不需要接入 Telegram 或飞书，选择 Skip for now（稍后可在配置文件中修改）〔12〕。
- 技能安装 (Skills)：建议选择 No 跳过，后续按需安装，避免依赖冲突〔28〕。
启动服务： 配置完成后，向导通常会自动启动服务。如果未启动，可手动运行：
bash复制
openclaw gateway start
〔10〕
4. 验证与使用
访问 Web 界面： 打开浏览器访问 http://127.0.0.1:18789。首次访问可能需要 Token，Token 位于终端输出日志或配置文件 ~/.openclaw/openclaw.json 中〔10〕〔37〕。
常用管理命令：
- openclaw status：查看运行状态。
- openclaw doctor：系统健康检查（排查问题必用）。
- openclaw dashboard：直接打开 Web 控制面板。
- openclaw gateway restart：重启服务。 〔26〕〔6〕
5. 进阶配置（可选）
- 接入本地大模型 (Ollama)： 如果您希望完全离线运行，可以安装 Ollama 并下载模型（如 ollama run glm-4.7-flash），然后在 OpenClaw 中配置 Provider 为 Ollama〔32〕。
- 接入飞书/钉钉： OpenClaw 支持接入飞书等企业通讯工具。需在飞书开放平台创建应用，获取 App ID 和 App Secret，然后通过命令 openclaw config set channels.feishu… 进行配置〔5〕〔14〕。
- 开启局域网访问： 默认情况下仅本机可访问（Bind: Loopback）。如需局域网其他设备访问，需修改配置将 Bind 改为 lan〔37〕。
注意事项：OpenClaw 拥有对您电脑文件系统的操作权限，请勿在生产环境的根目录运行，建议为其设置专门的工作目录（Workspace）以确保安全〔5〕。
