Ubuntu快速部署OpenClaw接入飞书完整教程

前言

　　记录一下在 Ubuntu 22.04 服务器上从零部署 OpenClaw，并成功对接飞书的完整过程。踩过的坑和解决方案，一并放出来。

环境信息

• 系统: Ubuntu 22.04 LTS
• 配置: 4核 8GB 内存，100M 带宽
• 类型: CPU

一、安装依赖

1.1 更新系统包索引

sudo apt update

1.2 安装 curl

sudo apt install -y curl

1.3 通过 NodeSource 安装最新稳定 LTS 版本

# 添加 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

1.4 设置淘宝镜像（最常用）

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

二、安装 OpenClaw

　　执行安装脚本，注意安装过程中需要勾选 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.

三、解决 PATH 问题

　　安装完如果执行 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

四、访问控制界面

4.1 本地ssh连接服务器

　　在本地电脑执行下面命令，按提示输入远程 Linux 云主机密码即可完成隧道建立：

ssh -N -L 18789:127.0.0.1:18789 ubuntu@你的云主机IP

OpenClaw SSH隧道

4.2 访问openclaw web ui

　　把部署过程中生成的 Dashboard link 拿到本地浏览器访问即可，形式如下：

http://localhost:18789/#token=你的token

OpenClaw Web UI

4.3 测试

• 问一下背后模型，如图可知返回的是 glm4.7，和配置一致
• 给AI助手命名为"大衍AI"，如下图，在界面操作后等待生效即可

OpenClaw测试1

OpenClaw测试2

五、总结

　　这篇记录了在 Ubuntu 22.04 服务器上部署 OpenClaw 的完整流程，要点包括：

• 环境准备：Node.js LTS 安装 + npm 镜像配置
• OpenClaw 安装：官方脚本一键安装，以及后续 PATH 配置
• 初始化配置：QuickStart 模式 + Z.AI 模型接入
• 远程访问：通过 SSH 隧道访问 Web 控制界面进行问答

六、后续内容预告

　　OpenClaw 的功能远不止于此，接下来的计划会覆盖更多方向，包括：

• 进阶配置：自定义 Skills 技能、Hooks 自动化、多 Agent 管理
• 安全加固：生产环境部署、访问控制、审计日志配置
• 插件开发：自定义飞书工具插件、接入企业内部系统
• 模型调优：Prompt 工程、多模型切换、上下文管理
• 实战案例：搭建团队知识库助手、自动化工作流机器人