网宝
登录 快速注册
新闻中心 / / 正文

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

2026-03-01 09:42
技术部
← 返回

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龙虾🦞。有问题随时在聊天界面问它，它会越来越懂你。

 

 

QQ客服 提交工单