一、文档概述
1.1 文档目的
本文档详细阐述在统信 UOS 服务器操作系统中安装、部署及初始化配置 OpenClaw 的全流程，为运维人员及开发人员提供可落地的操作指南，确保 OpenClaw 稳定部署并正常发挥其 AI 助手核心能力。
1.2 OpenClaw 简介
OpenClaw 是一款本地 AI Agent 工具，前身为 Clawdbot，经 moltbot 阶段迭代优化，具备高主动性和强系统底层操作能力。核心功能包括执行 Shell 命令、自动化提交 Git PR、管理数据库，支持对接 Telegram、WhatsApp 等主流通讯应用；其 Skills 插件机制可按需扩展功能，默认本地部署模式，兼容 Anthropic、OpenAI 等多模型，能有效保障数据隐私安全。
二、环境准备
部署环境为统信 UOS 服务器操作系统，需确保服务器网络通畅（在线安装 Node.js 时），或提前下载好 Node.js 离线安装包；同时需具备服务器 root / 管理员权限，避免权限不足导致操作失败。
三、安装部署步骤
3.1 安装 Node.js
OpenClaw 运行依赖 Node.js 环境，需安装 v24.13.0 版本，提供在线、离线两种安装方式，可根据服务器网络情况选择。
3.1.1 在线安装方式
- 执行以下命令安装 nvm（Node.js 版本管理工具）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
- 加载 nvm 环境（无需重启 Shell）：
"$HOME/.nvm/nvm.sh"
- 安装 Node.js v24.13.0：
nvm install 24
- 验证安装结果：
# 验证 Node.js 版本，应输出 "v24.13.0"
node -v
# 验证 npm 版本，应输出 "11.6.2"
npm -v
3.1.2 离线安装方式
若服务器无外网，可采用离线安装：
- 下载 Node.js 离线包（提前在有网环境下载后传输至服务器）：
wget https://nodejs.org/dist/v24.13.0/node-v24.13.0-linux-x64.tar.xz
- 解压缩下载的安装包：
tar xvf node-v24.13.0-linux-x64.tar.xz
- 移动解压包至系统标准目录：
mv node-v24.13.0-linux-x64 /usr/local/nodejs
- 配置全局环境变量：
- 编辑 profile 文件：
vim /etc/profile
- 在文件末尾添加以下配置（指定 Node.js 安装目录，将 bin 目录加入系统 PATH）：
export NODE_HOME=/usr/local/nodejs
export PATH=$NODE_HOME/bin:$PATH
- 保存并退出 vim（操作：按
ESC→ 输入:wq→ 回车）。
- 使环境变量立即生效：
source /etc/profile
- 验证安装结果：
# 验证 Node.js 版本
node -v
# 验证 npm 版本（Node.js 自带，无需单独安装）
npm -v
3.2 安装 OpenClaw
执行以下一键安装命令，触发 OpenClaw 安装流程：
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后终端会弹出确认界面，输入 Yes 并按下回车键，进入 OpenClaw 初始化配置流程。
3.3 OpenClaw 初始化配置
安装后按终端引导完成初始化配置，核心配置项及操作如下：
3.3.1 服务运行端口配置
3.3.2 模型对接配置
需配置 Anthropic/OpenAI 密钥、模型地址等信息，本文以 Moonshot AI 模型服务为例：
本文档选择使用 2.5 模型，模型选择后回车确认：
在输入模型 API key 后回车如下图则表则连接模型 API 成功，继续选择使用的模型：
输入模型 API key 回车后，如下界面表示连接模型 API 成功，输入准备好的 API key：
模型选择界面如下：
3.3.3 通讯应用对接配置
3.3.4 配置 Skills 插件
推荐选择默认 yes，可启用已符合条件的 4 个技能，快速体验扩展功能；后续可通过补充依赖（安装对应软件、配置权限）解锁更多技能。若暂时无需扩展功能，选择 No 跳过此步骤。
3.3.5 配置 Homebrew
推荐选择默认 yes，系统会提供 Homebrew 的安装命令，安装后可快速自动部署技能所需依赖。
选择后进入 Homebrew 安装及技能包管理器选择界面，推荐使用默认 npm：
完成选择后，系统会基于选定的包管理器配置技能依赖安装环境，随后进入缺失功能依赖安装界面，可按需选择安装，或默认跳过（后续需用时再安装）：
3.4 服务启动与状态校验
- 启动 OpenClaw 服务（配置完成后自动启动，也可手动执行启动命令）；
- 查看服务运行状态：
openclaw status
- 正常状态下终端会显示服务运行中、端口监听正常等信息；
- 若状态异常，需检查配置项、端口占用、Node.js 环境等。
- 访问 Web 管理界面：
- 打开浏览器，输入
http://服务器 IP:配置端口（端口为初始化配置时指定）；
正常情况下可进入 OpenClaw Web 控制台，验证界面功能是否正常加载。
四、常见问题排查
| 问题现象 | 排查措施 |
|---|---|
| Node.js 版本验证失败 | 1. 检查环境变量配置是否正确，执行 source /etc/profile 重新加载；2. 离线安装时确认解压包路径与 NODE_HOME 一致。 |
| OpenClaw 安装脚本执行失败 | 1. 检查服务器网络是否能访问 openclaw.ai；2. 确认服务器已安装 curl 工具（执行 yum install curl/apt install curl 安装）。 |
| Web 界面无法访问 | 1. 检查服务器防火墙 / 安全组是否放行配置端口； 2. 验证服务器 IP 地址是否正确，配置端口是否未被修改。 |
五、文档附则
- 本文档适配 OpenClaw 最新稳定版本及 UOS V2500 服务器系统，若版本迭代，需同步更新安装脚本、配置项等内容；
- 部署过程中涉及的敏感信息（如模型密钥、管理员密码）需妥善保管，避免泄露；
- 建议部署前备份服务器关键配置，部署后进行功能测试（如执行 Shell 命令、对接通讯应用），确保 OpenClaw 满足业务需求。