部署不踩坑,这份清单帮你
环境准备
✅ 服务器配置
- CPU:4 核以上
- 内存:8GB 以上
- 存储:100GB SSD
- 网络:稳定带宽
✅ 软件依赖
- Node.js 18+
- Python 3.8+
- Git
- Docker(可选)
安装步骤
✅ 安装 OpenClaw
# 下载安装脚本
curl -fsSL https://get.openclaw.ai | bash
# 验证安装
openclaw version
✅ 初始化配置
# 创建配置目录
openclaw init
# 检查配置
openclaw config check
配置检查
✅ 模型配置
model:
default: deepseek-chat
providers:
deepseek:
api_key: ${DEEPSEEK_API_KEY} # ✅ 环境变量
检查项:
- API Key 已设置
- API Key 有效
- 余额充足
✅ 渠道配置
channels:
- name: telegram-bot
type: telegram
token: ${TELEGRAM_BOT_TOKEN}
检查项:
- Token 已设置
- Token 有效
- Bot 已启动
✅ 数据库配置
database:
type: postgresql
host: localhost
port: 5432
检查项:
- 数据库已创建
- 用户权限正确
- 连接正常
安全配置
✅ 认证配置
auth:
enabled: true
type: bearer
token: ${API_TOKEN}
检查项:
- Token 已生成
- Token 长度足够(32+ 字符)
- Token 已安全存储
✅ 网络安全
security:
https:
enabled: true
cert: /path/to/cert.pem
key: /path/to/key.pem
ip_whitelist:
- 127.0.0.1
- 192.168.1.0/24
检查项:
- SSL 证书有效
- 白名单配置正确
- 防火墙已配置
性能配置
✅ 缓存配置
cache:
enabled: true
type: redis
ttl: 3600
检查项:
- Redis 已启动
- 连接正常
- 内存足够
✅ 并发配置
concurrency:
max_workers: 10
queue_size: 100
检查项:
- 资源足够
- 限制合理
监控配置
✅ 日志配置
logging:
level: info
file: ~/.openclaw/logs/openclaw.log
rotation:
max_size: 10MB
max_files: 10
检查项:
- 日志目录存在
- 写入权限正确
- 轮转配置合理
✅ 健康检查
healthcheck:
enabled: true
endpoint: /health
interval: 30s
检查项:
- 健康检查端点可访问
- 响应正确
✅ 告警配置
alerts:
- name: service-down
condition: health_check_failed
action: send-telegram
检查项:
- 告警渠道已配置
- 测试告警已发送
备份配置
✅ 数据备份
backup:
enabled: true
schedule: "0 2 * * *"
retention: 7d
destination: s3://backup-bucket/
检查项:
- 备份目录可写
- 云存储配置正确
- 恢复测试通过
启动检查
✅ 启动前检查
# 检查配置
openclaw config check
# 检查依赖
openclaw doctor
# 测试模型
openclaw test --model deepseek-chat
# 测试渠道
openclaw channel test telegram-bot
✅ 启动
# 启动
openclaw start
# 检查状态
openclaw status
# 查看日志
openclaw logs --tail 50
功能验证
✅ 对话测试
# 测试对话
openclaw chat "你好"
# 预期:正常响应
✅ 渠道测试
# Telegram 测试
在 Telegram 发送消息,检查是否响应
# 预期:正常响应
✅ 心跳测试
# 测试心跳任务
openclaw heartbeat test --task daily-report
# 预期:任务执行成功
上线后监控
✅ 第一小时
- 检查日志无错误
- 检查响应时间正常
- 检查内存稳定
- 检查 CPU 正常
✅ 第一天
- 检查日志无异常
- 检查备份成功
- 检查成本正常
- 检查用户反馈
✅ 第一周
- 检查稳定性
- 检查性能
- 检查成本
- 优化调整
常见问题排查
问题 1:启动失败
检查:
openclaw logs --tail 100
常见原因:
- 端口被占用
- 配置错误
- 权限不足
问题 2:无响应
检查:
openclaw status
curl http://localhost:3000/health
常见原因:
- 模型 API 错误
- 网络问题
- 内存不足
问题 3:响应慢
检查:
openclaw stats --performance
常见原因:
- 模型响应慢
- 历史太长
- 内存不足
回滚计划
准备
# 备份当前版本
cp -r ~/.openclaw ~/.openclaw.backup
# 记录版本
openclaw version > /tmp/openclaw.version
回滚
# 停止服务
openclaw stop
# 恢复备份
rm -rf ~/.openclaw
mv ~/.openclaw.backup ~/.openclaw
# 重启
openclaw start
部署完成确认
✅ 清单
- 服务正常运行
- 对话功能正常
- 渠道连接正常
- 心跳任务正常
- 监控告警正常
- 备份恢复正常
- 文档已更新
上线!
# 一键部署检查
openclaw deploy --check-all
# 输出
✅ 配置检查通过
✅ 依赖检查通过
✅ 测试检查通过
✅ 监控检查通过
🚀 准备上线!
💬 你部署时遇到什么问题?评论区分享!
🎯 需要部署服务?微信:yang1002378395