AI小龙虾OpenClaw安装与端口配置指南

环境要求

系统要求

• 操作系统: Ubuntu 20.04 LTS / CentOS 8+ / Windows Server 2019+
• 内存: 最低16GB，推荐32GB以上
• 存储: 至少100GB可用空间
• 网络: 稳定网络连接，建议固定IP

软件依赖

Python 3.8+
Docker 20.10+
Node.js 16+
Redis 6.0+
PostgreSQL 13+

安装步骤

下载安装包

# 从官方仓库克隆
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 或者下载发布版本
wget https://download.openclaw.org/v2.1.0/openclaw-server.tar.gz
tar -zxvf openclaw-server.tar.gz

使用Docker安装（推荐）

# 拉取官方镜像
docker pull openclaw/openclaw:latest
# 运行容器
docker run -d --name openclaw \
  -p 8080:8080 \
  -p 9090:9090 \
  -v /data/openclaw:/app/data \
  openclaw/openclaw:latest

源码编译安装

# 安装依赖
pip install -r requirements.txt
npm install
# 编译前端
npm run build
# 启动服务
python app/main.py

端口配置详解

默认端口分配

服务名称	默认端口	协议	说明
Web管理界面	8080	HTTP	管理控制台
API服务	9090	HTTP/HTTPS	RESTful API
WebSocket服务	9091	WS/WSS	实时通信
数据库	5432	TCP	PostgreSQL
缓存服务	6379	TCP	Redis
监控端口	9100	HTTP	性能监控

配置文件修改

Docker环境变量配置

# docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "8080:8080"    # Web界面
      - "9090:9090"    # API服务
      - "9091:9091"    # WebSocket
    environment:
      - SERVER_PORT=9090
      - WEB_PORT=8080
      - WS_PORT=9091
      - DB_PORT=5432
      - REDIS_PORT=6379

配置文件修改

# config/application.ini
[server]
port = 9090
web_port = 8080
ws_port = 9091
[database]
host = localhost
port = 5432
name = openclaw_db
[redis]
host = localhost
port = 6379

命令行参数配置

# 启动时指定端口
python main.py --web-port 8080 --api-port 9090 --ws-port 9091
# 或使用环境变量
export OPENCLAW_WEB_PORT=8080
export OPENCLAW_API_PORT=9090
python main.py

安全配置

防火墙设置

# Ubuntu/Debian
sudo ufw allow 8080/tcp
sudo ufw allow 9090/tcp
sudo ufw allow 9091/tcp
sudo ufw reload
# CentOS/RHEL
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --permanent --add-port=9090/tcp
sudo firewall-cmd --reload

HTTPS配置（推荐）

# Nginx反向代理配置
server {
    listen 443 ssl;
    server_name openclaw.yourdomain.com;
    ssl_certificate /path/to/certificate.crt;
    ssl_certificate_key /path/to/private.key;
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
    }
    location /api {
        proxy_pass http://localhost:9090;
        proxy_set_header Host $host;
    }
}

端口冲突解决方案

常见冲突及处理

1. 8080端口被占用

   # 查看占用进程
   sudo lsof -i :8080

修改OpenClaw端口

方法1：修改配置文件

方法2：启动参数 --web-port 8081

2. **批量修改端口脚本**
```bash
#!/bin/bash
# change_ports.sh
sed -i 's/port = 9090/port = 9190/g' config/application.ini
sed -i 's/web_port = 8080/web_port = 8180/g' config/application.ini

验证安装

检查服务状态

# 检查端口监听
netstat -tulpn | grep -E '(8080|9090|9091)'
# 检查容器状态
docker ps | grep openclaw
# 检查服务健康
curl http://localhost:9090/health

访问管理界面

1. 打开浏览器访问 http://your-server-ip:8080
2. 默认登录账号：admin / admin123
3. 首次登录请修改密码

故障排查

常见问题

1. 端口无法访问

   

   • 检查防火墙设置
   • 验证服务是否正常启动
   • 查看日志文件 logs/openclaw.log

2. 端口冲突

   • 使用 netstat 查找占用进程
   • 修改配置文件中的端口号
   • 重启相关服务

3. 性能问题

   • 监控端口 9100 的 metrics
   • 调整连接池大小
   • 检查数据库性能

升级与维护

端口配置备份

# 备份配置文件
cp config/application.ini config/application.ini.backup
cp docker-compose.yml docker-compose.yml.backup
# 导出当前配置
docker exec openclaw env | grep PORT > ports_backup.txt

版本升级

# 停止服务
docker-compose down
# 备份数据
cp -r /data/openclaw /backup/openclaw_$(date +%Y%m%d)
# 更新配置
# 修改新版本的端口配置，确保与旧版本一致
# 启动新版本
docker-compose up -d

注意事项

1. 生产环境建议使用非默认端口增强安全性
2. 定期更新SSL证书和系统补丁
3. 监控端口访问日志，及时发现异常
4. 备份配置文件，便于灾难恢复

如需进一步帮助,请参考官方文档或联系技术支持团队。