Ubuntu 20.04 下 OpenClaw（龙虾）本地化部署保姆级教程

如果你想在 Ubuntu 系统上搭建属于自己的 AI 智能体工具 OpenClaw（龙虾），这篇教程将从环境准备到最终启动，一步步带你完成部署。

一、准备工作：获取智谱 API Key

OpenClaw 运行依赖大模型接口，这里我们以智谱 AI 为例：

1. 访问智谱开放平台官网：www.bigmodel.cn
2. 新用户注册并登录，新用户会赠送2000 万 Tokens 体验包。
3. 登录后点击右上角「控制台」→「财务」→「资源包」，确认免费 Token 到账。
4. 点击「API Key」→「添加新的 API Key」，名称填写OpenClaw，创建后保存好 API Key，后续配置使用。

二、配置 Ubuntu 系统环境

1. 切换软件源（提升下载速度）

打开「软件和更新」，在「下载服务器」中选择mirrors.aliyun.com（阿里云镜像源），应用设置并输入密码确认。

2. 更新软件包索引

打开终端，执行命令：

sudo apt update

3. 安装依赖工具

执行命令安装必备依赖：

sudo apt install -y git python3 make gcc g++ pkg-config

4. 安装 Node.js

• 下载 Node.js 压缩包：

  wget https://nodejs.org/dist/v24.14.0/node-v24.14.0-linux-x64.tar.xz

• 创建安装目录并解压：

  sudo mkdir -p /opt/nodejs sudo tar -xJf node-v24.14.0-linux-x64.tar.xz -C /opt/nodejs

5. 安装 CMake

• 下载 CMake 压缩包：

  wget https://github.com/Kitware/CMake/releases/download/v4.2.3/cmake-4.2.3-linux-x86_64.tar.gz

• 创建安装目录并解压：

  sudo mkdir -p /opt/cmake sudo tar -xzf cmake-4.2.3-linux-x86_64.tar.gz -C /opt/cmake

6. 配置环境变量

将 Node.js 和 CMake 加入系统环境变量，执行命令：

echo 'export PATH=/opt/nodejs/node-v24.14.0-linux-x64/bin:/opt/cmake/cmake-4.2.3-linux-x86_64/bin:$PATH' >> ~/.bashrc source ~/.bashrc

7. 验证环境

分别执行以下命令，确认版本正常输出：

node -v cmake --version npm -v

三、安装 OpenClaw

1. 切换 npm 镜像源（提升下载速度）

npm config set registry https://registry.npmmirror.com

2. 安装 OpenClaw（虚拟机环境需加特殊参数）

NODE_LLAMA_CPP_SKIP_DOWNLOAD=true npm install -g openclaw@latest --ignore-scripts

3. 验证安装

执行命令查看版本，确认安装成功：

openclaw --version

四、初始化与启动 OpenClaw

1. 初始化配置

执行命令并按提示操作：

openclaw onboard

• 选择Quick Start模式，回车。
• 选择大模型服务商（如Z.AI（智谱AI）），回车。
• 选择区域CN，回车。
• 选择粘贴 API Key，输入之前保存的智谱 API Key，回车。
• 模型选择默认（如zaiglm-5），回车。
• 通讯渠道、搜索提供商、Skills 配置等均选择Skip for now跳过，后续再配置。
• 各类服务 API 配置选择No，回车。
• Hook 配置选择Skip for now，回车。

2. 启动 Web UI 界面

选择使用Web UI模式，回车后会自动打开 Chrome 浏览器，访问 OpenClaw 聊天界面（地址：http://127.0.0.1:18789）。

3. 测试对话

在聊天框输入你好，你是哪个版本的大模型，若收到回复则说明部署成功。

五、后台运行与开机自启

• 后台启动服务：

  openclaw daemon start

• 设置开机自启：

  openclaw daemon enable

至此，Ubuntu 20.04 系统下 OpenClaw 的本地化部署就全部完成了。后续可以根据需求配置通讯渠道、Skills 等功能，让 OpenClaw 发挥更多作用。