OpenClaw 是一个由 Lobsters 社区打造的 AI Agent 开发框架，支持 Web UI 和命令行两种交互方式。那么，如何在 Linux 服务器上快速搭建？本文将手把手带你完成整个安装配置流程。

一、安装 Node.js

OpenClaw 基于 Node.js 开发，因此我们首先需要安装 Node.js 环境。这里我们选择Node.js 22 LTS 版本，这是目前 OpenClaw 推荐的版本。

执行以下命令完成安装：

# 1. 下载并运行 NodeSource 设置脚本 (获取 Node.js 22)curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -# 2. 安装 nodejssudo apt-get install -y nodejs# 3. 验证安装是否成功node -v

💡 小贴士：如果你的服务器在国内，下载可能较慢，可以考虑使用清华镜像源或先配置好代理。

二、安装 OpenClaw

环境准备好后，就可以安装 OpenClaw 了。只需要一行命令：

# 全局安装 OpenClawnpm i -g openclaw

⚠️ 常见问题：Git SSH 权限报错

如果在安装过程中遇到以下错误：

root@root:/home/leozhang/workspace# npm i -g openclawnpm error code 128npm error An unknown git error occurrednpm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.gitnpm error git@github.com: Permission denied (publickey).npm error fatal: Could not read from remote repository.npm errornpm error Please make sure you have the correct access rightsnpm error and the repository exists.npm error A complete log of this run can be found in: /root/.npm/_logs/2026-03-23T06_54_38_461Z-debug-0.log

这是因为 OpenClaw 的某些依赖库使用了 Git SSH 方式拉取，但你的服务器没有配置 SSH 密钥。最简单的解决方案是配置 Git 强制使用 HTTPS 代替 SSH：

# 配置 Git 使用 HTTPS 代替 SSHgit config --global url."https://github.com/".insteadOf git@github.com:

配置完成后，重新执行安装命令即可：

npm i -g openclaw

三、配置大模型

OpenClaw 依赖大模型来驱动 AI Agent 的能力。首次使用需要运行配置向导：

# 启动配置向导openclaw onboard

按照提示完成以下配置：

1. 选择大模型提供商
2. 填入 API Key
3. 选择模型版本

推荐使用火山引擎方舟：

• 注册地址：https://www.volcengine.com/docs/82379
• 文档参考：https://www.volcengine.com/docs/82379/2183190?lang=zh

🚀 火山方舟是国内访问速度最快的选择之一，配置简单，适合国内服务器使用。

四、启动并使用 OpenClaw

OpenClaw 提供两种使用方式，根据你的场景选择即可。

方式一：Web UI 界面

如果你喜欢图形化界面，推荐使用 Dashboard 模式：

openclaw dashboard

Linux 服务器（无 GUI）上会输出如下信息：