OpenClaw本地化部署
一、准备智谱 API
第一步，得先拿到核心的“钥匙”——智谱AI的API密钥。这个过程很简单：访问智谱开放平台官网（www.bigmodel.cn），新用户注册登录后，平台通常会赠送一份可观的体验Token包，足够前期测试和使用了。
登录后，在右上角的「控制台」里，找到「财务」下的「资源包」确认额度是否到账。接着，进入「API Key」管理页面，点击「添加新的API Key」，名称建议就叫“OpenClaw”以便识别。创建成功后，务必将这串密钥妥善保存好，接下来的每一步配置都离不开它。
二、配置 Ubuntu 系统环境
俗话说，工欲善其事，必先利其器。在部署应用之前，得先把Ubuntu 20.04这个“工作台”给准备好。
1. 切换软件源
为了后续的安装和更新速度更快，首先建议将软件源切换到国内镜像。打开系统里的「软件和更新」应用，在「下载服务器」一栏中选择 mirrors.aliyun.com（阿里云镜像源），确认并应用更改即可。
2. 更新软件包索引
打开终端，执行这条基础命令，刷新一下本地软件包列表：
sudo apt update
3. 安装依赖工具
Node.js、编译工具等是运行环境的基础，用以下命令一次性安装好：
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
基础环境搞定，现在的主角可以登场了——安装OpenClaw本身。
1. 切换 npm 镜像源
为了提升依赖包的下载速度，建议先将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的版本号，那就恭喜你，安装这步稳了：
openclaw --version
四、初始化与启动 OpenClaw
软件装好了，但还不能直接用，需要进行一次初始化配置，把它和你的智谱API密钥关联起来。
1. 初始化配置
在终端运行初始化命令，然后跟着交互提示一步步走：
openclaw onboard
这个过程其实很直观：
- 首先选择 Quick Start 模式快速开始。
- 大模型服务商选择 Z.AI（智谱AI）。
- 区域选择 CN。
- 选择粘贴API Key的方式，输入你在第一步保存好的智谱API Key。
- 模型可以先用默认推荐的（例如 zaiglm-5）。
- 对于通讯渠道、搜索提供商、Skills、各类服务API以及Hook配置这些高级选项，初次部署一律选择 Skip for now 或 No 跳过即可，后续需要时可以再回来详细配置。
2. 启动 Web UI 界面
初始化完成后，选择使用 Web UI 模式启动。命令执行后，系统会自动打开Chrome浏览器，并跳转到OpenClaw的本地聊天界面（默认地址是 http://127.0.0.1:18789）。
3. 测试对话
页面加载完成后，在聊天框里输入一句“你好，你是哪个版本的大模型”试试水。如果能很快收到一条清晰、友好的回复，那么就意味着整个本地化部署已经大功告成，你可以开始尽情探索了。
五、后台运行与开机自启
最后，再来点“锦上添花”的配置，让服务用起来更省心。
后台启动服务
不想一直开着终端窗口？用下面这个命令，让OpenClaw在后台安静地运行：
openclaw daemon start
设置开机自启
如果你希望每次启动Ubuntu系统时，OpenClaw服务都能自动运行，只需执行一条命令开启自启功能：
openclaw daemon enable
至此，从环境准备到服务常驻，一套完整的Ubuntu系统下OpenClaw本地化部署流程就全部走通了。整个过程看似步骤不少，但按部就班下来，其实非常顺畅。现在，你可以专注于如何使用这个强大的工具了。