初次接触OpenClaw需按五步完成部署：一、确认系统（macOS≥12/WSL2/Linux Ubuntu 22.04+）、Node.js≥v22、网络畅通；二、推荐一键脚本安装；三、手动安装适用于自定义场景；四、必执行初始化配置绑定AI服务商；五、启动Dashboard并用终端输出Token登录验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您是初次接触 OpenClaw，希望在本地快速完成部署并启动 AI 代理服务，则可能是由于环境依赖未就绪或安装路径选择不当导致卡在初始化阶段。以下是针对新手用户的全流程安装操作指南：
一、确认系统与基础环境是否满足
OpenClaw 要求运行环境具备最低兼容性，缺失任一条件将导致后续命令失败。该步骤旨在提前识别并规避常见硬性门槛。
1、检查操作系统版本：macOS 必须为 12 及以上版本；Windows 用户需启用 WSL2 或以管理员身份运行 PowerShell；Linux 推荐 Ubuntu 22.04+ 系统。
2、验证 Node.js 版本：必须为 v22.x 或更高版本，v20 不再兼容，v18 及以下将直接报错退出。
3、确保网络可访问 GitHub、npm registry 及目标大模型 API（如阿里云百炼、Qwen、Claude 等）。
二、一键脚本安装（推荐新手首选）
该方式由官方维护，自动检测缺失依赖、安装 Node.js（若未安装）、配置全局 CLI 并启动初始化向导，全程无需手动干预。
1、macOS / Linux 用户打开终端，粘贴执行：curl -fsSL https://openclaw.ai/install.sh | bash。
2、Windows 用户以管理员身份打开 PowerShell，依次执行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，回车确认后，再执行：irm https://openclaw.ai/install.ps1 | iex。
3、等待终端输出 Installation Complete 或 服务启动成功 提示，即表示脚本执行完毕。
三、手动分步安装（适合需自定义路径或调试的用户）
当一键脚本因网络策略、权限限制或企业终端管控无法运行时，可采用此可控性更强的方式，所有命令均在用户显式控制下执行。
1、使用 Git 克隆源码：git clone https://github.com/openclaw/openclaw.git && cd openclaw。
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
2、安装项目依赖：npm install（确保当前目录为 openclaw 根目录）。
3、复制环境模板并配置模型参数：cp .env.example .env，随后用文本编辑器打开 .env 文件，填写对应模型服务商的 API_KEY 和 BASE_URL。
四、安装后必做的初始化配置
无论采用哪种安装方式，未执行初始化则无法调用 AI 模型，服务将停留在空载状态。此步骤引导用户完成 Gateway 模式、AI 提供商、消息渠道等核心选项绑定。
1、执行初始化命令：openclaw onboard --install-daemon（macOS/Linux）或 openclaw onboard --flow quickstart（Windows）。
2、在交互式菜单中，按提示选择：local 模式（非云端部署）、Qwen 或 Kimi 等可用服务商、跳过 Skills 和 Hooks（新手建议）。
3、全部确认后，终端将显示 Configuration saved successfully 并自动启动 gateway 服务。
五、验证与访问控制台
安装与配置完成后，需通过本地服务地址确认 OpenClaw 已实际响应请求，避免界面加载但后端未就绪的情况。
1、启动 Dashboard：openclaw dashboard，终端将输出类似 Dashboard listening on http://127.0.0.1:18789 的提示。
2、在浏览器中访问该地址，页面将要求输入 Token —— 此 Token 在上一步初始化完成时已打印于终端最后一行，格式为 token: abcdef123456...。
3、粘贴完整 Token 后点击登录，即可进入 OpenClaw 主界面，开始创建首个 AI Agent 任务。
