Shell / BashNode.jsAI
Ubuntu 部署 OpenClaw 完整教程
在 Ubuntu 22.04 LTS 环境下部署 OpenClaw 的完整流程。主要步骤包括更新系统包索引、安装 Node.js 及 npm 镜像配置、执行官方安装脚本、解决 PATH 环境变量问题，以及通过 SSH 隧道访问 Web 控制界面。最终实现了基于 Z.AI 模型的 Agent 初始化与本地测试。
在 Ubuntu 22.04 LTS 环境下部署 OpenClaw 的完整流程。主要步骤包括更新系统包索引、安装 Node.js 及 npm 镜像配置、执行官方安装脚本、解决 PATH 环境变量问题，以及通过 SSH 隧道访问 Web 控制界面。最终实现了基于 Z.AI 模型的 Agent 初始化与本地测试。
本文记录在 Ubuntu 22.04 服务器上从零部署 OpenClaw 并接入飞书的完整过程，包括遇到的坑和解决方法。
sudo apt update
sudo apt install -y curl
# 添加 NodeSource 仓库并安装
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 安装完成后，验证版本
node -v
npm -v
实际输出：
ubuntu@gt-ubuntu22-04-cmd-v3-0-8gb-100m:~$ node -v
v24.14.0
ubuntu@gt-ubuntu22-04-cmd-v3-0-8gb-100m:~$ npm -v
11.9.0
npm config set registry https://registry.npmmirror.com
# 查询是否配置成功
npm config get registry
验证输出：
ubuntu@gt-ubuntu22-04-cmd-v3-0-8gb-100m:~$ npm config get registry
https://registry.npmmirror.com
执行安装脚本（注意：安装过程中要勾选 yes）：
curl -fsSL https://openclaw.ai/install.sh | bash
完整安装日志：
ubuntu@gt-ubuntu22-04-cmd-v3-0-8gb-100m:~$ curl -fsSL https://openclaw.ai/install.sh | bash
🦞 OpenClaw Installer
The only crab in your contacts you actually want to hear from.
🦞 ✓ Detected: linux
Install plan OS: linux Install method: npm Requested version: latest
[1/3] Preparing environment
✓ Node.js v24.14.0 found · Active Node.js: v24.14.0 (/usr/bin/node)
· Active npm: 11.9.0 (/usr/bin/npm)
[2/3] Installing OpenClaw
✓ Git already installed · Configuring npm for user-local installs
✓ npm configured for user installs · Installing OpenClaw v2026.2.26
✓ OpenClaw npm package installed ✓ OpenClaw installed
[3/3] Finalizing setup
!PATH missing npm global bin dir: /home/ubuntu/.npm-global/bin
This can make openclaw show as "command not found" in new terminals.
Fix (zsh: ~/.zshrc, bash: ~/.bashrc): export PATH="/home/ubuntu/.npm-global/bin:$PATH"
🦞 OpenClaw installed successfully (2026.2.26)! All done!
I promise to only judge your code a little bit.
· Starting setup
🦞 OpenClaw 2026.2.26 (bc50708) — Ship fast, log faster.
...
◇ Gateway port: 18789
◇ Gateway bind: Loopback (127.0.0.1)
◇ Model configured ───────────────╮
│ │ Default model set to zai/glm-5 │
│ ├──────────────────────────────────╯
◇ Channel status ────────────────────────────
│ Feishu: install plugin to enable
...
◇ Dashboard ready ────────────────────────────────────────────────────────────────
│ Dashboard link(with token):
│ http://127.0.0.1:18789/#token=2962e8f5116c63d86ea9c8224bc8d6445cce2e806ed1e183
│ Copy/paste this URL in a browser on this machine to control OpenClaw.
│ No GUI detected. Open from your computer:
│ ssh -NL 18789:127.0.0.1:18789 [email protected]
│ Then open:
│ http://localhost:18789/
│ http://localhost:18789/#token=2962e8f5116c63d86ea9c8224bc8d6445cce2e806ed1e183
└ Onboarding complete. Use the dashboard link above to control OpenClaw.
安装完成后，如果执行 which openclaw 找不到命令，需要手动配置 PATH：
# 检查 openclaw 是否在 PATH 中
which openclaw
# 如果找不到，查看 npm 全局安装目录
npm prefix -g
# 查看当前 shell
echo $SHELL
# 如果输出 /bin/bash，使用 ~/.bashrc
# 如果输出 /bin/zsh，使用 ~/.zshrc
# 将 npm 全局 bin 目录添加到 PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
# 重新加载配置文件
source ~/.bashrc
# 验证添加是否成功
echo $PATH | grep npm
在本地电脑执行，按提示输入远程 Linux 云主机密码即可：
ssh -NL 18789:127.0.0.1:18789 ubuntu@你的云主机 IP
携带部署过程中生成的 Dashboard link 在本地进行访问：
http://localhost:18789/#token=你的 token
本文详细记录了在 Ubuntu 22.04 服务器上从零部署 OpenClaw 的完整流程，包括：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online