OpenClaw 本地部署教程，在个人电脑上安装和运行

如果你想最快体验 OpenClaw，而且希望它能直接访问你电脑上的文件、命令行工具和本地工作目录，那么本地 CLI 部署通常是最直接的一条路。它不是长期在线托管的最终形态，但非常适合第一阶段上手，因为你可以在自己的电脑上把模型、Gateway、Dashboard 和工具调用一整条链路先跑通。

这篇教程适合谁#

本地 CLI 部署最适合下面这些场景：

• 你第一次接触 OpenClaw，想先快速跑通一套可用环境
• 你希望它直接操作本机文件和本地命令
• 你主要在自己的电脑上使用，不急着做 24/7 长期托管
• 你想先验证模型、Dashboard 和工具能力，再考虑迁移到 VPS 或 Raspberry Pi

如果你的目标一开始就是：

• 7×24 长期在线
• 多设备远程访问
• 长期接 Telegram / WhatsApp 等渠道

那最终更适合迁移到 Linux、VPS 或 Raspberry Pi。不过本地部署仍然很值得作为第一步，因为它排障更直接、反馈也最快。

本地部署前先准备什么#

开始前，先确认下面几项：

1. 你的电脑系统正常可用
2. 已安装 Node 22.16+，更推荐 Node 24
3. 能正常访问你准备使用的模型 provider
4. 你已经准备好至少一条模型认证路径

常见 provider 包括：

• OpenAI
• Anthropic
• OpenRouter
• Ollama

如果你到这一步还没决定模型用哪家，也没关系，但最好知道后面 onboarding 会让你选。

第一步 先检查 Node 环境

本地 CLI 部署的核心运行时是 Node，所以第一步永远是先看版本。

打开终端后执行：

node -v

理想结果应该是：

• Node 22.16+ 可用
• 更推荐 Node 24

如果这里直接报：

• command not found
• 版本明显太旧

那就先去升级 Node，不要急着继续往下装 OpenClaw。

第二步 安装 OpenClaw CLI

官方提供了系统安装脚本。常见做法如下。

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后，先不要急着继续跑向导，先验证 CLI 是否已经能被当前终端识别：

openclaw --version

如果这里已经能看到版本号，说明 CLI 本体安装成功了。

第三步 运行 onboarding 完成初始化

真正让 OpenClaw 进入“可用状态”的关键步骤是 onboarding。官方最推荐的新手命令是：

openclaw onboard --install-daemon

这一步通常会帮助你完成：

• 初始配置
• 模型认证方式选择
• Gateway 服务安装
• 控制台可用性验证

对本地部署来说，我很建议把它当成默认主路径，而不是自己一项一项手工拼配置。

onboarding 过程中重点看哪几项#

第一次跑向导时，最值得关注的是这几类选择：

1. 模型认证方式

这里决定的是你后面要怎么让 OpenClaw 真正调用模型。一般来说：

• 想最直接：OpenAI / Anthropic API Key
• 想统一多家模型：OpenRouter
• 想本地模型：Ollama

2. 是否安装后台服务

如果你看到类似 install daemon 或后台服务相关提示，本地机器上通常也值得选 Yes。这样至少你关掉当前终端后，Gateway 还有机会继续保持运行，不至于每次都手动重开。

3. Dashboard 验证

向导结束前后，往往会提示你如何访问 Dashboard。建议这一步就顺手验证，不要拖到后面。

第四步 检查 Gateway 是否真的在运行

装好 CLI 不代表 Gateway 已经正常运行，向导跑完也不代表服务一定完全正常。所以接下来最值得先看：

openclaw gateway status

这条命令最适合回答：

• Gateway 现在有没有运行
• 服务有没有被正确接管
• 后面的 Dashboard 或渠道问题是不是因为中心服务根本没起来

如果这一步不正常，就先别急着接渠道或调工具。

第五步 用 doctor 做一次体检

本地部署完成后，很建议立即跑一次：

openclaw doctor

这一步的价值是：

• 快速发现运行时问题
• 提示安装和迁移异常
• 帮你确认当前环境是不是有明显短板

很多人会等到出问题才想起 doctor，其实本地第一次装完就跑一次，能省掉后面很多弯路。

第六步 打开 Dashboard 做可视化验证

接下来就可以打开控制台：

openclaw dashboard

这一步通常会：

• 输出当前可访问的 Dashboard 链接
• 在可用环境里自动帮你打开浏览器
• 在需要时附带认证参数

如果你直接手输地址时碰到 unauthorized，也优先用这条命令，不要先怀疑系统坏了。

第七步 做一次最小成功验证

本地部署的目标，不是“安装命令跑完就结束”，而是至少完成一次最小闭环验证。建议按这个顺序检查：

1. openclaw --version
2. openclaw gateway status
3. openclaw doctor
4. openclaw dashboard
5. 在 Dashboard 或本地会话里发一个简单任务

只要这 5 步都顺了，就说明：

• CLI 本体正常
• Gateway 正常
• 当前环境没有明显结构性问题
• 你已经真正拿到一个能用的本地 OpenClaw

本地部署为什么值得先做#

本地 CLI 部署最大的优势，不是“最适合所有人”，而是它非常适合作为第一阶段学习路径。

它的好处包括：

• 反馈快
• 排障直接
• 能直接接本地工具和文件
• 便于理解 OpenClaw 整套运行链路

尤其当你想体验：

• 文件操作
• 命令执行
• 本地脚本调用

本地部署会让这些能力更容易看得见。

本地部署的局限也要提前知道#

它虽然适合入门，但也有天然限制：

• 电脑休眠或关机后，系统就不再在线
• 不适合作为长期公共入口
• 多设备访问通常还要额外做远程访问配置
• 消息渠道长期在线的稳定性不如专门主机

所以更推荐的理解方式是：

• 本地 CLI 部署适合第一阶段上手
• 长期在线部署适合第二阶段迁移

本地部署后最推荐继续做什么#

如果你已经把本地链路跑通，下一步通常最值得做的是：

1. 先接一个稳定模型
2. 再接一个最简单的消息渠道
3. 再决定是否迁移到 Linux / VPS / Pi

不要一上来就同时做：

• 多 provider
• 多渠道
• 远程公网访问
• 高风险工具开放

本地阶段最重要的是把主链路看懂。

常见问题先查哪里#

如果本地部署过程中出问题，优先看这几项：

• node -v
• openclaw --version
• openclaw gateway status
• openclaw doctor
• openclaw logs --follow

这几条命令基本能覆盖：

• 运行时问题
• CLI 安装问题
• 服务启动问题
• 实时错误信息

本地 CLI 部署不是 OpenClaw 的唯一用法，但它通常是最适合新手的第一条路。只要你先把 Node、CLI、Gateway、doctor 和 Dashboard 这一套跑顺，再去接模型和渠道，整个上手过程会清晰很多。