别再折腾了!OpenClaw Linux 安装完全指南:从零开始搭建你的 AI 助手

本文将详细介绍如何在 Linux 系统上安装 OpenClaw，包括一键安装、npm 安装和源码构建三种方式，以及安装过程中可能遇到的各种问题及解决方案，这篇主要写的用npm安装后详细配置过程，配置过程其实都一样。

Bash                  # 检查 Node.js 版本                  node -v                  # 检查 npm 版本                  npm -v                  # 检查 Git 是否安装                  git --version

Bash                  # 使用 NodeSource 安装 Node.js 22                  curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -                  sudo apt-get install -y nodejs                  # 验证安装                  node -v# 应显示 v22.x.x 或更高版本

Bash                  # 使用官方一键安装脚本                  curl -fsSL https://openclaw.ai/install.sh | bash

Bash                  # 临时添加（当前终端有效）                  export PATH="$(npm prefix -g)/bin:$PATH"                  # 永久添加（推荐）                  echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc                  source ~/.bashrc

Bash                  # 启动配置向导                  openclaw onboard --install-daemon

Bash                  # 安装 OpenClaw 最新版本                  npm install -g openclaw@latest                  # 验证安装                  openclaw --version

Plain Text                  # 临时设置镜像npm config set registry https://registry.npmmirror.com                  #重新执行上一步安装命令

Bash                  # 运行配置向导                  openclaw onboard --install-daemon

Bash                  # 启动 OpenClaw 网关                  openclaw gateway restart

Plain Text                  # 启动 OpenClaw 网关                  openclaw gateway restart

Plain Text                  # 临时设置镜像npm config set registry https://registry.npmmirror.com                  #重新执行上一步安装命令

好啦，你已经把龙虾养起来啦，和它一起玩吧，这个龙虾从野生到宠物，还有一个漫长过程，先熟悉，了解，有什么问题可以先问问龙虾，它的解决办法，只要大模型能连接，龙虾能启动，当然问问其他AI也可以。

龙虾聪明不聪明，跟大脑密切相关，付费的模型，在速度、限制和能力上，都会好很多，token消耗的费用也很多，自行斟酌吧。

龙虾听不听话，还能它的性格有关，SOUL.md，文件可以研究研究。

Plain Text                  openclaw config

Plain Text                  rm -rf .openclaw/extensions/feishu                  #重启,后台运行                  openclaw gateway restart                  #如果要看启动过程等，可以使用                  openclaw gateway start                  #查看日志                  openclaw logs --follow

Bash                  # Ubuntu/Debian                  sudo apt-get update                  sudo apt-get install -y git curl                  # 安装 pnpm（如果尚未安装）                  npm install -g pnpm                  # 验证 pnpm 安装                  pnpm --version

Bash                  # 克隆官方仓库                  git clone https://github.com/openclaw/openclaw.git                  # 进入项目目录                  cd openclaw

Bash                  # 使用 Gitee 镜像（国内访问更快）                  git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git                  cd openclaw-cn

Bash                  # 配置 pnpm 使用淘宝镜像（加速依赖下载）                  pnpm config set registry https://registry.npmmirror.com/

Bash                  # 安装所有依赖                  pnpm install

Bash                  export NODE_OPTIONS="--max-old-space-size=4096"                  pnpm install

Bash                  mkdir ~/.npm-global                  npm config set prefix '~/.npm-global'                  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc                  source ~/.bashrc

Bash                  # 构建前端界面                  pnpm ui:build                  # 构建完整项目                  pnpm build

Bash                  # 初始化配置                  pnpm openclaw onboard --install-daemon                  # 启动服务                  pnpm openclaw gateway

Bash                  # 创建配置目录                  mkdir -p ~/.openclaw                  # 编辑配置文件                  nano ~/.openclaw/openclaw.json

JSON                  {                  "llm": {                  "provider": "openai",                  "apiKey": "your-api-key-here",                  "model": "gpt-4"                  }                  }

Bash                  # 安装 Ollama                  curl -fsSL https://ollama.com/install.sh | sh                  # 拉取模型（以 llama2 为例）                  ollama pull llama2                  # 配置 OpenClaw 使用本地模型

JSON                  {                  "llm": {                  "provider": "ollama",                  "baseUrl": "http://localhost:11434",                  "model": "llama2"                  }                  }

Bash                  # 查找占用 3000 端口的进程                  lsof -i :3000                  # 终止进程（将替换为实际的进程 ID）          kill -9# 或使用其他端口启动           openclaw gateway --port 3001

Nginx                  location / {                  proxy_pass http://localhost:3000;                  proxy_http_version 1.1;                  proxy_set_header Upgrade $http_upgrade;                  proxy_set_header Connection "upgrade";                  proxy_set_header Host $host;                  }

JSON                  {                  "allowedOrigins": ["https://your-domain.com", "http://localhost:3000"]                  }

JSON                  {                  "trustedProxies": ["127.0.0.1", "10.0.0.0/8"]                  }

Bash                  pnpm store prune                  pnpm install

Bash                  pnpm config set proxy http://proxy.example.com:8080                  pnpm config set https-proxy http://proxy.example.com:8080

Bash                  ping registry.npmjs.org

Bash                  node -v# 必须是 v22+

Bash                  rm -rf node_modules pnpm-lock.yaml                  pnpm install                  pnpm build

Bash                  pnpm build --verbose

Bash                  sudo nano /etc/systemd/system/openclaw.service

TOML                  [Unit]                  Description=OpenClaw AI Assistant                  After=network.target                  [Service]                  Type=simple                  User=your-username                  WorkingDirectory=/home/your-username                  ExecStart=/usr/bin/openclaw gateway                  Restart=on-failure                  RestartSec=10                  [Install]                  WantedBy=multi-user.target

Bash                  # 重新加载 systemd                  sudo systemctl daemon-reload                  # 启用开机自启                  sudo systemctl enable openclaw                  # 启动服务                  sudo systemctl start openclaw                  # 查看状态                  sudo systemctl status openclaw

Bash                  # 卸载全局包                  npm uninstall -g openclaw                  # 删除配置                  rm -rf ~/.openclaw

Bash                  # 停止服务                  pkill -f openclaw                  # 删除项目目录                  cd ..                  rm -rf openclaw                  # 删除配置                  rm -rf ~/.openclaw