云服务器
10元起





独立服务器
  • 香港机房
  • 美国机房
  • 新加坡机房
  • 日本机房
299元起
390元起
1150元起
199元起
360元起
900元起
490元起
资讯
关于我们
（美国站）机器云-IDC.Bot
登录
网站首页
      推广加盟 渠道代理
      公司简介 联系我们 解决方案
      < 返回

      Linux环境下OpenClaw 安装与配置详细教程

      2026-03-01 09:42 作者：技术部 阅读量：2

      OpenClaw 是目前增长最快的开源自主AI代理框架（GitHub主仓库：https://github.com/openclaw/openclaw），支持完全自托管、本地优先运行。它能通过Telegram、WhatsApp、Discord等渠道接收自然语言指令，真正执行文件操作、浏览器自动化、代码提交、邮件发送等任务。

      本文针对Linux服务器/VPS/本地Ubuntu/Debian/Fedora用户，提供最完整、最实操的部署流程。目标：让你的OpenClaw在Linux上稳定24/7运行，作为个人/团队的“数字员工”。

      一、适用场景与推荐硬件

      • 个人长期在线：家用/公司闲置PC、Mac mini（装Linux）或低配VPS
      • 团队/企业级：中高配VPS（≥2核4GB内存）或专用服务器
      • 最低配置推荐（2026标准）：
        • CPU：2核（建议4核+）
        • 内存：4GB（建议8GB+，本地模型需16GB+）
        • 存储：≥50GB SSD（Memory + 技能 + 浏览器缓存）
        • 系统：Ubuntu 22.04/24.04 LTS、Debian 12、Fedora 40+（推荐Ubuntu）

      二、准备工作（10–15分钟）

      1. 更新系统 & 安装基础工具

        Bash
         
        sudo apt update && sudo apt upgrade -y          # Ubuntu/Debian
# 或
sudo dnf update -y                              # Fedora

sudo apt install -y curl git build-essential ca-certificates
         
         

      2. 安装Node.js（强烈推荐官方方式安装 v22 LTS 或更高）

        使用NodeSource官方源（最干净、最稳定）：

        Bash
         
        curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证
node --version   # 应显示 v22.x.x
npm --version
         
         

        推荐额外安装pnpm（OpenClaw官方构建常用）：

        Bash
         
        npm install -g pnpm@latest
         
         

      3. 可选但强烈推荐：安装Ollama（本地模型）

        如果想完全离线/低成本运行：

        Bash
         
        curl -fsSL https://ollama.com/install.sh | sh
ollama serve &   # 后台启动
ollama pull qwen2.5:32b   # 或 deepseek-coder-v2、llama3.1 等
         
         

      三、安装OpenClaw（推荐方式：一键脚本，3–8分钟）

      官方一键安装脚本（https://openclaw.ai/install.sh）已适配Linux：

      Bash
       
      curl -fsSL https://openclaw.ai/install.sh | bash
       
       
      • 脚本会：
        • 检测Node.js
        • 通过npm全局安装openclaw CLI
        • 创建默认工作目录（~/openclaw）
        • 安装基础依赖

      安装完成后立即验证：

      Bash
       
      openclaw --version     # 看到类似 2026.3.x 即成功
       
       

      如果一键脚本失败（极少数网络/权限问题），手动安装：

      Bash
       
      npm install -g openclaw@latest
# 或用 pnpm（更推荐）
pnpm add -g openclaw@latest
       
       

      四、运行Onboarding向导 & 核心配置（最关键步骤，10–20分钟）

      Bash
       
      openclaw onboard --install-daemon
       
       

      向导会交互式询问：

      1. 工作目录 → 默认 ~/openclaw（建议保持）
      2. 模型提供商（优先推荐顺序）：
        • Anthropic Claude（Opus/Sonnet 4）→ 输入API Key（https://console.anthropic.com）
        • OpenAI o1 / GPT-4o
        • Google Gemini（免费额度高）
        • Ollama → 输入 http://127.0.0.1:11434（本地已启动ollama）
      3. Gateway（消息中枢）设置：
        • 是否作为daemon后台运行？ → 强烈选“是”
          • Ubuntu/Debian：自动创建systemd服务
          • Fedora：类似systemd
          • 后续可手动管理：sudo systemctl status openclaw-gateway
      4. 第一个通信渠道（推荐Telegram，最稳定）：
        • 选Telegram → 去 @BotFather 创建Bot，拿到Token粘贴
        • 其他可选：WhatsApp（需手机扫码）、Discord、Slack等
        • 绑定完成后，在手机App发送 /pair 你的配对码
      5. 安全选项（必设！）：
        • 开启Read-Only模式（新手先开，AI只能读不能写/删/执行）
        • 设置PIN/密码保护高危操作（shell、文件写、邮件等）
        • 工作目录权限：chmod 700 ~/openclaw

      向导完成后，Gateway会自动启动为systemd服务。

      检查状态：

      Bash
       
      sudo systemctl status openclaw-gateway
openclaw gateway status
       
       

      五、Linux特有优化 & 后台管理

      1. 开机自启 & 重启管理

        已由 --install-daemon 自动完成。如需手动：

        Bash
         
        sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway
sudo systemctl restart openclaw-gateway
         
         

      2. 日志查看

        Bash
         
        openclaw logs                # CLI查看
journalctl -u openclaw-gateway -f   # systemd实时日志
         
         

      3. 端口 & 防火墙

        • 默认Web Dashboard：http://你的IP:18789

        • Gateway WebSocket：通常不需外网暴露

        • 防火墙示例（ufw）：

          Bash
           
          sudo ufw allow 18789/tcp
sudo ufw reload
           
           

      4. 浏览器自动化依赖（Puppeteer/Playwright）

        OpenClaw内置浏览器工具需安装Chromium：

        Bash
         
        sudo apt install -y chromium-browser fonts-liberation libappindicator3-1 libasound2 libatk-bridge2.0-0 libatk1.0-0 libcups2 libdbus-1-3 libgdk-pixbuf2.0-0 libnspr4 libnss3 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 xdg-utils
         
         

        然后在onboarding或配置文件中指定chromium路径。

      六、第一次测试（验证全链路）

      在绑定的Telegram发消息：

      • 简单读：介绍一下你自己能做什么？
      • 文件写（需关闭只读）：在~/Desktop创建文件夹OpenClawTest，里面新建hello.txt，内容“Linux上的OpenClaw已就绪🦞”
      • 网络任务：用中文总结Hacker News今天前10热门，并列出链接

      成功收到回复 → 部署完成！

      七、进阶配置建议（生产环境必看）

      • 环境变量配置文件：~/openclaw/.env 或 ~/.openclaw/config.json
        • OPENCLAW_MODEL_PROVIDER=claude
        • ANTHROPIC_API_KEY=sk-ant-...
        • OPENCLAW_READ_ONLY=false（生产慎开）
      • 多渠道：依次添加WhatsApp、Discord、企业微信等
      • 本地模型优化：用Ollama + qwen2.5:32b-instruct 或 deepseek-r1
      • 监控 & 备份：定期备份~/openclaw（含Memory.md、技能配置）
      • 安全加固：
        • 绝不给root权限
        • 用小号测试高危技能
        • 定期 openclaw update

      八、常见问题排查

      • npm install失败 → 清理缓存：npm cache clean --force，重试
      • Gateway启动失败 → 查看journalctl日志，检查端口占用
      • Telegram无响应 → 检查Bot是否被mute、Token是否正确
      • 浏览器工具报错 → 确认chromium安装 & 路径

      官方文档：https://docs.openclaw.ai 社区：https://discord.gg/clawd 或 GitHub Discussions

      现在，你的Linux服务器上已经运行着一个强大的、会干活的AI龙虾🦞。有问题随时在聊天界面问它，它会越来越懂你。

       

       

      联系我们
      返回顶部