2026年Ubuntu 部署OpenClaw教程

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

OpenClaw 是一款开源自主智能体（Autonomous Agent）框架，支持通过自然语言指令执行跨平台自动化任务。相较于本地部署，云服务器部署具备以下核心优势：

7×24 小时在线：无需保持本地设备持续开机，实现全天候服务可用
公网访问支持：可直接对接 Webhook 回调，实现远程控制与多端联动
多平台兼容：无缝接入 Telegram、飞书、Discord、WhatsApp 等主流 IM 平台

配置项

最低要求

推荐配置

CPU

1 核

2 核及以上

内存

2 GB

4 GB 及以上

存储

20 GB SSD

40 GB 及以上 NVMe

系统

Ubuntu 22.04 LTS

Ubuntu 24.04 LTS

Node.js

v22+

v22 LTS

该方式适用于阿里云、百度云等已提供 OpenClaw 应用镜像的云厂商，操作简单、无需手动配置环境，全程一键完成。

登录云服务器控制台，选择「轻量应用服务器」模块；
镜像选择：在「应用模板」中找到「OpenClaw」（或「Clawdbot」）镜像；
地域选择：国内用户优先选择「香港」或就近地域（降低延迟），海外用户推荐选择「弗吉尼亚」地域；
确认实例配置、完成订单支付，等待实例创建成功。

登录阿里云百炼大模型控制台（或对应云厂商的 AI 平台）；
进入「密钥管理」页面，点击「创建 API-Key」；
API-Key 创建成功后，立即复制并妥善保存（该密钥仅显示一次，丢失需重新创建）。

进入服务器实例的「应用管理」标签页；
点击「一键开通」，完成千帆大模型等相关服务的授权；
防火墙配置：点击「一键放行」，开放 18789 端口（OpenClaw Web 控制台默认端口）；
点击「一键配置」，粘贴步骤 2 中获取的 API-Key，完成核心配置；
执行页面提示的命令，生成访问 Web 控制台的 Token。

点击「打开网站页面」，输入生成的 Token，即可进入 OpenClaw Web 对话界面，开始使用智能体功能。

该方式适用于 AWS、Hetzner、Vultr 等裸机服务器，或需要自定义配置、追求更高灵活性的用户，全程手动操作，可精准控制部署细节。

1. 连接服务器

若使用 SSH 密钥连接，先修改密钥文件权限，再执行连接命令（以 Ubuntu 系统为例）：

2. 创建 Swap 内存（关键步骤）

若服务器内存为 2GB，直接安装可能因内存不足（OOM）导致进程卡死，建议创建 4GB Swap 内存，步骤如下：

1. 安装 Node.js 22+

推荐使用 nvm 安装（可灵活管理 Node.js 版本），命令如下：

2. 安装系统依赖

安装必要的系统库，解决运行时可能出现的依赖缺失问题：

提供两种安装方式，推荐新手使用一键脚本，便捷高效；有经验的用户可选择 npm/pnpm 安装，灵活控制版本。

方式一：一键脚本安装（推荐）

方式二：npm/pnpm 安装

1. 运行引导向导

执行以下命令，启动 OpenClaw 配置向导，按提示完成各项设置：

2. 向导配置说明

Onboarding mode：选择「QuickStart」（快速启动模式），适合首次部署；
Model provider：选择你的 LLM 服务商（国内用户：阿里云百炼、DeepSeek；国际用户：Anthropic (Claude)、OpenAI、Google Gemini；免费体验：kimi-k2.5-free，速率限制较严格）；
Channel：选择需要接入的 IM 平台（Telegram、飞书、Discord 等）；
Daemon 安装：选择「yes」，自动创建 systemd 服务，实现服务后台运行。

3. 飞书接入示例

登录飞书开放平台，创建企业应用；
在应用管理中获取「App ID」和「App Secret」；
回到 OpenClaw 配置向导，填入上述凭证，完成飞书平台配对。

使用 –install-daemon 参数后，向导会自动创建 systemd 服务，无需手动配置；若需验证服务状态或手动创建服务，可参考以下步骤。

1. 服务状态验证与开机自启

2. 手动创建 systemd 服务（如需自定义）

部署完成后，需配置防火墙、反向代理及安全加固，保障服务稳定运行和数据安全。

开放 OpenClaw 运行所需的核心端口，以 UFW 防火墙为例（大部分 Ubuntu 系统默认自带）：

生产环境中，建议配置 Nginx 反向代理，实现 HTTPS 加密访问、域名绑定，提升服务稳定性和安全性，配置示例如下：

绑定本地地址：防止管理端口直接暴露在外网，仅允许本地访问（配合反向代理使用）：
启用配对模式：限制未授权用户访问，仅允许指定账号对接（以 Telegram 为例）：
加密存储密钥：使用 OpenClaw Vault 功能，加密存储 API 密钥等敏感信息，避免明文暴露：
非 root 用户运行：创建普通用户，避免使用 root 权限运行服务，降低安全风险：

部署和使用过程中，若遇到以下问题，可参考对应解决方案快速排查：

问题现象

可能原因

解决方案

npm install 卡死/无响应

服务器内存不足（OOM）

执行 free -h 检查 Swap 配置，关闭其他占用内存的进程，或改用 pnpm 安装

启动时提示 libatomic.so.1 缺失

系统依赖库未安装

执行 sudo apt install -y libatomic1 安装缺失库

SSH 连接提示权限错误

密钥文件权限过宽

执行 chmod 600 ~/Downloads/your-key.pem 修改密钥权限

Web 界面无法访问

防火墙未放行 18789 端口

检查云服务器安全组规则，确认 18789 端口已开放，重新执行防火墙放行命令

API Key 无效/调用失败

环境变量未正确传递

检查 Docker 或 systemd 服务的环境变量配置，确保 API Key 正确填入

OpenClaw 服务无法开机自启

linger 未启用

执行 sudo loginctl enable-linger $USER 开启用户常驻，重启服务验证

部署完成后，可通过以下优化，提升 OpenClaw 运行效率、降低成本，并保障服务长期稳定。

为不同任务配置不同的 LLM 模型，实现资源合理分配：轻量级模型（如 kimi-k2.5-free）处理简单对话、自动化指令，Claude/GPT-4 处理复杂推理、多步骤任务，可降低使用成本 50% 以上。

通过 OpenClaw Web UI 安装社区插件，扩展功能边界，支持浏览器自动化、图像生成、日历同步、邮件发送等更多场景需求。

定期查看服务日志，及时排查异常，确保服务正常运行：

定期备份 ~/.openclaw/ 目录下的配置文件和 Vault 加密文件，避免配置丢失或误操作导致服务异常，建议每周备份一次。

通过云服务器部署 OpenClaw，可获得一个 7×24 小时在线、支持多平台联动的自主智能体，无论是作为个人效率工具（自动化处理日常任务），还是团队客服支持（多平台统一响应），都能发挥重要作用。

部署建议：新手优先选择阿里云、百度云的应用镜像一键部署，无需关注环境配置，快速上手；有运维经验的用户，可选择 AWS、Hetzner 等裸机服务器手动部署，获得更高的灵活性和性价比。

注意事项：部署过程中务必妥善保管 API 密钥等敏感信息，建议先在测试环境验证配置无误后，再切换至生产环境使用。