2026 年初，一个名为 OpenClaw 的开源 AI 助手项目在技术圈炸开了锅，短短几个月就有超过 20 万人在 GitHub 上给它点了星。
它的前身是 Clawdbot（也曾叫 Moltbot），经过多轮迭代后正式更名为 OpenClaw。
和我们平时用的 ChatGPT、豆包这些 AI 聊天工具不同，OpenClaw 不只是”陪你聊天”——它能帮你操作电脑、自动浏览网页、整理文件、写报告，甚至可以帮你上京东比价和下单，更像是一个真正能干活的”AI 员工”。
更关键的是，OpenClaw 可以装在你自己的服务器上，所有数据都在你手里，不用担心隐私泄露。
你可以通过飞书、钉钉、企业微信这些国内常用的办公软件直接给它发指令，让 AI 真正成为你口袋里的”数字助手”。
这篇教程将带你从零开始，在 Linux 服务器上完成 OpenClaw 的安装部署。
不需要你是程序员，只要会照着命令复制粘贴，跟着一步一步操作就能搞定。
简单来说，OpenClaw 就是一个”AI 管家”软件。
你把它装在服务器上之后，就可以通过飞书、钉钉这些聊天工具给它发消息，让它帮你干活。
比如：
- 在飞书群里 @机器人，让它帮你写一份周报
- 让它自动打开浏览器去京东搜商品、比价格
- 让它整理你服务器上的文件，生成一份清单
- 让它每天早上给你推送新闻简报
OpenClaw 本身并不”聪明”，它的”大脑”是各种 AI 模型（比如通义千问、Claude、GPT 等）。
OpenClaw 做的事情是把这些 AI 模型和你的聊天工具”连”起来，同时赋予 AI 操作电脑的能力。
不需要看懂下面这张图的技术细节，你只需要知道 OpenClaw 的工作方式就像一个”总机接线员”：
它有一个核心程序叫做 Gateway（你可以理解为”总调度中心”），默认在服务器的 18789 端口运行，负责接收和分发所有消息。
在动手之前，你需要先准备好两样东西：一台云服务器 和 一个 AI 模型的钥匙（API Key）。
如果你还没有服务器，可以去阿里云、腾讯云、华为云等平台购买一台。
推荐选择香港或国内节点，买最便宜的轻量应用服务器就够了。
什么是云服务器？ 你可以把它想象成一台远程的电脑，24 小时开机，你通过网络远程操作它。
配置要求如下：
安全提示：OpenClaw 拥有操作服务器的能力，建议用一台独立的、空的服务器来部署，不要装在你日常工作的电脑或者已有重要数据的服务器上。
如果你买的服务器内存只有 2 GB，安装过程中很容易因为内存不够而失败（程序会被系统强行关掉）。解决办法是配置一个叫 Swap 的东西——你可以理解为”用硬盘临时充当内存”。
把下面 5 行命令逐行复制粘贴到服务器终端执行：
这 5 行命令分别在干什么？
- 创建一个 2 GB 大小的文件
- 设置这个文件只有管理员能读写
- 把这个文件初始化成 Swap 格式
- 立即启用这个 Swap
- 设置开机自动启用（不然重启就失效了）
执行完后输入 ，看到 Swap 那一行有数字就说明配好了。
OpenClaw 本身不是 AI，它需要调用外部的 AI 模型才能”思考”。你需要先去 AI 平台申请一个 API Key（可以理解为 AI 服务的”通行证”）。
推荐选择（国内可直接使用，无需访问外网）：
- 通义千问 Qwen（强烈推荐新手）：阿里云旗下，注册就有免费额度，够你体验很久。访问 百炼平台 注册并创建 API Key
- 智谱 GLM：清华团队出品，同样有免费额度。访问 open.bigmodel.cn 注册
进阶选择（需要能访问国际网络）：
- Anthropic Claude：目前公认最强的编程和推理能力
- OpenAI GPT：知名度最高的 AI 模型
给普通人的建议：直接选通义千问就好，注册简单、免费额度充足、国内网络直连，完全不需要折腾。等你熟悉了再考虑换其他模型。
OpenClaw 是用一种叫 Node.js 的技术构建的，所以我们的服务器上必须先装好 Node.js，它相当于 OpenClaw 的”地基”。
重要：Node.js 的版本必须在 22 以上，版本太低会导致安装失败，这是新手踩坑最多的地方。
先让服务器的软件保持最新，然后安装一个叫 Git 的工具（后面安装过程会用到）：
表示”以管理员身份执行”，系统可能会要求你输入密码，输入后按回车（密码不会显示在屏幕上，这是正常的）。
我们用一个叫 NVM 的小工具来安装 Node.js，它的好处是能帮我们方便地管理版本。
如果你的服务器在国内，用下面这行命令安装 NVM（速度更快）：
如果你的服务器在海外，用官方源：
安装完 NVM 后，需要让它生效，然后用它安装 Node.js 22：
这 4 行命令的意思是：重新加载配置 → 安装 Node.js 22 版 → 切换到 22 版 → 设置 22 版为默认版本。
验证一下是否装好了：
如果能看到版本号，说明 Node.js 已经装好了。
npm 是 Node.js 自带的”软件商店”，后面安装 OpenClaw 要用到它。提前做一个小配置，可以避免后续安装时报权限错误：
这几行的作用是：创建一个专用文件夹，告诉 npm 把软件装到这里，然后让系统能找到这个文件夹。
安装过程中需要从 GitHub（一个代码托管网站）下载文件。很多服务器默认用一种叫 SSH 的方式连接 GitHub，但经常会失败。我们提前改成更稳定的 HTTPS 方式：
地基打好了，现在来装 OpenClaw 本身。这一步反而是最简单的。
官方提供了一键安装脚本，复制粘贴这一行命令到终端执行即可：
这行命令做了什么？它会自动从官网下载安装脚本并运行，帮你把 OpenClaw 安装好，然后进入一个配置向导（下一章会详细讲）。
安装过程大概需要 2~5 分钟，取决于你的网速。看到类似 的提示就说明安装成功了。
如果一键脚本执行失败（比如网络不太好），可以试试手动安装：
安装完成后手动启动配置向导：
如果你了解 Docker，也可以用容器方式部署，隔离性更好。创建一个 文件：
然后执行 启动。
普通用户不需要用 Docker，直接用上面的一键安装就够了。
如果能看到版本号输出，说明已经装好了。
安装完成后会自动进入配置向导。如果没有自动进入，手动运行：
向导是交互式的，会一步步问你问题，用方向键选择，按回车确认。
选 Local，直接回车。
- 如果你选了通义千问（Qwen），会弹出一个网址让你在浏览器里授权登录，按提示操作即可
- 如果你选了其他模型，按提示粘贴你之前申请的 API Key
向导会问你想对接哪个聊天工具。第一次安装建议先跳过，等主程序跑通了再回来配：
选 Yes，这样 OpenClaw 会自动在后台运行，服务器重启后也会自动启动，不需要你手动去开。
如果上一步向导中选了安装后台服务，OpenClaw 应该已经在运行了。输入下面的命令确认：
看到 Gateway 和 Node service 都显示 ，就说明一切正常。
手动启动 Gateway（OpenClaw 的核心服务）：
OpenClaw 内置了一个诊断工具，能帮你检查有没有什么配置问题：
如果诊断出问题，加上 参数可以尝试自动修复：
OpenClaw 有一个网页版的管理面板，你可以在浏览器里查看聊天记录、管理配置。
不过这个面板默认只能在服务器本机访问。如果你是远程管理服务器，需要通过一个叫”SSH 隧道”的方式把它映射到你自己的电脑上。在你自己电脑的终端里执行：
这行命令的意思是：把服务器上 18789 端口的内容”搬运”到你自己电脑的 18789 端口。
然后在你自己电脑的浏览器里打开 ，就能看到管理面板了。
如果你在配置向导中没有选安装后台服务，OpenClaw 关掉终端就停了。可以用 PM2 这个工具来让它一直在后台跑着：
PM2 是一个进程管理工具，它会帮你”看着” OpenClaw，如果程序意外崩溃了会自动重启，服务器重启后也会自动启动。
OpenClaw 装好之后，你就可以把它和你常用的聊天工具连起来了。这里以国内最常用的飞书和钉钉为例。
第一步：在服务器上安装飞书插件
第二步：去飞书开放平台创建一个机器人应用
- 用浏览器打开 open.feishu.cn，用你的飞书账号登录
- 点击”创建企业自建应用”，填写应用名称（比如”我的 AI 助手”）
- 进入应用后，在左侧找到”凭证与基础信息”，把 App ID 和 App Secret 复制下来（后面要用）
- 在左侧找到”添加应用能力”，点击添加”机器人”
- 在左侧”事件与回调”中，选择”使用长连接接收事件”，然后添加”接收消息”事件
- 在左侧”权限管理”中，搜索并申请这两个权限： 和
- 最后点击”创建版本”并发布
第三步：在服务器上填入飞书的信息
把下面命令中的”你的 AppID”和”你的 AppSecret”替换成第二步复制的内容：
第四步：重启服务并测试
在飞书里搜索你创建的机器人名称，发一条”你好”试试，如果收到回复就说明对接成功了。
钉钉的对接方式类似，先在钉钉开放平台创建应用拿到 clientId 和 clientSecret，然后执行：
注意：Telegram 在国内无法直接使用，如果你的服务器不能访问国际网络，请跳过这一节。
- 在 Telegram 搜索 @BotFather，发送 创建机器人
- 拿到 Bot Token 后在服务器上执行：
按提示输入 Token。首次有人给机器人发私信时，需要在服务器端批准配对：
这一步很重要，千万不要跳过。OpenClaw 能帮你操作服务器上的文件和执行命令，如果安全设置没做好，就等于把你家的钥匙丢在了大街上。
确保 OpenClaw 只能从服务器本机访问，不对外开放：
的意思就是”只有本机能连上来”，外部任何人都访问不了。
给管理接口加上密码保护：
你可以用任意的长字符串作为密码，越长越安全，比如 。
让配置文件只有你自己能读写：
如果你的服务器装了防火墙（推荐装），确保 18789 端口只对本机开放：
想从自己的电脑远程管理 OpenClaw 时，不要直接把 18789 端口开放到公网，正确做法是用 SSH 隧道（参考 6.4 节）。
OpenClaw 自带了安全审计功能，建议每周跑一次：
装好之后，日常用到的命令其实不多。把这张表收藏好，需要的时候查一下就行：
OpenClaw 更新很频繁，建议隔一段时间更新一次：
养成定期备份的好习惯，万一配置弄乱了还能恢复：
如果你担心 OpenClaw 偶尔会意外停掉，可以设置一个自动检查脚本，每 5 分钟检查一次，停了就自动重启：
然后把它加到系统的定时任务里：
执行后会打开一个文本编辑器，在最后一行加上下面这行内容，保存退出：
这行的意思是”每隔 5 分钟执行一次检查脚本”。
这是因为服务器内存不够，系统把安装进程强制关掉了。回到第二章的 2.2 节配置 Swap，然后重新执行安装命令就行。
这是因为系统不知道 openclaw 装在哪里。执行下面两行命令修复：
说明有其他程序占了这个端口。用下面的命令把它关掉，然后重新启动：
或者干脆换一个端口：
首先检查 API Key 是否填对了：
如果你用的是通义千问等国内模型，一般不会有网络问题。检查一下 Key 是否过期或者额度用完了。
如果你用的是 Claude 或 GPT 等海外模型，国内服务器可能连不上它们的接口。你需要给服务器配置网络代理，或者换成国内的模型。
按下面的顺序逐一排查：
- 飞书开放平台上的应用是否已经创建版本并发布了
- 事件订阅是否选择了长连接模式
- 是否添加了”接收消息”事件
- 消息相关的权限是否已申请并通过
- 在服务器上执行 看看飞书通道是否显示在线
- 试试重启一次：
如果你之前装过旧版的 Node.js，用 NVM 升级就行：
所有数据都存在你服务器的 目录下，包括聊天记录、配置文件、工作文件等。数据完全在你手里，不会上传到任何第三方。
但要注意的是，OpenClaw 对服务器拥有较高的操作权限，所以建议部署在独立的服务器上，不要和其他重要业务混在一起。
回顾一下，整个安装过程其实就是这么几步：
- 买一台云服务器：2 核 4 GB 内存就够用，2 GB 的话记得配 Swap
- 装 Node.js：用 NVM 装 22 以上版本，几行命令搞定
- 装 OpenClaw：一行 命令完事
- 跑配置向导：选个 AI 模型（推荐通义千问，免费好用），填上 Key
- 连上飞书或钉钉：装个插件、填点配置信息，在聊天工具里就能用了
- 做好安全设置：别把端口暴露到公网，设好密码
顺利的话，从开始到跑通整个过程也就半小时左右。哪怕你之前从来没玩过服务器，照着上面的步骤一步步来，基本都能搞定。
OpenClaw 目前还在快速更新中，每隔一两周就会有新功能加入，社区也非常活跃。如果你对 AI 自动化办公感兴趣，现在是一个非常好的入坑时机。
相关资源：
如果大家在部署 OpenClaw 的过程中遇到了什么问题，或者发现了什么好玩的用法，欢迎在评论区交流分享～～～一个人摸索不如大家一起讨论，说不定你踩过的坑正好能帮到别人。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/262042.html原文链接：https://javaforall.net
