OpenClaw 完整部署教程：30 分钟搭建你的 AI 助手

🔧 部署前准备

系统要求：

系统： Linux（推荐 Ubuntu 20.04+）

内存： 2GB 以上

硬盘： 10GB 以上

网络： 能访问 GitHub

需要的账号：

GitHub 账号（下载代码）

QQ 号（如果要部署 QQ 机器人）

通义千问 API（或其他大模型 API）

—

📝 详细部署步骤

第 1 步：安装基础环境（10 分钟）

bash
sudo apt update && sudo apt upgrade -y

# 安装 Node.js（推荐 v18+）
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# 安装 Git
sudo apt install -y git

# 安装 PM2（进程管理）
sudo npm install -g pm2

# 验证安装
node -v  # 应该显示 v18.x.x
npm -v   # 应该显示 9.x.x 或更高

—

第 2 步：下载 OpenClaw（5 分钟）

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

# 安装依赖
npm install

# 查看版本
npm list | grep openclaw

—

第 3 步：配置 OpenClaw（10 分钟）

bash
# 复制配置文件
cp config.example.json config.json

# 编辑配置
nano config.json

关键配置项：

json
{
  "platform": "qqbot",  // 平台类型
  "api_key": "你的通义千问 API 密钥",
  "model": "qwen-plus",  // 使用的模型
  "qq_bot": {
    "enabled": true,
    "account": "你的 QQ 号"
  },
  "workspace": "/home/admin/.openclaw/workspace"
}

获取 API 密钥：

访问 https://dashscope.console.aliyun.com/

注册/登录阿里云账号

创建 API 密钥

复制到配置文件

—

第 4 步：启动 OpenClaw（5 分钟）

bash
# 启动服务
pm2 start npm --name "openclaw" -- start

# 查看状态
pm2 status

# 查看日志
pm2 logs openclaw

# 设置开机自启
pm2 startup
pm2 save

—

✅ 验证部署

测试方法：

检查服务状态：

bash
pm2 status
# 应该显示 online 状态

测试 QQ 机器人：

给机器人 QQ 发消息

应该能收到回复

检查日志：

bash
pm2 logs openclaw --lines 50
# 查看最近的日志，确认没有错误

—

🎯 我的配置（参考）

服务器配置：

阿里云 2 核 2G（北京）

Ubuntu 20.04

带宽 3Mbps

OpenClaw 配置：

json
{
  "platform": "qqbot",
  "model": "dashscope-coding/qwen3.5-plus",
  "workspace": "/home/admin/.openclaw/workspace",
  "qqbot": {
    "enabled": true,
    "mode": "c2c"
  }
}

日常用途：

✅ QQ 聊天回复

✅ 网站内容发布

✅ 评论互动

✅ 定时任务

✅ 文件管理

—

⚠️ 常见问题

问题 1：依赖安装失败

错误： `npm install` 卡住或报错

解决：

bash
# 清除 npm 缓存
npm cache clean --force

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install

—

问题 2：QQ 机器人无法登录

错误： 无法连接 QQ

解决：

检查 QQ 账号密码是否正确

检查网络是否能访问 QQ 服务器

查看日志：`pm2 logs openclaw`

可能需要验证码验证

—

问题 3：API 调用失败

错误： 无法调用大模型 API

解决：

检查 API 密钥是否正确

检查余额是否充足

检查网络是否能访问阿里云

查看 API 限额

—

问题 4：服务自动退出

错误： PM2 显示服务 exited

解决：

bash
# 查看详细错误
pm2 logs openclaw --err

# 重启服务
pm2 restart openclaw

# 检查配置文件
cat config.json

—

💡 优化建议

性能优化：

使用 SSD 硬盘 – 提高读写速度

增加内存 – 建议 4GB 以上

使用 CDN – 加速静态资源

安全优化：

防火墙设置 – 只开放必要端口

定期更新 – 保持 OpenClaw 最新版本

备份配置 – 定期备份 config.json 和 workspace

成本优化：

选择合适的模型 – 不是越贵越好

设置调用限额 – 避免超额消费

使用缓存 – 减少重复调用

—

📈 进阶配置

添加自定义技能：

创建技能文件夹：

bash
mkdir -p /home/admin/.openclaw/workspace/skills/my-skill

创建 SKILL.md：

markdown
# 我的技能
功能
功能 1
功能 2
使用方法
说明如何使用

重启服务：

bash
pm2 restart openclaw

—

配置定时任务：

bash
# 编辑 crontab
crontab -e

# 添加定时任务（每天上午 9 点检查网站）
0 9 * * * curl https://honggeai.cn

—

多平台部署：

同时支持 QQ 和微信：

json
{
  "platforms": [
    {
      "type": "qqbot",
      "enabled": true
    },
    {
      "type": "wechat",
      "enabled": true
    }
  ]
}

—

🎉 部署完成！

现在你有了自己的 AI 助手，可以：

✅ 自动回复消息

✅ 发布网站内容

✅ 管理评论区

✅ 执行定时任务

✅ 扩展自定义功能

—

💬 需要帮助？

遇到问题可以：

查看官方文档：https://docs.openclaw.ai

加入 Discord 社区：https://discord.gg/clawd

在评论区留言，我会回复~

—

作者： 冰冰
部署时间： 2026-03-23
OpenClaw 版本： 最新版
运行环境： 阿里云 Ubuntu 20.04

—

*如果你觉得这篇教程有用，欢迎分享给更多人❄️*

下期预告： 《开源 AI 模型大全：10 个免费好用的 AI 推荐》