Linux安装OpenClaw教程：自建AI助手完全指南

摘要：Linux 是运行 OpenClaw 服务端的最强平台——无论是家用 NAS、Homelab 服务器、VPS 云主机，还是 Raspberry Pi，Linux 让你拥有最大的控制权和灵活性。本文提供 Ubuntu/Debian/CentOS 全系支持的详细安装教程，涵盖 systemd 服务配置、Docker 部署方案、防火墙安全加固，帮助你打造一台数据完全自控的私有 AI 助手服务器。

Linux 运行 OpenClaw 的独特优势

在 OpenClaw 社区里，Linux 服务器用户往往是最活跃的一批——他们搭建了最稳定的服务，构建了最复杂的自动化流程，也贡献了最多的社区技能包。Linux 用户选择 OpenClaw 的理由非常充分：

真正的永动运行

Linux 服务器（特别是 VPS 或 Homelab）通常全年不关机，配合 systemd 守护进程，OpenClaw 永不中断，甚至在崩溃时自动重启

极低硬件成本

1核1GB 的 VPS（约30元/月）就能流畅运行 OpenClaw（使用云端 API），或者用家里闲置的老电脑搭建完全免费的 AI 服务器

最强数据隐私

数据完全存储在你掌控的 Linux 机器上，结合防火墙和 SSH 密钥认证，安全级别远超任何云端服务

无限扩展性

cron 任务、webhook、API 集成、Docker 编排……Linux 生态让 OpenClaw 可以与任何服务无缝对接

系统要求与支持的发行版

发行版	版本要求	推荐程度	备注
Ubuntu	22.04 / 24.04	⭐⭐⭐⭐⭐	官方首推，最多社区支持
Debian	11 / 12	⭐⭐⭐⭐⭐	极稳定，VPS 首选
CentOS/RHEL	8 / 9	⭐⭐⭐⭐	企业环境适用
Arch Linux	最新	⭐⭐⭐⭐	极客用户首选
Raspberry Pi OS	Bookworm	⭐⭐⭐	ARM 支持，适合 Pi 5

最低配置：1核 CPU + 1GB RAM + 2GB 磁盘空间（使用云端 API）
推荐配置：2核 CPU + 2GB RAM + 10GB 磁盘空间（长期稳定运行）
本地LLM：16GB+ RAM + GPU（如使用 llama.cpp 等本地模型）

Ubuntu/Debian 完整安装流程

安装 Node.js 22（通过 NodeSource）

推荐使用 NodeSource 官方仓库安装 Node.js 22，确保版本最新且稳定：

                            # 更新系统包

                            sudo apt update && sudo apt upgrade -y

                            # 安装 curl（如未安装）

                            sudo apt install -y curl

                            # 添加 NodeSource Node.js 22 仓库

                            curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

                            # 安装 Node.js 22

                            sudo apt install -y nodejs

                            # 验证安装（应输出 v22.x.x）

                            node --version && npm --version

CentOS/RHEL 用户使用：curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - && sudo yum install -y nodejs

安装 OpenClaw

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

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

                            # 方式二：通过 npm 全局安装

                            sudo npm install -g openclaw@latest

                            # 方式三：源码安装（开发者模式）

                            git clone https://github.com/openclaw/openclaw.git

                            cd openclaw && npm install && npm run build

                            # 验证安装

                            openclaw --version

初始化配置

                            # 运行初始化向导（注意：Linux 上不要加 --install-daemon，手动配置 systemd）

                            openclaw onboard

向导会引导你完成：

选择 LLM 提供商并填写 API Key（Claude/GPT/本地模型）
配置通信频道（Telegram Bot 最推荐 Linux 服务器使用）
设定 AI 个性、工作模式和权限范围

配置 systemd 服务（开机自启 + 崩溃自动重启）

这是 Linux 服务器最关键的一步，让 OpenClaw 成为真正的系统服务：

                            # 创建 systemd 服务文件

                            sudo tee /etc/systemd/system/openclaw.service > /dev/null <<'EOF'

                            [Unit]

                            Description=OpenClaw AI Assistant

                            After=network-online.target

                            Wants=network-online.target

                            [Service]

                            Type=simple

                            User=YOUR_USERNAME

                            WorkingDirectory=/home/YOUR_USERNAME/.openclaw

                            ExecStart=/usr/bin/openclaw start

                            Restart=on-failure

                            RestartSec=10

                            StandardOutput=journal

                            StandardError=journal

                            [Install]

                            WantedBy=multi-user.target

                            EOF

                            # 重载 systemd 配置

                            sudo systemctl daemon-reload

                            # 启用开机自启

                            sudo systemctl enable openclaw

                            # 立即启动服务

                            sudo systemctl start openclaw

                            # 查看运行状态

                            sudo systemctl status openclaw

将 YOUR_USERNAME 替换为你的实际 Linux 用户名（不建议使用 root 用户运行）。

安全加固：防火墙配置（重要）

如果你的 OpenClaw 运行在公网可访问的 VPS 或服务器上，安全配置必不可少。OpenClaw 控制面板默认监听 18789 端口，需要限制只有你自己能访问：

                        # Ubuntu/Debian 使用 ufw 防火墙

                        sudo ufw allow ssh

                        # 只允许你的 IP 访问 OpenClaw Web 控制台

                        sudo ufw allow from YOUR_HOME_IP to any port 18789

                        # 或者完全屏蔽该端口（通过 Telegram 控制不需要 Web 控制台）

                        sudo ufw deny 18789

                        sudo ufw enable

                        # CentOS/RHEL 使用 firewalld

                        sudo firewall-cmd --permanent --add-port=18789/tcp --zone=trusted --source=YOUR_HOME_IP

                        sudo firewall-cmd --reload

安全建议

• 使用 SSH 密钥认证，禁止密码登录（PasswordAuthentication no）
• 定期用 sudo journalctl -u openclaw 查看日志，监控异常
• API Key 存储在 ~/.openclaw/config.json，权限设为 600
• 考虑使用 Cloudflare Tunnel 将 Web 控制台安全暴露到公网

进阶：Docker 部署方案（隔离更安全）

如果你的服务器上运行了多个服务，推荐使用 Docker 部署 OpenClaw，实现环境隔离，避免依赖冲突：

                        # 安装 Docker（如未安装）

                        curl -fsSL https://get.docker.com | sh

                        # 拉取 OpenClaw 官方镜像

                        docker pull ghcr.io/openclaw/openclaw:latest

                        # 运行 OpenClaw 容器（数据持久化到本地）

                        docker run -d \

                          --name openclaw \

                          --restart unless-stopped \

                          -v ~/.openclaw:/root/.openclaw \

                          -p 127.0.0.1:18789:18789 \

                          ghcr.io/openclaw/openclaw:latest

                        # 查看容器日志

                        docker logs -f openclaw

使用 -p 127.0.0.1:18789:18789 而非 -p 18789:18789，确保控制面板只在本地访问，不暴露到公网。

Linux 安装常见问题排查

Q 执行 npm install -g 时报 EACCES 权限错误

不要用 sudo 强制解决，而是配置 npm 全局安装到用户目录：

                                    mkdir ~/.npm-global

                                    npm config set prefix '~/.npm-global'

                                    echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc && source ~/.bashrc

                                    npm install -g openclaw@latest

Q systemd 服务启动后立即停止（状态为 failed）

查看详细错误日志定位问题：

sudo journalctl -u openclaw -n 50 --no-pager

常见原因：WorkingDirectory 路径不存在、User 用户名错误、Node.js 路径未在 PATH 中。

Q VPS 上 OpenClaw 无法连接 Claude/GPT API

某些 VPS 的网络环境可能限制访问 Anthropic/OpenAI 的服务器。最简单的解决方案是在服务器上配置 GreenVPN 的代理，或者将 API 请求通过 GreenVPN 代理转发。GreenVPN 覆盖70+国家节点，1000Mbps 千兆带宽，确保 API 调用稳定可靠。

Linux AI 服务器 + GreenVPN = 终极私有AI方案

自建 Linux AI 服务器是最高级的数据隐私保护方案。配合 GreenVPN，让你的 AI 服务器稳定访问全球 AI 接口：

✅ 解决 VPS 访问 Claude/GPT API 的网络限制
✅ 1000Mbps 千兆带宽，API 响应毫秒级
✅ 70+ 全球节点，自动选择最低延迟线路
✅ 稳定运行十年，服务器场景久经考验
✅ 30天无理由退款，零风险体验

立即免费试用 GreenVPN