先选安装路径
| 情况 | 选哪条路径 | 原因 |
|---|---|---|
| 你熟悉终端，后面还要排查、维护、看日志 | CLI | 后续命令、状态和日志都更统一 |
| 你所在平台已经有现成安装包或首启向导 | 图形界面 | 更适合先完成一次安装和首启 |
| 你打算长期运行，后面可能会装守护进程 | CLI | 更容易继续做状态检查和日常维护 |
| 你不确定该选哪条 | CLI | 后续验证、排错和维护基本都要回到 CLI |
如果你当前平台没有现成安装包或向导，就不要继续找图形界面路径，直接用 CLI。
方式一：CLI 安装
如果你准备在终端里完成安装，按这个顺序执行：
npm install -g openclaw@latest然后确认命令已经可用：
openclaw --version版本能正常输出后，继续执行首次引导：
openclaw onboard如果你准备把它作为长期运行的服务，直接安装守护进程：
openclaw onboard --install-daemon--install-daemon 会把 OpenClaw 装成后台持续运行的服务，更适合长期运行和后续维护。
如果你只是第一次装机、先想跑通一次，先执行 openclaw onboard 就够了。
CLI 路径里，优先记住这 3 个点：
npm install -g成功后，先看openclaw --version，不要立刻去改配置。- 如果引导过程报权限、目录或凭据错误，先解决当前问题，不要马上改走图形界面。
- 如果安装成功但
openclaw --version不能执行，优先检查 PATH 和全局安装路径。
方式二：图形界面安装
如果你当前平台已经提供安装包或首启向导，也可以直接走图形界面。
图形界面路径只看 3 件事：
- 安装流程能完整结束；
- 首次启动不中断；
- 应用已经进入可用状态。
如果图形界面安装过程中出现权限问题、首次启动失败或状态异常，不要立刻切回 CLI 重装，先保留当前路径，再去验证或排查。
图形界面路径更适合“先装好再说”，但后面做验证、排错和维护时，通常还是要回到 CLI 命令。
收尾判断
不管你刚才走的是 CLI 还是图形界面，装完后都不要直接进入配置页，先做成功验证。