首次使用OpenClaw需依次完成：一、安装Node.js v22+及npm、git；二、任选脚本或npm方式安装CLI；三、运行openclawstart完成模型与通信绑定；四、通过飞书/Telegram发送文件复制指令验证链路；五、安装并加载browser-relay浏览器扩展。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚下载 OpenClaw，但尚未启动或配置成功，则可能是由于环境依赖缺失、模型未授权或通信通道未绑定导致服务无法响应。以下是完成首次使用的多种可行方法：
一、确认并安装基础运行环境
OpenClaw 依赖特定版本的 Node.js 才能正常加载模块与执行 CLI 命令，低于要求版本将直接报错退出，且不会提示具体原因。必须确保系统已就绪，否则后续所有步骤均无效。
1、打开终端（Windows 使用 PowerShell，macOS/Linux 使用 Terminal），输入 node -v 查看当前版本；
2、若输出版本号低于 v22.0.0，需立即升级：Windows 用户执行 nvm install 22 && nvm use 22，macOS 用户通过 Homebrew 执行 brew install node@22 && brew link --force node@22；
3、运行 npm -v 和 git --version 确认二者均已安装；
4、如任一命令报“command not found”，请分别前往 https://nodejs.org/zh-cn 与 https://git-scm.com/downloads 下载并完成标准安装。
二、选择并执行最简安装方式
不同操作系统对路径权限、Shell 兼容性及后台服务注册机制存在差异，单一安装方式可能失败。提供三种互不依赖的安装路径，任选其一即可完成 CLI 工具部署。
1、macOS / Linux 用户在终端中粘贴并执行：curl -fsSL https://openclaw.ai/install.sh | bash；
2、Windows 用户以管理员身份打开 PowerShell，依次执行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，再执行：iwr -useb https://openclaw.ai/install.ps1 | iex；
3、所有平台通用方式：在终端中运行 npm install -g openclaw@latest，安装完成后验证：openclaw --version 应返回有效版本号。
三、启动向导并完成首次配置
安装仅部署工具链，真正启用功能需通过交互式向导绑定模型与通信端口。该过程不可跳过，且必须在联网状态下完成 API 密钥校验与 OAuth 授权。
1、在终端中输入 openclawstart 启动服务；
2、当出现提示 Welcome to OpenClaw Onboarding 时按回车进入配置流程；
3、使用方向键高亮选择模型服务商（推荐新手选 ZhipuAI 或 Kimi），回车确认；
4、粘贴从智谱开放平台获取的 API Key，必须包含末尾等号，否则认证失败；
5、在通信方式中选择 Feishu 或 Telegram，按屏幕提示完成 OAuth 流程或填写 App ID/Secret。
四、验证指令执行能力
配置完成后，OpenClaw 已具备解析自然语言并触发本地操作的能力。此时需发送一条结构完整、对象明确、路径可访问的指令，用以触发真实文件系统动作，从而确认整条链路畅通。
1、打开已绑定的飞书或 Telegram，找到对应 Bot 账号；
2、发送严格符合格式的指令：把桌面上名为“测试.txt”的文件复制到D盘根目录，并重命名为“验证成功.txt”；
3、等待 3–8 秒，观察 Bot 是否返回含 File copied successfully 的日志；
4、立即前往目标路径（如 D:\）手动确认文件存在且内容未损坏。
五、启用浏览器自动化扩展
默认状态下 OpenClaw 无法操控浏览器界面，必须显式安装 relay 扩展并将其加载至 Chrome 或 Edge，否则所有涉及网页跳转、表单填写、截图类指令将静默失败。
1、确保 Chrome 或 Edge 已更新至最新稳定版；
2、在 OpenClaw 控制台中输入命令：/install-browser-relay；
3、复制控制台输出的扩展绝对路径（形如 C:\Users\XXX\AppData\Local\openclaw\browser-relay）；
4、打开 Chrome 浏览器，进入 chrome://extensions，开启右上角“开发者模式”，点击“加载已解压的扩展程序”，粘贴并选择该路径。
