乐于分享
好东西不私藏

腾讯云部署OpenClaw完整指南

腾讯云部署OpenClaw完整指南

腾讯云部署OpenClaw完整指南

OpenClaw是一款强大的AI Agent框架,支持多模型、多渠道接入。本文详细介绍如何在腾讯云轻量应用服务器上部署OpenClaw。

一、服务器准备

1.1 推荐配置

配置项
推荐值
CPU
2核及以上
内存
4GB及以上
存储
60GB及以上
带宽
3Mbps及以上
系统
Ubuntu 22.04

1.2 安全组设置

必须开放的端口:

  • 22 - SSH登录
  • 37779 - OpenClaw Gateway(默认端口)
  • 3000 - WebUI(可选)

安全建议:

  • 37779端口建议限制访问IP,不要直接暴露给公网
  • 生产环境建议配置Nginx反向代理+HTTPS

二、环境安装

2.1 安装Node.js

# 安装nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bashsource ~/.bashrc# 安装Node.js 22nvm install 22nvm use 22

2.2 安装pnpm

npm install -g pnpm

2.3 安装OpenClaw

pnpm install -g openclaw

三、初始化配置

3.1 首次运行

openclaw onboard

按提示完成基础配置,包括:

  • 选择模型提供商
  • 配置API Key
  • 设置管理员密码

3.2 关键配置文件

配置文件位于 ~/.openclaw/openclaw.json

重要配置项:

{"gateway":{"port":37779,"bind":"lan","auth":{"mode":"token","token":"你的访问密钥"}},"models":{"providers":{"tencent-token-plan":{"apiKey":"你的腾讯云API Key"}}}}

四、启动服务

4.1 前台运行(测试用)

openclaw gateway start

4.2 后台运行(生产环境)

# 使用pm2管理npm install -g pm2pm2 start "openclaw gateway start" --name openclawpm2 savepm2 startup

五、常见问题

5.1 端口无法访问

检查清单:

  1. 腾讯云控制台安全组是否开放端口
  2. 服务器防火墙是否放行
  3. OpenClaw是否正常启动
# 检查端口占用netstat -tlnp | grep 37779# 检查防火墙ufw status

5.2 模型调用失败

常见原因:

  • API Key配置错误
  • 余额不足
  • 网络超时

5.3 内存不足

建议4GB以上内存,如果内存紧张可以:

  • 减少并发数
  • 使用轻量模型
  • 添加Swap分区

六、安全建议

  1. 不要暴露管理端口 - 37779端口只允许内网或可信IP访问
  2. 使用强密码 - token至少16位随机字符
  3. 定期更新 - 及时更新OpenClaw版本修复安全漏洞
  4. 备份配置 - 定期备份 ~/.openclaw 目录

七、运维命令

# 查看状态openclaw status# 查看日志openclaw logs --follow# 重启服务openclaw gateway restart# 更新版本pnpm update -g openclaw

部署完成后,访问 http://你的IP:37779 即可使用OpenClaw。如有问题,可查阅官方文档或社区求助。