Linux 部署安装 OpenClaw 教程:从环境搭建到生产运行的完整指南

详细讲解如何在 Linux 系统上部署安装 OpenClaw（原 Clawdbot）AI 智能体,涵盖环境准备、Node.js 配置、一键安装、Gateway 启动、飞书钉钉对接及安全加固,帮助你快速搭建属于自己的 AI 助手。

前言

2026 年初，一个名为 OpenClaw 的开源 AI 助手项目在技术圈炸开了锅，短短几个月就有超过 20 万人在 GitHub 上给它点了星。

它的前身是 Clawdbot（也曾叫 Moltbot），经过多轮迭代后正式更名为 OpenClaw。

和我们平时用的 ChatGPT、豆包这些 AI 聊天工具不同，OpenClaw 不只是"陪你聊天"——它能帮你操作电脑、自动浏览网页、整理文件、写报告，甚至可以帮你上京东比价和下单，更像是一个真正能干活的"AI 员工"。

更关键的是，OpenClaw 可以装在你自己的服务器上，所有数据都在你手里，不用担心隐私泄露。

你可以通过飞书、钉钉、企业微信这些国内常用的办公软件直接给它发指令，让 AI 真正成为你口袋里的"数字助手"。

这篇教程将带你从零开始，在 Linux 服务器上完成 OpenClaw 的安装部署。

不需要你是程序员，只要会照着命令复制粘贴，跟着一步一步操作就能搞定。

一、OpenClaw 是什么

简单来说，OpenClaw 就是一个"AI 管家"软件。

你把它装在服务器上之后，就可以通过飞书、钉钉这些聊天工具给它发消息，让它帮你干活。

比如：

• 在飞书群里 @机器人，让它帮你写一份周报
• 让它自动打开浏览器去京东搜商品、比价格
• 让它整理你服务器上的文件，生成一份清单
• 让它每天早上给你推送新闻简报

OpenClaw 本身并不"聪明"，它的"大脑"是各种 AI 模型（比如通义千问、Claude、GPT 等）。

OpenClaw 做的事情是把这些 AI 模型和你的聊天工具"连"起来，同时赋予 AI 操作电脑的能力。

1.1 核心能力一览

1.2 它是怎么工作的

不需要看懂下面这张图的技术细节，你只需要知道 OpenClaw 的工作方式就像一个"总机接线员"：

你的飞书 / 钉钉 / 企业微信            │     发送一条消息给机器人            │            ▼   ┌─────────────────────┐   │  OpenClaw（总机接线员）│   │  收到消息，分配任务     │   └──────────┬──────────┘              │              ├── 调用 AI 模型思考问题              ├── 打开浏览器帮你查东西              ├── 操作服务器上的文件              └── 把结果发回你的聊天窗口

它有一个核心程序叫做 Gateway（你可以理解为"总调度中心"），默认在服务器的 18789 端口运行，负责接收和分发所有消息。

二、部署前的准备工作

在动手之前，你需要先准备好两样东西：一台云服务器 和 一个 AI 模型的钥匙（API Key）。

2.1 准备一台云服务器

如果你还没有服务器，可以去阿里云、腾讯云、华为云等平台购买一台。

推荐选择香港或国内节点，买最便宜的轻量应用服务器就够了。

什么是云服务器？ 你可以把它想象成一台远程的电脑，24 小时开机，你通过网络远程操作它。

配置要求如下：

安全提示：OpenClaw 拥有操作服务器的能力，建议用一台独立的、空的服务器来部署，不要装在你日常工作的电脑或者已有重要数据的服务器上。

2.2 给小内存服务器"扩容"（2 GB 内存必做）

如果你买的服务器内存只有 2 GB，安装过程中很容易因为内存不够而失败（程序会被系统强行关掉）。解决办法是配置一个叫 Swap 的东西——你可以理解为"用硬盘临时充当内存"。

把下面 5 行命令逐行复制粘贴到服务器终端执行：

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho'/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

这 5 行命令分别在干什么？

1. 创建一个 2 GB 大小的文件
2. 设置这个文件只有管理员能读写
3. 把这个文件初始化成 Swap 格式
4. 立即启用这个 Swap
5. 设置开机自动启用（不然重启就失效了）

执行完后输入 free -h，看到 Swap 那一行有数字就说明配好了。

2.3 获取 AI 模型的 API Key

OpenClaw 本身不是 AI，它需要调用外部的 AI 模型才能"思考"。你需要先去 AI 平台申请一个 API Key（可以理解为 AI 服务的"通行证"）。

推荐选择（国内可直接使用，无需访问外网）：

• 通义千问 Qwen（强烈推荐新手）：阿里云旗下，注册就有免费额度，够你体验很久。访问 百炼平台 注册并创建 API Key
• 智谱 GLM：清华团队出品，同样有免费额度。访问 open.bigmodel.cn 注册

进阶选择（需要能访问国际网络）：

• Anthropic Claude：目前公认最强的编程和推理能力
• OpenAI GPT：知名度最高的 AI 模型

给普通人的建议：直接选通义千问就好，注册简单、免费额度充足、国内网络直连，完全不需要折腾。等你熟悉了再考虑换其他模型。

三、安装 Node.js 运行环境

OpenClaw 是用一种叫 Node.js 的技术构建的，所以我们的服务器上必须先装好 Node.js，它相当于 OpenClaw 的"地基"。

重要：Node.js 的版本必须在 22 以上，版本太低会导致安装失败，这是新手踩坑最多的地方。

3.1 更新系统并安装必备工具

先让服务器的软件保持最新，然后安装一个叫 Git 的工具（后面安装过程会用到）：

sudo apt update && sudo apt upgrade -ysudo apt install git -y

sudo 表示"以管理员身份执行"，系统可能会要求你输入密码，输入后按回车（密码不会显示在屏幕上，这是正常的）。

3.2 安装 Node.js

我们用一个叫 NVM 的小工具来安装 Node.js，它的好处是能帮我们方便地管理版本。

如果你的服务器在国内，用下面这行命令安装 NVM（速度更快）：

curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash

如果你的服务器在海外，用官方源：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

安装完 NVM 后，需要让它生效，然后用它安装 Node.js 22：

source ~/.bashrcnvm install 22nvm use 22nvm alias default 22

这 4 行命令的意思是：重新加载配置 → 安装 Node.js 22 版 → 切换到 22 版 → 设置 22 版为默认版本。

验证一下是否装好了：

node --version   # 应该显示 v22.x.xnpm --version    # 应该显示 10.x.x 或更高

如果能看到版本号，说明 Node.js 已经装好了。

3.3 配置 npm 目录（防止后续安装报错）

npm 是 Node.js 自带的"软件商店"，后面安装 OpenClaw 要用到它。提前做一个小配置，可以避免后续安装时报权限错误：

mkdir -p ~/.npm-globalnpm config set prefix '~/.npm-global'echo'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrcsource ~/.bashrc

这几行的作用是：创建一个专用文件夹，告诉 npm 把软件装到这里，然后让系统能找到这个文件夹。

3.4 配置 Git 下载模式

安装过程中需要从 GitHub（一个代码托管网站）下载文件。很多服务器默认用一种叫 SSH 的方式连接 GitHub，但经常会失败。我们提前改成更稳定的 HTTPS 方式：

git config --global url."https://github.com/".insteadOf git@github.com:git config --global url."https://".insteadOf ssh://

四、安装 OpenClaw

地基打好了，现在来装 OpenClaw 本身。这一步反而是最简单的。

4.1 一键安装（推荐所有人使用）

官方提供了一键安装脚本，复制粘贴这一行命令到终端执行即可：

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

这行命令做了什么？它会自动从官网下载安装脚本并运行，帮你把 OpenClaw 安装好，然后进入一个配置向导（下一章会详细讲）。

安装过程大概需要 2~5 分钟，取决于你的网速。看到类似 changed 741 packages 的提示就说明安装成功了。

4.2 备选方案：用 npm 手动安装

如果一键脚本执行失败（比如网络不太好），可以试试手动安装：

npm install -g openclaw@latest

安装完成后手动启动配置向导：

openclaw onboard --install-daemon

4.3 进阶方案：Docker 部署（有经验的用户可选）

如果你了解 Docker，也可以用容器方式部署，隔离性更好。创建一个 docker-compose.yml 文件：

version:'3.8'services:openclaw:image:openclaw/openclaw:latestcontainer_name:openclawrestart:unless-stoppedports:-"127.0.0.1:18789:18789"volumes:-./data:/app/data-./.env:/app/.envenvironment:-NODE_ENV=production

然后执行 docker compose up -d 启动。

普通用户不需要用 Docker，直接用上面的一键安装就够了。

4.4 验证安装是否成功

openclaw --version

如果能看到版本号输出，说明已经装好了。

五、首次配置向导

安装完成后会自动进入配置向导。如果没有自动进入，手动运行：

openclaw onboard --install-daemon

向导是交互式的，会一步步问你问题，用方向键选择，按回车确认。

5.1 选择运行模式

? Gateway mode:❯ Local    ← 选这个就行  Remote

选 Local，直接回车。

5.2 选择 AI 模型

? Auth provider:  Anthropic (API key)  OpenAI (API key)❯ Qwen (OAuth)            ← 推荐新手选这个  ...更多选项

• 如果你选了通义千问（Qwen），会弹出一个网址让你在浏览器里授权登录，按提示操作即可
• 如果你选了其他模型，按提示粘贴你之前申请的 API Key

5.3 配置消息通道

向导会问你想对接哪个聊天工具。第一次安装建议先跳过，等主程序跑通了再回来配：

? Channels: Skip for now

5.4 安装后台服务

? Install daemon: Yes

选 Yes，这样 OpenClaw 会自动在后台运行，服务器重启后也会自动启动，不需要你手动去开。

六、启动与验证

6.1 检查运行状态

如果上一步向导中选了安装后台服务，OpenClaw 应该已经在运行了。输入下面的命令确认：

openclaw status

看到 Gateway 和 Node service 都显示 running，就说明一切正常。

6.2 如果没有自动启动

手动启动 Gateway（OpenClaw 的核心服务）：

openclaw gateway start

6.3 做一次"体检"

OpenClaw 内置了一个诊断工具，能帮你检查有没有什么配置问题：

openclaw doctor

如果诊断出问题，加上 --fix 参数可以尝试自动修复：

openclaw doctor --fix

6.4 打开管理面板

OpenClaw 有一个网页版的管理面板，你可以在浏览器里查看聊天记录、管理配置。

不过这个面板默认只能在服务器本机访问。如果你是远程管理服务器，需要通过一个叫"SSH 隧道"的方式把它映射到你自己的电脑上。在你自己电脑的终端里执行：

ssh -N -L 18789:127.0.0.1:18789 你的用户名@服务器IP

这行命令的意思是：把服务器上 18789 端口的内容"搬运"到你自己电脑的 18789 端口。

然后在你自己电脑的浏览器里打开 http://localhost:18789，就能看到管理面板了。

6.5 让服务一直运行

如果你在配置向导中没有选安装后台服务，OpenClaw 关掉终端就停了。可以用 PM2 这个工具来让它一直在后台跑着：

npm install -g pm2pm2 start "openclaw gateway start" --name openclawpm2 startup && pm2 save

PM2 是一个进程管理工具，它会帮你"看着" OpenClaw，如果程序意外崩溃了会自动重启，服务器重启后也会自动启动。

七、对接聊天工具

OpenClaw 装好之后，你就可以把它和你常用的聊天工具连起来了。这里以国内最常用的飞书和钉钉为例。

7.1 对接飞书

第一步：在服务器上安装飞书插件

openclaw plugins install @openclaw-china/channels

第二步：去飞书开放平台创建一个机器人应用

1. 用浏览器打开 open.feishu.cn，用你的飞书账号登录
2. 点击"创建企业自建应用"，填写应用名称（比如"我的 AI 助手"）
3. 进入应用后，在左侧找到"凭证与基础信息"，把 App ID 和 App Secret 复制下来（后面要用）
4. 在左侧找到"添加应用能力"，点击添加"机器人"
5. 在左侧"事件与回调"中，选择"使用长连接接收事件"，然后添加"接收消息"事件
6. 在左侧"权限管理"中，搜索并申请这两个权限：contact:user.base:readonly 和 im:message
7. 最后点击"创建版本"并发布

第三步：在服务器上填入飞书的信息

把下面命令中的"你的 AppID"和"你的 AppSecret"替换成第二步复制的内容：

openclaw config set channels.feishu.appId "你的AppID"openclaw config set channels.feishu.appSecret "你的AppSecret"openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocketopenclaw config set channels.feishu.requireMention true

第四步：重启服务并测试

openclaw gateway restart

在飞书里搜索你创建的机器人名称，发一条"你好"试试，如果收到回复就说明对接成功了。

7.2 对接钉钉

钉钉的对接方式类似，先在钉钉开放平台创建应用拿到 clientId 和 clientSecret，然后执行：

openclaw plugins install @openclaw-china/channelsopenclaw config set channels.dingtalk '{"enabled":true,"clientId":"你的clientId","clientSecret":"你的clientSecret"}' --jsonopenclaw gateway restart

7.3 对接 Telegram（需要能访问国际网络）

注意：Telegram 在国内无法直接使用，如果你的服务器不能访问国际网络，请跳过这一节。

1. 在 Telegram 搜索 @BotFather，发送 /newbot 创建机器人
2. 拿到 Bot Token 后在服务器上执行：

openclaw configure --section channels.telegram

按提示输入 Token。首次有人给机器人发私信时，需要在服务器端批准配对：

openclaw pairing list telegramopenclaw pairing approve telegram <验证码>

八、安全设置

这一步很重要，千万不要跳过。OpenClaw 能帮你操作服务器上的文件和执行命令，如果安全设置没做好，就等于把你家的钥匙丢在了大街上。

8.1 只允许本机访问

确保 OpenClaw 只能从服务器本机访问，不对外开放：

openclaw config set gateway.bind loopback

loopback 的意思就是"只有本机能连上来"，外部任何人都访问不了。

8.2 设置访问密码

给管理接口加上密码保护：

openclaw config set gateway.auth.mode tokenopenclaw config set gateway.auth.token "在这里填一串长的随机字符"

你可以用任意的长字符串作为密码，越长越安全，比如 my-super-secret-token-2026-abc123。

8.3 保护配置文件

让配置文件只有你自己能读写：

chmod 600 ~/.openclaw/openclaw.jsonchmod 700 ~/.openclaw/workspace/

8.4 设置防火墙

如果你的服务器装了防火墙（推荐装），确保 18789 端口只对本机开放：

sudo ufw allow from 127.0.0.1 to any port 18789sudo ufw deny 18789

8.5 远程管理的正确方式

想从自己的电脑远程管理 OpenClaw 时，不要直接把 18789 端口开放到公网，正确做法是用 SSH 隧道（参考 6.4 节）。

8.6 定期做安全检查

OpenClaw 自带了安全审计功能，建议每周跑一次：

openclaw security audit --deep

九、日常使用速查表

装好之后，日常用到的命令其实不多。把这张表收藏好，需要的时候查一下就行：

9.1 最常用的命令

# 查看 OpenClaw 是否在运行openclaw status# 启动 / 停止 / 重启服务openclaw gateway startopenclaw gateway stopopenclaw gateway restart# 查看有什么问题，自动修复openclaw doctor --fix# 查看实时运行日志（按 Ctrl+C 退出）openclaw logs --follow

9.2 更新到最新版

OpenClaw 更新很频繁，建议隔一段时间更新一次：

openclaw gateway stopnpm install -g openclaw@latestopenclaw doctoropenclaw gateway start

9.3 备份重要配置

养成定期备份的好习惯，万一配置弄乱了还能恢复：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

9.4 设置自动守护（可选）

如果你担心 OpenClaw 偶尔会意外停掉，可以设置一个自动检查脚本，每 5 分钟检查一次，停了就自动重启：

cat > ~/.openclaw/monitor.sh << 'EOF'#!/bin/bashif ! openclaw gateway status | grep -q "running"; thenecho"[$(date)] 检测到服务停止，正在重启..." >> ~/.openclaw/monitor.log    openclaw gateway restartfiEOFchmod +x ~/.openclaw/monitor.sh

然后把它加到系统的定时任务里：

crontab -e

执行后会打开一个文本编辑器，在最后一行加上下面这行内容，保存退出：

*/5 * * * * ~/.openclaw/monitor.sh

这行的意思是"每隔 5 分钟执行一次检查脚本"。

十、常见问题

Q1：安装过程中突然中断，日志里有 Killed 字样

这是因为服务器内存不够，系统把安装进程强制关掉了。回到第二章的 2.2 节配置 Swap，然后重新执行安装命令就行。

Q2：输入 openclaw 命令后提示"找不到命令"

这是因为系统不知道 openclaw 装在哪里。执行下面两行命令修复：

echo'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc

Q3：服务启动失败，提示端口 18789 被占用

说明有其他程序占了这个端口。用下面的命令把它关掉，然后重新启动：

kill -9 $(lsof -t -i :18789)openclaw gateway start

或者干脆换一个端口：

openclaw config set gateway.port 18890openclaw gateway start

Q4：AI 没有回复消息

首先检查 API Key 是否填对了：

openclaw models status

如果你用的是通义千问等国内模型，一般不会有网络问题。检查一下 Key 是否过期或者额度用完了。

如果你用的是 Claude 或 GPT 等海外模型，国内服务器可能连不上它们的接口。你需要给服务器配置网络代理，或者换成国内的模型。

Q5：飞书机器人配好了但收不到消息

按下面的顺序逐一排查：

1. 飞书开放平台上的应用是否已经创建版本并发布了
2. 事件订阅是否选择了长连接模式
3. 是否添加了"接收消息"事件
4. 消息相关的权限是否已申请并通过
5. 在服务器上执行 openclaw channels status --probe 看看飞书通道是否显示在线
6. 试试重启一次：openclaw gateway restart

Q6：Node.js 版本太低怎么办

如果你之前装过旧版的 Node.js，用 NVM 升级就行：

nvm install 22nvm use 22nvm alias default 22node --version

Q7：如何切换不同的 AI 模型

openclaw models listopenclaw models set 你想用的模型名称openclaw gateway restart

Q8：我的数据安全吗，会不会被上传

所有数据都存在你服务器的 ~/.openclaw/ 目录下，包括聊天记录、配置文件、工作文件等。数据完全在你手里，不会上传到任何第三方。

但要注意的是，OpenClaw 对服务器拥有较高的操作权限，所以建议部署在独立的服务器上，不要和其他重要业务混在一起。

总结

回顾一下，整个安装过程其实就是这么几步：

1. 买一台云服务器：2 核 4 GB 内存就够用，2 GB 的话记得配 Swap
2. 装 Node.js：用 NVM 装 22 以上版本，几行命令搞定
3. 装 OpenClaw：一行 curl 命令完事
4. 跑配置向导：选个 AI 模型（推荐通义千问，免费好用），填上 Key
5. 连上飞书或钉钉：装个插件、填点配置信息，在聊天工具里就能用了
6. 做好安全设置：别把端口暴露到公网，设好密码

顺利的话，从开始到跑通整个过程也就半小时左右。哪怕你之前从来没玩过服务器，照着上面的步骤一步步来，基本都能搞定。

OpenClaw 目前还在快速更新中，每隔一两周就会有新功能加入，社区也非常活跃。如果你对 AI 自动化办公感兴趣，现在是一个非常好的入坑时机。

相关资源：

如果大家在部署 OpenClaw 的过程中遇到了什么问题，或者发现了什么好玩的用法，欢迎在评论区交流分享～～～一个人摸索不如大家一起讨论，说不定你踩过的坑正好能帮到别人。