# 更新包管理器
sudo apt update
sudo apt upgrade -y
# 安裝基礎(chǔ)編譯工具
sudo apt install -y build-essential cmake git curl wget
# 安裝 Python 相關(guān)
sudo apt install -y python3 python3-pip python3-venv python3-dev
# 安裝其他依賴
sudo apt install -y libssl-dev libffi-dev libxml2-dev libxslt1-dev zlib1g-dev

# 安裝基礎(chǔ)工具
sudo yum install -y epel-release
sudo yum groupinstall -y "Development Tools"
sudo yum install -y cmake git curl wget
# 安裝 Python
sudo yum install -y python3 python3-pip python3-devel
# 安裝其他依賴
sudo yum install -y openssl-devel libffi-devel libxml2-devel libxslt-devel zlib-devel

# 安裝 Homebrew（如果未安裝）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安裝依賴
brew install cmake git python3 openssl

# 克隆 openclaw 倉庫
git clone https://github.com/your-org/openclaw.git
cd openclaw
# 或者使用 SSH 方式
# git clone git@github.com:your-org/openclaw.git

# 創(chuàng)建 Python 虛擬環(huán)境
python3 -m venv venv
# 激活虛擬環(huán)境
# Linux/macOS
source venv/bin/activate
# Windows
# venv\Scripts\activate

# 升級(jí) pip
pip install --upgrade pip
# 安裝項(xiàng)目依賴
pip install -r requirements.txt
# 如果項(xiàng)目有開發(fā)依賴
if [ -f requirements-dev.txt ]; then
    pip install -r requirements-dev.txt
fi

# 檢查是否有額外的安裝腳本
if [ -f scripts/install_deps.sh ]; then
    chmod +x scripts/install_deps.sh
    ./scripts/install_deps.sh
fi

# 復(fù)制環(huán)境變量配置文件
cp .env.example .env
# 復(fù)制應(yīng)用配置文件
if [ -f config/config.example.yaml ]; then
    cp config/config.example.yaml config/config.yaml
fi

# 應(yīng)用配置
APP_NAME=openclaw
APP_ENV=production
APP_DEBUG=false
APP_URL=http://localhost:8000
# 數(shù)據(jù)庫配置（根據(jù)實(shí)際使用的數(shù)據(jù)庫調(diào)整）
DB_CONNECTION=sqlite
DB_DATABASE=database/openclaw.db
# 或者使用 MySQL
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=openclaw
# DB_USERNAME=root
# DB_PASSWORD=your_password
# Redis 配置（可選）
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=
# 安全配置
APP_KEY=generate_a_secure_random_key_here

# 如果項(xiàng)目使用 Flask/Django 等框架，可能需要生成密鑰
python -c "import secrets; print(secrets.token_hex(32))"
# 將生成的密鑰填入 APP_KEY

# 創(chuàng)建數(shù)據(jù)庫目錄
mkdir -p database
# 初始化數(shù)據(jù)庫
python manage.py migrate  # Django 項(xiàng)目
# 或
flask db upgrade  # Flask 項(xiàng)目
# 或根據(jù)項(xiàng)目的實(shí)際命令

# 登錄 MySQL
mysql -u root -p
# 創(chuàng)建數(shù)據(jù)庫
CREATE DATABASE openclaw CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
# 創(chuàng)建用戶并授權(quán)
CREATE USER 'openclaw_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON openclaw.* TO 'openclaw_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

# 根據(jù)項(xiàng)目框架執(zhí)行相應(yīng)的遷移命令
python manage.py migrate  # Django
# 或
flask db upgrade  # Flask
# 或
alembic upgrade head  # SQLAlchemy

# 如果有種子數(shù)據(jù)
python manage.py loaddata initial_data.json  # Django
# 或
python scripts/seed_data.py  # 自定義腳本

# 啟動(dòng)開發(fā)服務(wù)器
python manage.py runserver 0.0.0.0:8000  # Django
# 或
flask run --host=0.0.0.0 --port=8000  # Flask
# 或
uvicorn main:app --host 0.0.0.0 --port 8000 --reload  # FastAPI

# 安裝 Gunicorn
pip install gunicorn
# 啟動(dòng)服務(wù)
gunicorn --workers 4 --bind 0.0.0.0:8000 wsgi:app

# 創(chuàng)建 systemd 服務(wù)文件
sudo tee /etc/systemd/system/openclaw.service << EOF
[Unit]
Description=openclaw Web Service
After=network.target
[Service]
User=www-data
Group=www-data
WorkingDirectory=/path/to/openclaw
Environment="PATH=/path/to/openclaw/venv/bin"
ExecStart=/path/to/openclaw/venv/bin/gunicorn --workers 4 --bind unix:/tmp/openclaw.sock wsgi:app
Restart=always
[Install]
WantedBy=multi-user.target
EOF
# 重新加載 systemd
sudo systemctl daemon-reload
# 啟動(dòng)服務(wù)
sudo systemctl start openclaw
sudo systemctl enable openclaw

# 構(gòu)建 Docker 鏡像
docker build -t openclaw:latest .
# 運(yùn)行容器
docker run -d \
  --name openclaw \
  -p 8000:8000 \
  -v $(pwd)/.env:/app/.env \
  openclaw:latest

# 檢查服務(wù)是否運(yùn)行
curl -I http://localhost:8000
# 或使用瀏覽器訪問
# http://localhost:8000

# 如果項(xiàng)目有健康檢查端點(diǎn)
curl http://localhost:8000/health
# 或
curl http://localhost:8000/api/health

# 查看應(yīng)用日志
tail -f logs/app.log
# 或使用 systemd 查看
sudo journalctl -u openclaw -f

ERROR: Could not find a version that satisfies the requirement some-package
ERROR: No matching distribution found for some-package

# 升級(jí) pip
pip install --upgrade pip
# 使用國內(nèi)鏡像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 或指定 Python 版本
python3.8 -m pip install -r requirements.txt

OperationalError: (2003, "Can't connect to MySQL server on 'localhost' ([Errno 111] Connection refused)")

# 檢查 MySQL 服務(wù)狀態(tài)
sudo systemctl status mysql
# 啟動(dòng) MySQL 服務(wù)
sudo systemctl start mysql
# 檢查防火墻設(shè)置
sudo ufw allow 3306/tcp
# 驗(yàn)證數(shù)據(jù)庫連接
mysql -u username -p -h localhost

OSError: [Errno 98] Address already in use

# 查找占用端口的進(jìn)程
sudo lsof -i :8000
# 終止占用進(jìn)程
sudo kill -9 <PID>
# 或使用其他端口
python manage.py runserver 0.0.0.0:8080

PermissionError: [Errno 13] Permission denied: '/path/to/file'

# 修改目錄權(quán)限
sudo chown -R $USER:$USER /path/to/openclaw
# 或給特定目錄添加寫權(quán)限
chmod -R 755 database/
chmod -R 755 logs/

KeyError: 'APP_KEY'
或
ImproperlyConfigured: Set the APP_KEY environment variable

# 檢查 .env 文件是否存在
ls -la .env
# 檢查文件內(nèi)容
cat .env
# 手動(dòng)加載環(huán)境變量
export $(cat .env | xargs)
# 檢查是否安裝了 python-dotenv
pip install python-dotenv

openclaw/
├── app/                    # 應(yīng)用主目錄
│   ├── __init__.py
│   ├── models.py          # 數(shù)據(jù)模型
│   ├── views.py           # 視圖函數(shù)
│   └── utils.py           # 工具函數(shù)
├── config/                # 配置文件
│   ├── config.yaml
│   └── config.example.yaml
├── database/              # 數(shù)據(jù)庫文件
├── logs/                  # 日志目錄
├── requirements.txt       # Python 依賴
├── .env.example          # 環(huán)境變量模板
├── manage.py             # 管理腳本（Django）
├── wsgi.py               # WSGI 入口
└── README.md             # 項(xiàng)目說明

# 更新代碼
git pull origin main
# 更新依賴
pip install -r requirements.txt --upgrade
# 運(yùn)行測(cè)試
pytest tests/
# 備份數(shù)據(jù)庫
cp database/openclaw.db database/openclaw.db.backup.$(date +%Y%m%d)