OpenClaw新手该怎么入门 OpenClaw第一次使用完整指南方法深度解析|Duuu笔记
首次使用OpenClaw需依次完成：一、安装Node.js v22+及npm、git；二、任选脚本或npm方式安装CLI；三、运行openclawstart完成模型与通信绑定；四、通过飞书/Telegram发送文件复制指令验证链路；五、安装并加载browser-relay浏览器扩展。
如果您刚下载 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
），回车确认；
Action Figure AI
借助Action Figure AI的先进技术，瞬间将照片转化为定制动作人偶。
下载
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
，开启右上角“开发者模式”，点击“加载已解压的扩展程序”，粘贴并选择该路径。
