2026年02月02日 OpenClaw完整安装部署指南：从零开始构建AI助手

OpenClaw是一个功能强大的AI助手平台，支持多种即时通讯渠道（Telegram、WhatsApp、Discord、飞书等），集成多种大语言模型（Claude、GPT、GLM等）。本文将详细介绍如何从零开始安装和部署OpenClaw。

目录

1. OpenClaw简介
2. 系统要求
3. 安装前准备
4. Node.js安装
5. OpenClaw安装
6. 基础配置
7. 渠道配置
8. 模型配置
9. 启动和运行
10. 常见问题

1. OpenClaw简介

OpenClaw是基于Node.js构建的AI助手平台，具有以下特点：

• ✅ 多平台支持：支持Telegram、WhatsApp、Discord、飞书等主流通讯平台
• ✅ 多模型集成：支持Claude、GPT、GLM等多种大语言模型
• ✅ 插件系统：丰富的插件生态，可扩展功能
• ✅ 企业级稳定：适合生产环境部署
• ✅ 高度可定制：灵活的配置选项

2. 系统要求

在安装OpenClaw之前，请确保你的系统满足以下要求：

操作系统

• Linux（推荐：Ubuntu 20.04+、CentOS 8+、Debian 10+）
• macOS 10.15+
• Windows 10+（WSL2推荐）

硬件要求

• CPU：2核心以上
• 内存：4GB以上（推荐8GB+）
• 硬盘：10GB以上可用空间
• 网络：稳定的互联网连接

软件依赖

• Node.js 18.0+（推荐20.0+）
• npm 9.0+ 或 yarn 1.22+
• Git（可选，用于克隆源码）

3. 安装前准备

3.1 创建用户（推荐）

为了安全考虑，建议创建一个专用用户来运行OpenClaw：

# 创建用户
sudo useradd -m -s /bin/bash openclaw

# 设置密码
sudo passwd openclaw

# 添加到sudo组（可选）
sudo usermod -aG sudo openclaw

3.2 更新系统

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y

# CentOS/RHEL
sudo yum update -y

3.3 安装基础工具

# Ubuntu/Debian
sudo apt install -y git curl wget build-essential

# CentOS/RHEL
sudo yum install -y git curl wget gcc-c++ make

4. Node.js安装

OpenClaw基于Node.js开发，需要先安装Node.js环境。

4.1 使用nvm安装（推荐）

nvm（Node Version Manager）是管理Node.js版本的最佳工具：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载shell配置
source ~/.bashrc

# 安装最新LTS版本Node.js
nvm install --lts

# 切换到LTS版本
nvm use --lts

# 设置为默认版本
nvm alias default lts/*

# 验证安装
node -v
npm -v

4.2 使用包管理器安装

# Ubuntu/Debian（使用NodeSource仓库）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

5. OpenClaw安装

5.1 克隆仓库

# 克隆OpenClaw仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

5.2 安装依赖

# 安装项目依赖
npm install

# 或者使用yarn（更快）
yarn install

5.3 全局安装（可选）

# 全局安装OpenClaw CLI
npm install -g openclaw

# 验证安装
openclaw --version

6. 基础配置

6.1 初始化配置

# 运行初始化向导
openclaw init

# 或者手动创建配置文件
mkdir -p ~/.openclaw
cp config.example.json ~/.openclaw/config.json

6.2 配置文件结构

{{
  "server": {{
    "host": "0.0.0.0",
    "port": 3000,
    "logLevel": "info"
  }},
  "agent": {{
    "defaultModel": "claude-3-opus",
    "maxTokens": 4096,
    "temperature": 0.7
  }},
  "channels": {{
    "telegram": {{
      "enabled": true,
      "botToken": "your-telegram-bot-token"
    }},
    "discord": {{
      "enabled": false,
      "botToken": "your-discord-bot-token"
    }}
  }},
  "llm": {{
    "anthropic": {{
      "apiKey": "your-anthropic-api-key"
    }},
    "openai": {{
      "apiKey": "your-openai-api-key"
    }}
  }}
}}

7. 渠道配置

7.1 Telegram配置

1. 在Telegram中找到 @BotFather
2. 发送 /newbot 创建新机器人
3. 按照提示设置机器人名称
4. 获取Bot Token
5. 在配置文件中设置 botToken

# 设置环境变量
export TELEGRAM_BOT_TOKEN="your-bot-token"

# 或在配置文件中设置

7.2 Discord配置

1. 访问 Discord Developer Portal
2. 创建新应用程序
3. 创建Bot并获取Token
4. 启用必要权限
5. 邀请Bot到服务器

7.3 飞书配置

1. 在飞书开放平台创建应用
2. 配置机器人功能
3. 获取App ID和App Secret
4. 配置事件订阅和回调地址

8. 模型配置

8.1 Anthropic Claude

# 获取API Key
# 访问 https://console.anthropic.com/

"llm": {{
  "anthropic": {{
    "apiKey": "your-api-key",
    "defaultModel": "claude-3-opus-20240229"
  }}
}}

8.2 OpenAI GPT

# 获取API Key
# 访问 https://platform.openai.com/api-keys

"llm": {{
  "openai": {{
    "apiKey": "your-api-key",
    "defaultModel": "gpt-4-turbo-preview"
  }}
}}

8.3 智谱AI GLM

# 获取API Key
# 访问 https://open.bigmodel.cn/

"llm": {{
  "zhipu": {{
    "apiKey": "your-api-key",
    "defaultModel": "glm-4"
  }}
}}

9. 启动和运行

9.1 开发模式启动

# 启动开发服务器
npm run dev

# 或
yarn dev

9.2 生产模式启动

# 构建生产版本
npm run build

# 启动生产服务器
npm start

# 或使用PM2管理进程
npm install -g pm2
pm2 start npm --name "openclaw" -- start
pm2 save
pm2 startup

9.3 使用Docker部署

# 构建Docker镜像
docker build -t openclaw:latest .

# 运行容器
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw:latest

10. 常见问题

Q1: 安装依赖时出现错误？

A: 尝试清除缓存并重新安装：

npm cache clean --force
npm install

Q2: 端口被占用怎么办？

A: 修改配置文件中的端口号，或终止占用端口的进程：

# 查找占用端口的进程
lsof -i :3000

# 终止进程
kill -9 <PID>

Q3: 如何查看日志？

A: 使用以下命令查看日志：

# 开发模式
# 日志直接输出到终端

# 生产模式（PM2）
pm2 logs openclaw

# 查看最近的日志
pm2 logs openclaw --lines 100

Q4: 如何重启服务？

# 使用PM2
pm2 restart openclaw

# 或直接kill进程后重启
pm2 stop openclaw
pm2 start openclaw

Q5: 如何更新OpenClaw？

# 拉取最新代码
git pull origin main

# 安装新依赖
npm install

# 重新构建
npm run build

# 重启服务
pm2 restart openclaw

总结

通过本文，你已经学会了如何从零开始安装和部署OpenClaw。OpenClaw作为一个功能强大的AI助手平台，可以为你提供智能化的对话体验和自动化服务。

下一步