零基础部署OpenClaw，免费云服务器手把手教学
前言
本教程旨在帮助零基础用户免费部署OpenClaw（小龙虾）服务，全程使用免费云服务器，手把手教学。请确保你有基本的网络认知，并准备好注册云服务商账户。
准备工作
1. 注册免费云服务器
推荐使用Oracle Cloud免费层或Google Cloud免费额度。以Oracle Cloud为例：访问官网，注册账户，创建一台Ubuntu 20.04实例（配置选择“始终免费”）。注意选择区域时避开热门区域，以免资源不足。
2. 获取服务器IP和SSH密钥
创建实例后，记录公网IP，下载私钥文件（.pem）。设置安全组开放必要端口（如80、443、22等）。
连接服务器
使用SSH客户端连接：Windows推荐Putty或Windows Terminal，Mac/Linux直接终端。命令示例：
ssh -i ~/.ssh/your-key.pem ubuntu@your-server-ip若第一次连接，会提示确认指纹，输入yes回车。
部署OpenClaw
1. 更新系统并安装依赖
sudo apt update && sudo apt upgrade -y
sudo apt install git curl wget -y2. 安装Docker
使用官方脚本安装Docker：
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh将当前用户加入docker组：
sudo usermod -aG docker $USER
newgrp docker3. 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose4. 克隆OpenClaw项目
git clone https://github.com/openclaw/openclaw.git
cd openclaw5. 配置环境变量
复制示例配置文件：
cp .env.example .env编辑.env文件，设置数据库密码、JWT密钥等敏感信息。至少修改：
JWT_SECRET：任意复杂字符串DB_PASSWORD：数据库密码
保存退出。
6. 启动服务
docker-compose up -d等待数分钟，第一次会拉取镜像。查看日志确认无错误：
docker-compose logs -f看到类似"Listening on port 3000"表示启动成功。
访问与验证
在浏览器输入 http://服务器IP:3000，应看到OpenClaw登录页面。默认管理员账号: admin，密码: admin123（首次登录后请立即修改）。
避坑指南
- 服务器区域选择：免费实例在某些区域可能抢不到，多尝试或使用脚本抢注。
- 安全组设置：必须允许入站80和3000端口，否则无法访问。
- 端口冲突：如果3000已被占用，修改docker-compose.yml中映射端口。
- 数据库持久化：默认docker-compose使用volume，但注意备份数据。
- 升级：进入项目目录，执行
git pull && docker-compose up -d即可升级。
常见问题
| 问题 | 解决方法 |
|---|---|
| 连接服务器超时 | 检查安全组是否放行22端口，以及IP是否正确。 |
| docker-compose命令不存在 | 确认安装路径，或使用docker compose（新版docker集成） |
| 页面空白 | 查看容器日志：docker-compose logs web，排查依赖错误。 |
| 无法登录 | 尝试重置密码：进入容器执行node cli reset-password。 |
总结
至此，你已经成功在免费云服务器上部署了OpenClaw。本教程覆盖了从零到可用的全流程，注意避坑指南中的常见错误。如有问题，建议查阅官方文档或社区。
