Last updated on

OpenClaw 部署教程：从 0 到可用

如果你第一次接触 OpenClaw，这篇文章可以当成一份“先部署成功，再慢慢打磨”的入门指南。

它的目标很明确：

  1. 把 OpenClaw 安装到你的机器上
  2. 让 Gateway 成功启动
  3. 确认你已经可以正常使用

我不打算一上来就把所有高级玩法都塞进来。先把最小可用版本跑起来，往往才是最重要的。

OpenClaw 是什么

OpenClaw 可以理解成一个运行在你自己环境里的个人 assistant 系统。

它不只是一个聊天界面，还能逐步连接：

  • 文件系统
  • 浏览器
  • 定时任务
  • 消息渠道
  • 节点设备
  • 你自己的工作区和记忆文件

如果你想要的不只是“问一句答一句”的 AI，而是一个能真正参与日常工作流的助手，那 OpenClaw 这类系统就很值得折腾。

部署前先看官方要求

根据官方文档，OpenClaw 的基础要求至少包括：

  • Node.js 22 或更高版本
  • macOS、Linux 或 Windows
  • 如果从源码构建，需要 pnpm

如果你在 Windows 上部署，官方更推荐放在 WSL2 里运行，而不是直接在原生 Windows 环境里硬怼。

第一步：先准备 Homebrew

如果你打算比较完整地使用 OpenClaw，尤其后面还会接各种 tools，我建议先把 Homebrew 装好。

原因很简单：很多工具或者依赖，在实际折腾过程中都会更方便通过 Homebrew 安装。

所以在安装 OpenClaw 之前，先把包管理这一层准备好，后面会省很多事。

你可以先确认 Homebrew 是否已经可用：

brew --version

如果还没有，就先去 Homebrew 官方网站按你的系统方式安装：https://brew.sh/。

第二步：检查 Node.js 版本

先确认环境是否满足要求：

node -v
npm -v

如果 node -v 不是 v22.x 或更高，建议先升级。

Ubuntu / Debian 上可以这样装 Node 22：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

如果你更喜欢版本管理器，也可以用 fnm、nvm、mise 之类工具来装 Node 22。

第三步：安装 OpenClaw

官方更推荐通过 npm 全局安装：

npm install -g openclaw@latest

装完之后，再执行：

openclaw onboard --install-daemon

它通常会帮你完成第一轮初始化，比如：

  • 生成初始配置
  • 安装 Gateway 守护进程
  • 帮你完成基础设置

对第一次部署的人来说，这一步比手改配置更稳。

第四步：确认 openclaw 命令可用

安装后，先别急着改配置，先确认 CLI 是否真的装好了：

openclaw help

如果提示 openclaw: command not found，大概率是 npm 全局 bin 目录不在 PATH 里。

你可以先排查：

npm prefix -g
echo "$PATH"

如果没有把 npm 全局 bin 加进 PATH，可以在 ~/.bashrc 或 ~/.zshrc 里补上：

export PATH="$(npm prefix -g)/bin:$PATH"

然后重新开终端，或者执行：

hash -r

第五步：检查 Gateway 状态

OpenClaw 的核心服务之一就是 Gateway。很多能力最终都绕不过它。

常用命令有：

openclaw gateway status
openclaw gateway start
openclaw gateway restart

推荐顺序是：

1）先看状态

openclaw gateway status

2）如果没起来，就启动

openclaw gateway start

3）改完关键配置后，再重启

openclaw gateway restart

如果你只是临时在前台测试，也可以直接运行：

openclaw gateway run

这对调试很有用，因为你可以直接看到前台输出。

第六步：做最小配置，而不是一次配满

OpenClaw 默认会读取配置文件：

~/.openclaw/openclaw.json

如果文件不存在，它会使用安全默认值。

对新手来说，我建议先坚持一个原则：

先做最小可用配置，不要一开始就把所有渠道、工具、自动化一起打开。

比如你最先关心的通常是：

  • 工作区路径
  • 使用哪个模型
  • 是否接入消息渠道
  • 权限是否太宽

官方也提供了几种常见配置方式：

openclaw onboard
openclaw configure
openclaw config get agents.defaults.workspace

如果你喜欢图形界面，也可以打开 dashboard / control UI 来看配置。

第七步：验证是否真的可用

部署完成，不是看“进程在不在”，而是看下面这些是否真的正常：

  • openclaw status 能不能正常返回
  • openclaw doctor 有没有报明显错误
  • Gateway 是否已启动
  • 你能不能实际和它交互
  • 它能不能正确访问工作区

建议至少跑一下：

openclaw doctor
openclaw status
openclaw dashboard

这里面：

  • doctor 适合检查配置与环境问题
  • status 适合看整体状态
  • dashboard 适合进浏览器确认控制界面是否正常

最后，推荐直接用 TUI 交互

当你把基础环境跑通之后，我很推荐你直接试试 TUI：

openclaw tui

这个方式很直观，适合日常和 OpenClaw 交互，也适合刚开始熟悉系统时使用。

如果你已经把 CLI、Gateway 和基本配置都弄好了，TUI 往往是最自然的入口之一。

一个比较稳妥的部署顺序

如果你想少踩坑，我建议按这个顺序走：

  1. 先准备 Homebrew
  2. 安装 Node 22+
  3. 通过 npm install -g openclaw@latest 安装 OpenClaw
  4. 确认 openclaw help 可用
  5. 跑 openclaw onboard --install-daemon
  6. 检查 openclaw gateway status
  7. 运行 openclaw doctor
  8. 打开 openclaw tui 或 openclaw dashboard
  9. 再去接消息渠道、浏览器、cron、节点设备

这样好处是：任何一步出问题，你都知道问题大概落在哪一层，而不是所有东西一起炸掉。

部署时最容易踩的坑

1. Node 版本不对

这是最常见的问题之一。版本太旧，很多奇怪问题都会冒出来。

2. openclaw 命令装好了，但 PATH 不对

命令明明安装成功，却提示找不到。这通常不是 OpenClaw 本身的问题，而是 shell 环境没配好。

3. 一开始就给太多权限

我很不建议初始阶段就开太多高风险能力。先让系统在小范围里稳定工作，再逐步放权。

4. 只看“启动成功”，不做实际验证

很多人看到服务启动就以为部署完成了。其实真正的完成标准应该是：

你已经能稳定、持续地使用它。

关于配置，我的建议

如果你不是在做生产级部署，而是个人使用，我建议这样理解配置：

  • 先保守：安全和可控优先
  • 先简单：能跑起来比什么都重要
  • 先私有：先在自己的环境里测
  • 先逐步扩展：需要什么再开通什么

OpenClaw 不是那种“装完就结束”的工具，它更像一个逐渐长成你自己工作流形状的系统。

部署完成后，可以继续做什么

当基础部署完成后，下一步你通常会想做这些：

  • 接入 Telegram / Discord 等消息渠道
  • 配置 heartbeat 和 cron 提醒
  • 让它读写工作区文件
  • 连接浏览器做自动化
  • 配置多 Agent 或不同工作区
  • 建立记忆文件和长期工作规范

这时候你才会真正开始体会 OpenClaw 的乐趣：不是“它能不能答题”，而是“它能不能真正帮你做事”。

最后

如果你是第一次部署这类 assistant 系统，不要追求一步到位。

第一阶段的成功标准，其实很朴素：

  • 装上
  • 跑起来
  • 能交互
  • 出问题时你知道怎么查

只要这四件事做到，后面不管是美化、扩展还是自动化，都会顺很多。

等你把第一版跑通之后，再去折腾更多高级玩法，心态会轻松很多。