乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > OpenClaw安装部署教程

OpenClaw安装部署教程

当前时间： 2026-06-02 08:49:52 更新时间： 2026-06-02 分类：软件教程 评论(0)

OpenClaw安装部署教程

如果你跟我一样，过去一年试过各种 AI 助手产品，最终都会遇到同一个天花板：它们能聊，但很难真的替你把事情做了。读完一篇漂亮的回复之后，你还是得自己切回邮箱、打开文件夹、手动去跑那个脚本。这种”半自动”用久了，说到底只是个会说话的搜索引擎。

OpenClaw 走的是另一条路——它的设计目标从来不是陪你聊天，而是当一台跑在你自己设备上的执行引擎。社区里有人管它叫”龙虾”（lobster，看图标就懂），但这个玩笑背后有一个严肃的架构：本地优先、Gateway 做消息路由和安全边界、工具层（Browser / Exec / Web 等）把自然语言翻译成真实的操作，然后靠一套审批/隔离机制把风险摁在安全线以内。

下面不绕弯子，直接从”怎么装起来跑通”讲起。

先把话说透：你适不适合折腾这个

OpenClaw 最适合三类人：

  • 想把 AI 接入自己的消息渠道（Telegram / Discord / WhatsApp 等），随时随地发句话就让它在服务器或本机上干活；
  • 有一堆重复性数字劳动（邮件分拣、定时报表、文件整理、Git 操作流水线化），不想每次都手写脚本；
  • 在意数据落点，工作区和配置就存在你这台机器上，不需要全量上交云端。

如果你只是想偶尔问 AI 一道题，那用网页版就够了，装这玩意反而属于杀鸡用牛刀。

装之前：一个小前置检查能救你半小时

官方明确要求的硬依赖就一条：Node.js。推荐 Node 24，最低也要 **Node 22.19+**。

先敲一行：

node -v

有输出版本号且 ≥ 22.19，可以直接跳去安装；没有的话，装 Node 这件事建议别偷懒，后面一堆工具链都靠它。Windows 用户优先用 WSL2 跑（官方也直言 WSL2 比原生 Windows 更稳），macOS 和 Linux 直接原生就行。

三种安装路径：别纠结，选完就动

① 一键脚本（强烈建议从这里开始）

这是官方首推的方式，脚本会自测系统环境、必要时帮你把 Node 也装上，然后拉 OpenClaw 并进引导流程：

# macOS / Linux / WSL2curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

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

这条命令的价值不在”省两行敲键盘”——而在于它把环境差异屏蔽掉了。你不用操心全局 bin 路径、npm prefix 或者 pnpm 有没有就位，脚本替你踩过那些坑。

② npm / pnpm 安装（你已经管着 Node 环境时用）

如果你机器上 Node 早就配好了，且你清楚自己的 npm/pnpm 全局路径没问题：

npm install -g openclaw@latestopenclaw onboard --install-daemon

用 pnpm 的话注意它会要求你显式批准 build scripts，所以要多跑一步 pnpm approve-builds -g。这不是 bug，是 pnpm 的安全策略——第一次碰见容易懵，记住这一句就够了。

③ 源码安装（你想改东西或参与贡献）

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

开发模式下可以用 pnpm gateway:watch 开热重载。

onboard 向导：这才是真正的”配置”，不是前面的安装

很多人以为 install.sh 跑完就结束了——其实真正决定 OpenClaw 能不能干活、在哪干活、安不安全的，是这个 onboarding：

openclaw onboard --install-daemon

向导会带你走过几个关键点（顺序可能因版本微调，但核心不变）：

  1. AI 模型 API Key——Claude、GPT 或其他兼容端点，挑你实际有额度的一个填上。没有 Key 的话，OpenClaw 就是一个没接大脑的空壳。
  2. Gateway 端口——默认监听 http://127.0.0.1:18789，本地回环意味着只有你这台机器能碰它，这是它安全边界的一部分。
  3. Channel（渠道）连接——比如配一个 Telegram Bot Token，你的”龙虾”就有了耳朵和嘴，能在你常用的 IM 里响应指令。
  4. Skills / 工作区——从 ClawHub 装初始技能包，决定它”会什么”。

完成后验证一下没白忙：

openclaw --versionopenclaw doctor      # 扫一遍配置健康问题openclaw gateway status

看到 Gateway running，浏览器里打开 http://127.0.0.1:18789（或用 openclaw dashboard）能看到控制面板，就算落地了。

一个容易被忽略的点：daemon / 保活

如果你打算让 OpenClaw 持续待命（而不是每次手动起一个终端窗口），--install-daemon 那一步做的事情其实很关键：

  • macOS → 写 LaunchAgent
  • Linux / WSL2 → 注册 systemd user service
  • 原生 Windows → 回退到计划任务 + 启动文件夹兜底

这些在官方的安装文档里有明确路径，但很多人跳过了，结果重启机器后就发现”咦怎么不理我了”。把它想清楚一次，后面省心很多。

装完之后，第一句话该跟它说什么

别急着去翻几十个 Skill 清单。装通之后最有效的验证方式是：给它一个真实的微小任务——比如”列出桌面上最近三天改过的文件”，或者”帮我把某个目录下的 PDF 按日期重命名”。你能看到它怎么拆指令、调工具、等你审批（如果需要），这套反馈循环才是 OpenClaw 区别于普通聊天产品的地方。

最后说句实在话：OpenClaw 的上手门槛不在”代码有多难敲”，而在你得接受它不是一个开箱即用的玩具，而是一个需要你定义边界的执行环境。装起来只要十分钟；想让它变成你的”全年无休数字员工”，真正花时间的那部分是：把你的工作流想清楚，然后把权限给到位、又不给过头。这个平衡做好了，它才值得你当初折腾的这一遍。

官方文档：https://docs.openclaw.ai/install · GitHub：https://github.com/openclaw/openclaw