从零开始:一台空白 Linux 服务器部署 OpenClaw 完整教程

大家好，我是老杜，是一名资深架构师。

最近 OpenClaw 在开发者圈子里火得一塌糊涂。简单说，它是一个开源的 AI Agent 框架——你把它部署在自己的服务器上，接上大模型 API，再连上 Telegram / WhatsApp / Discord 等聊天工具，就拥有了一个 7×24 小时在线、能记住你、能操作你服务器的 AI 助手。

但很多人卡在了第一步：怎么装？

这篇文章手把手带你从一台全新的 Linux 服务器开始，一步步把 OpenClaw 跑起来。全程命令行，不需要 Docker，不需要图形界面。

你需要准备什么

在开始之前，确认你有以下东西：

• • 一台 Linux 服务器（Ubuntu 22.04/24.04、Debian 12、CentOS Stream 9 等主流发行版都行）
• • SSH 访问权限（root 或有 sudo 权限的用户）
• • 一个 AI 模型的 API Key（OpenAI、Anthropic Claude、Google Gemini、DeepSeek 等，任选一个）
• • 一个 Telegram 账号（用来和你的 AI 助手对话；WhatsApp/Discord 也行，本文以 Telegram 为例）

服务器配置建议：最低 1 核 1G 内存就能跑，推荐 2 核 2G。OpenClaw 本身很轻量，主要吃内存的是 Node.js 运行时。

第一步：安装 Node.js 22+

OpenClaw 的唯一硬性依赖是 Node.js 22 或更高版本。大多数 Linux 发行版自带的 Node.js 版本太旧，所以我们用 nvm（Node Version Manager）来安装。

# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash# 让 nvm 生效（或者重新开一个终端）export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"# 安装 Node.js 22nvm install 22# 验证node -v   # 应该显示 v22.x.xnpm -v    # 应该显示 10.x.x

如果你不想用 nvm，也可以用 NodeSource 官方源直接装：

# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs

关键：确保 node -v 输出的版本号 >= 22。低于这个版本 OpenClaw 会拒绝启动。

第二步：安装 OpenClaw

Node.js 装好后，一行命令搞定 OpenClaw：

npm install -g openclaw@latest

如果遇到权限问题（EACCES），不要用 sudo npm install，而是修改 npm 全局目录：

mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc# 然后重新安装npm install -g openclaw@latest

验证安装成功：

openclaw --version

看到版本号就说明装好了。

懒人一键安装（推荐）： OpenClaw 官方也提供了安装脚本，会自动处理 Node.js 检测和安装：

curl -fsSL https://openclaw.ai/install.sh | bash

第三步：运行新手引导

这是最关键的一步。OpenClaw 的 onboard 命令会引导你完成所有初始配置：

openclaw onboard --install-daemon

这个命令会做几件事：

1. 1. 创建配置文件~/.openclaw/openclaw.json
2. 2. 创建工作区目录~/.openclaw/workspace
3. 3. 配置 AI 模型提供商（会让你选择 OpenAI / Anthropic / Google 等，并输入 API Key）
4. 4. 安装 systemd 用户服务（让 OpenClaw 开机自启、后台常驻）

跟着提示一步步走就行。如果你已经有 API Key，整个过程不到 2 分钟。

关于 AI 模型选择

OpenClaw 支持多种模型提供商：

• • Anthropic Claude（推荐，Agent 能力最强）
• • OpenAI GPT-4o / GPT-5
• • Google Gemini
• • DeepSeek（国内用户友好，价格便宜）
• • Kimi 2.5

你可以在 onboard 过程中选择，也可以之后在配置文件里改。

第四步：配置 Telegram 机器人

OpenClaw 需要一个"表面"（Surface）来和你对话。最常用的是 Telegram。

4.1 在 Telegram 创建机器人

1. 1. 打开 Telegram，搜索 @BotFather（注意确认是官方的，有蓝色认证标志）
2. 2. 发送 /newbot
3. 3. 按提示输入机器人名称（比如 My OpenClaw）
4. 4. 输入机器人用户名（必须以 bot 结尾，比如 my_openclaw_bot）
5. 5. BotFather 会给你一个 Bot Token，类似 123456789:ABCdefGHIjklMNOpqrsTUVwxyz，复制保存好

4.2 配置 Token

编辑 OpenClaw 配置文件：

nano ~/.openclaw/openclaw.json

添加 Telegram 配置（JSON5 格式，支持注释）：

{  channels: {    telegram: {      enabled: true,      botToken: "你的Bot Token粘贴在这里",      dmPolicy: "pairing",  // 首次对话需要配对验证    },  },}

保存退出。

或者，你也可以用环境变量的方式：

export TELEGRAM_BOT_TOKEN="你的Bot Token"

4.3 首次配对

启动 Gateway 后（下一步），在 Telegram 里给你的机器人发一条消息。OpenClaw 会返回一个配对码，你需要在服务器上确认：

openclaw channels approve

配对成功后，以后就不需要再配对了。

第五步：启动 Gateway

如果你在 onboard 时选择了 --install-daemon，OpenClaw 已经作为 systemd 用户服务安装好了。

# 查看状态openclaw status# 手动启动（如果没有自动启动）openclaw gateway start# 查看健康状态openclaw health

重要：Linux 上的 systemd 用户服务默认在你注销后会被停止。 要让 OpenClaw 在你断开 SSH 后继续运行，需要启用 lingering：

sudo loginctl enable-linger $USER

这一步很关键，不做的话你一断开 SSH，OpenClaw 就停了。

验证一切正常

# 检查 Gateway 是否在运行openclaw status# 运行诊断openclaw doctor# 查看日志openclaw logs

然后去 Telegram 给你的机器人发条消息试试。如果它回复了，恭喜，部署成功！

第六步：基础安全配置（别跳过）

你的 OpenClaw 现在已经能用了，但有几个安全设置建议你马上做：

6.1 限制谁能跟机器人对话

默认情况下，任何人都可以给你的 Telegram 机器人发消息。你应该限制只有你自己能用：

{  channels: {    telegram: {      enabled: true,      botToken: "...",      dmPolicy: "pairing",      allowFrom: ["你的Telegram用户ID"],    },  },}

你的 Telegram 用户 ID 可以通过 @userinfobot 获取。

6.2 Gateway 监听地址

默认 Gateway 只监听 127.0.0.1（本地），这是安全的。如果你需要远程访问 Dashboard，建议通过 SSH 隧道，而不是直接暴露端口。

第七步：让它更好用（可选）

7.1 设置工作区

OpenClaw 的工作区在 ~/.openclaw/workspace。你可以把它初始化为一个 Git 仓库，方便版本管理：

cd ~/.openclaw/workspacegit initgit add -Agit commit -m "init workspace"

7.2 安装 Skills

OpenClaw 通过 Skills 扩展能力。比如安装 GitHub 集成：

clawhub install github

7.3 配置 Heartbeat（心跳巡检）

在工作区创建 HEARTBEAT.md，写上你希望 AI 定期检查的事项：

# HEARTBEAT.md- 检查服务器磁盘空间是否超过 80%- 检查是否有未读的重要邮件

OpenClaw 会按配置的间隔自动执行这些检查。

常见问题

Q: openclaw: command not found

A: PATH 问题。运行 npm prefix -g 查看全局安装路径，确保 <路径>/bin 在你的 PATH 里。

Q: Gateway 启动后 Telegram 机器人没反应

A: 检查 Bot Token 是否正确，运行 openclaw logs 看有没有报错。最常见的原因是 Token 写错了或者网络不通（国内服务器可能需要代理才能连 Telegram API）。

Q: 国内服务器怎么连 Telegram？

A: 你需要配置代理。在环境变量中设置：

export HTTPS_PROXY=http://你的代理地址:端口

或者直接用海外服务器（推荐）。

Q: 怎么更新 OpenClaw？

A:

npm install -g openclaw@latestopenclaw gateway restart

Q: 怎么换模型？

A: 编辑 ~/.openclaw/openclaw.json，修改模型提供商和 API Key，然后 openclaw gateway restart。

总结

整个部署流程回顾：

安装 Node.js 22+ → npm install -g openclaw → openclaw onboard --install-daemon → 配置 Telegram Bot → 启用 lingering → 开始使用

从一台空白 Linux 服务器到一个能用的 AI 助手，整个过程大概 10-15 分钟。OpenClaw 的设计哲学是"你的 AI，跑在你的机器上"——数据不经过第三方，模型 API Key 只存在你自己的服务器上。

如果你在部署过程中遇到问题，可以：

• • 官方文档：https://docs.openclaw.ai
• • GitHub：https://github.com/openclaw/openclaw
• • Discord 社区：https://discord.com/invite/clawd