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

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

最近 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 运行时。

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

# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

GPT plus 代充只需 145

让 nvm 生效（或者重新开一个终端）

export NVM_DIR=“$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh” ] && . “$NVM_DIR/nvm.sh”

安装 Node.js 22

nvm install 22

验证

node -v # 应该显示 v22.x.x npm -v # 应该显示 10.x.x

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

讯享网# Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs

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

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

npm install -g openclaw@latest

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

讯享网mkdir -p “\(HOME/.npm-global&#34; npm config set prefix &#34;\)HOME/.npm-global” echo ‘export PATH=“\(HOME/.npm-global/bin:\)PATH”’ &gt;&gt; ~/.bashrc source ~/.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. 创建配置文件 /.openclaw/openclaw.json
2. 创建工作区目录 /.openclaw/workspace
3. 配置 AI 模型提供商（会让你选择 OpenAI / Anthropic / Google 等，并输入 API Key）
4. 安装 systemd 用户服务（让 OpenClaw 开机自启、后台常驻）

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

OpenClaw 支持多种模型提供商：

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

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

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

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

编辑 OpenClaw 配置文件：

讯享网nano ~/.openclaw/openclaw.json

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

{ channels: {

讯享网telegram: { enabled: true, botToken: &#34;你的Bot Token粘贴在这里&#34;, dmPolicy: &#34;pairing&#34;, // 首次对话需要配对验证 },

}, }

保存退出。

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

export TELEGRAM_BOT_TOKEN=“你的Bot Token”

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

讯享网openclaw channels approve

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

如果你在 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 现在已经能用了，但有几个安全设置建议你马上做：

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

讯享网{ channels: {

telegram: { enabled: true, botToken: &#34;...&#34;, dmPolicy: &#34;pairing&#34;, allowFrom: [&#34;你的Telegram用户ID&#34;], },

}, }

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

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

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

讯享网cd ~/.openclaw/workspace git init git add -A git commit -m “init workspace”

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

clawhub install github

在工作区创建 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@latest openclaw 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
如果有什么想法，欢迎留在评论区！
可以加我，一起成长、一起交流
https://u.wechat.com/MNo4pFu-YhUVhRyVz81FNII?s=2 (二维码自动识别)