openclaw-deploy.sh

#!/bin/bash
# OpenClaw 一键部署脚本
# 支持 macOS / Linux / WSL2
# 作者: OpenClaw Deployment Script
# 版本: 1.0.0

set -euo pipefail

# ==================== 颜色配置 ====================
BOLD='\033[1m'
ACCENT='\033[38;2;255;77;77m'       # 珊瑚红
INFO='\033[38;2;136;146;176m'       # 次要文本
SUCCESS='\033[38;2;0;229;204m'      # 青色成功
WARN='\033[38;2;255;176;32m'        # 琥珀色警告
ERROR='\033[38;2;230;57;70m'        # 错误红
MUTED='\033[38;2;90;100;128m'       # 静音灰
NC='\033[0m' # 无颜色

# ==================== 配置变量 ====================
MIN_NODE_VERSION="22.0.0"
OPENCLAW_PORT="${OPENCLAW_PORT:-18789}"
INSTALL_METHOD="${INSTALL_METHOD:-auto}"  # auto, npm, pnpm, bun, source
SKIP_ONBOARD="${SKIP_ONBOARD:-false}"
SKIP_DAEMON="${SKIP_DAEMON:-false}"
VERBOSE="${VERBOSE:-false}"

# ==================== 日志函数 ====================
log_info() {
    echo -e "${INFO}[INFO]${NC} $1"
}

log_success() {
    echo -e "${SUCCESS}[✓]${NC} $1"
}

log_warn() {
    echo -e "${WARN}[!]${NC} $1"
}

log_error() {
    echo -e "${ERROR}[✗]${NC} $1"
}

log_step() {
    echo -e "\n${BOLD}${ACCENT}▶ $1${NC}"
}

log_verbose() {
    if [[ "$VERBOSE" == "true" ]]; then
        echo -e "${MUTED}[VERBOSE] $1${NC}"
    fi
}

# ==================== 系统检测 ====================
detect_os() {
    local os
    os="$(uname -s 2>/dev/null || true)"
    case "$os" in
        Darwin)
            echo "macos"
            ;;
        Linux)
            if [[ -f /proc/version ]] && grep -q "Microsoft" /proc/version 2>/dev/null; then
                echo "wsl2"
            else
                echo "linux"
            fi
            ;;
        *)
            echo "unknown"
            ;;
    esac
}

detect_arch() {
    local arch
    arch="$(uname -m 2>/dev/null || true)"
    case "$arch" in
        x86_64|amd64) echo "x86_64" ;;
        arm64|aarch64) echo "arm64" ;;
        *) echo "$arch" ;;
    esac
}

detect_distro() {
    if [[ -f /etc/os-release ]]; then
        . /etc/os-release
        echo "$ID"
    elif [[ "$OSTYPE" == "darwin"* ]]; then
        echo "macos"
    else
        echo "unknown"
    fi
}

# ==================== 版本比较 ====================
version_compare() {
    if [[ "$1" == "$2" ]]; then
        return 0
    fi
    local IFS=.
    local i ver1=($1) ver2=($2)
    for ((i=0; i<${#ver1[@]}; i++)); do
        if [[ -z "${ver2[i]:-}" ]]; then
            ver2[i]=0
        fi
        if ((10#${ver1[i]} > 10#${ver2[i]})); then
            return 1
        fi
        if ((10#${ver1[i]} < 10#${ver2[i]})); then
            return 2
        fi
    done
    return 0
}

# ==================== 命令检测 ====================
command_exists() {
    command -v "$1" &> /dev/null
}

# ==================== Node.js 安装 ====================
install_nvm() {
    log_step "安装 NVM (Node Version Manager)"
    
    if [[ -d "$HOME/.nvm" ]]; then
        log_info "NVM 已安装，跳过"
        return 0
    fi
    
    log_info "下载并安装 NVM..."
    export NVM_DIR="$HOME/.nvm"
    
    # 使用国内镜像加速（可选）
    if [[ "${USE_CN_MIRROR:-false}" == "true" ]]; then
        export NVM_NODEJS_ORG_MIRROR="https://npmmirror.com/mirrors/node"
    fi
    
    if ! curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash; then
        log_error "NVM 安装失败"
        return 1
    fi
    
    # 加载 NVM
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
    
    log_success "NVM 安装完成"
}

install_node() {
    log_step "检查 Node.js 环境"
    
    local current_node_version=""
    local need_install=false
    
    if command_exists node; then
        current_node_version=$(node --version | sed 's/v//')
        log_info "当前 Node.js 版本: $current_node_version"
        
        version_compare "$current_node_version" "$MIN_NODE_VERSION"
        local cmp=$?
        if [[ $cmp -eq 2 ]]; then
            log_warn "Node.js 版本过低，需要升级"
            need_install=true
        else
            log_success "Node.js 版本满足要求"
            return 0
        fi
    else
        log_info "Node.js 未安装"
        need_install=true
    fi
    
    if [[ "$need_install" == "true" ]]; then
        log_info "正在安装 Node.js $MIN_NODE_VERSION+ ..."
        
        # 优先使用 NVM
        if [[ -d "$HOME/.nvm" ]] || command_exists nvm; then
            export NVM_DIR="$HOME/.nvm"
            [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
            
            nvm install --lts
            nvm use --lts
            nvm alias default lts/*
        else
            # 尝试系统包管理器
            local os=$(detect_os)
            local distro=$(detect_distro)
            
            case "$distro" in
                ubuntu|debian)
                    log_info "使用 NodeSource 安装 Node.js..."
                    if command_exists curl; then
                        curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
                    else
                        wget -qO- https://deb.nodesource.com/setup_22.x | sudo -E bash -
                    fi
                    sudo apt-get install -y nodejs
                    ;;
                fedora|rhel|centos)
                    log_info "使用 NodeSource 安装 Node.js..."
                    if command_exists curl; then
                        curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
                    else
                        wget -qO- https://rpm.nodesource.com/setup_22.x | sudo bash -
                    fi
                    sudo dnf install -y nodejs || sudo yum install -y nodejs
                    ;;
                arch|manjaro)
                    sudo pacman -S nodejs npm --noconfirm
                    ;;
                alpine)
                    sudo apk add --no-cache nodejs npm
                    ;;
                macos)
                    if command_exists brew; then
                        brew install node@22
                        brew link node@22 --force
                    else
                        log_error "请先安装 Homebrew: https://brew.sh"
                        return 1
                    fi
                    ;;
                *)
                    log_error "不支持的发行版: $distro"
                    log_info "请手动安装 Node.js 22+: https://nodejs.org/"
                    return 1
                    ;;
            esac
        fi
        
        # 验证安装
        if ! command_exists node; then
            log_error "Node.js 安装失败"
            return 1
        fi
        
        local new_version=$(node --version | sed 's/v//')
        log_success "Node.js $new_version 安装完成"
    fi
}

# ==================== 包管理器安装 ====================
install_package_manager() {
    log_step "检查包管理器"
    
    # 根据安装方法检查相应的包管理器
    case "$INSTALL_METHOD" in
        bun)
            if command_exists bun; then
                log_success "Bun 已安装 ($(bun --version))"
            else
                log_info "安装 Bun..."
                curl -fsSL https://bun.sh/install | bash
                export BUN_INSTALL="$HOME/.bun"
                export PATH="$BUN_INSTALL/bin:$PATH"
                log_success "Bun 安装完成"
            fi
            ;;
        pnpm)
            if command_exists npm; then
                log_success "npm 已安装 ($(npm --version))"
            else
                log_error "npm 未找到，Node.js 安装可能不完整"
                return 1
            fi
            
            if ! command_exists pnpm; then
                log_info "安装 pnpm..."
                curl -fsSL https://get.pnpm.io/install.sh | sh -
                export PNPM_HOME="$HOME/.local/share/pnpm"
                export PATH="$PNPM_HOME:$PATH"
                log_success "pnpm 安装完成"
            else
                log_success "pnpm 已安装 ($(pnpm --version))"
            fi
            ;;
        npm|auto|source)
            if command_exists npm; then
                log_success "npm 已安装 ($(npm --version))"
            else
                log_error "npm 未找到，Node.js 安装可能不完整"
                return 1
            fi
            ;;
    esac
}

# ==================== OpenClaw 安装 ====================
install_openclaw() {
    log_step "安装 OpenClaw"
    
    local install_flags=""
    
    # 检查是否已安装
    if command_exists openclaw; then
        local current_version=$(openclaw --version 2>/dev/null || echo "unknown")
        log_info "OpenClaw 已安装 ($current_version)"
        log_info "如需更新，请运行: openclaw update"
        return 0
    fi
    
    log_info "正在安装 OpenClaw..."
    
    case "$INSTALL_METHOD" in
        npm|auto)
            log_info "使用 npm 安装..."
            # 处理 sharp 编译问题
            if [[ "$(detect_os)" == "macos" ]] && command_exists brew && brew list libvips &>/dev/null; then
                log_info "检测到 Homebrew libvips，使用预构建二进制文件..."
                SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
            else
                npm install -g openclaw@latest
            fi
            ;;
        pnpm)
            log_info "使用 pnpm 安装..."
            pnpm add -g openclaw@latest
            log_info "批准构建脚本..."
            pnpm approve-builds -g || true
            ;;
        bun)
            log_info "使用 Bun 安装..."
            # 确保 Bun 在 PATH 中
            export BUN_INSTALL="$HOME/.bun"
            export PATH="$BUN_INSTALL/bin:$PATH"
            
            if ! command_exists bun; then
                log_error "Bun 未找到，请确保安装完成"
                return 1
            fi
            
            # Bun 全局安装
            bun install -g openclaw@latest
            
            # Bun 的全局 bin 路径
            local bun_bin="${BUN_INSTALL:-$HOME/.bun}/bin"
            if [[ -d "$bun_bin" ]]; then
                export PATH="$bun_bin:$PATH"
            fi
            ;;
        source)
            log_info "从源码安装..."
            install_from_source
            return $?
            ;;
        *)
            log_error "未知的安装方法: $INSTALL_METHOD"
            return 1
            ;;
    esac
    
    if ! command_exists openclaw; then
        # 尝试修复 PATH
        case "$INSTALL_METHOD" in
            bun)
                export BUN_INSTALL="$HOME/.bun"
                export PATH="$BUN_INSTALL/bin:$PATH"
                ;;
            pnpm)
                export PNPM_HOME="$HOME/.local/share/pnpm"
                export PATH="$PNPM_HOME:$PATH"
                ;;
            *)
                export PATH="$(npm prefix -g)/bin:$PATH"
                ;;
        esac
        
        if ! command_exists openclaw; then
            log_error "OpenClaw 安装失败，请检查全局安装路径"
            case "$INSTALL_METHOD" in
                bun)
                    log_info "尝试修复: export PATH=\"\$HOME/.bun/bin:\$PATH\""
                    ;;
                pnpm)
                    log_info "尝试修复: export PATH=\"\$HOME/.local/share/pnpm:\$PATH\""
                    ;;
                *)
                    log_info "尝试修复: export PATH=\"\$(npm prefix -g)/bin:\$PATH\""
                    ;;
            esac
            return 1
        fi
    fi
    
    log_success "OpenClaw 安装完成 ($(openclaw --version 2>/dev/null || echo 'unknown'))"
}

install_from_source() {
    log_info "从源码构建 OpenClaw..."
    
    if ! command_exists git; then
        log_error "请先安装 git"
        return 1
    fi
    
    if ! command_exists pnpm; then
        log_info "安装 pnpm..."
        curl -fsSL https://get.pnpm.io/install.sh | sh -
        export PNPM_HOME="$HOME/.local/share/pnpm"
        export PATH="$PNPM_HOME:$PATH"
    fi
    
    local source_dir="${OPENCLAW_SOURCE_DIR:-$HOME/openclaw-source}"
    
    if [[ -d "$source_dir" ]]; then
        log_info "更新现有源码..."
        cd "$source_dir"
        git pull
    else
        log_info "克隆 OpenClaw 仓库..."
        git clone https://github.com/openclaw/openclaw.git "$source_dir"
        cd "$source_dir"
    fi
    
    log_info "安装依赖..."
    pnpm install
    
    log_info "构建 UI..."
    pnpm ui:build
    
    log_info "构建项目..."
    pnpm build
    
    log_info "链接全局命令..."
    pnpm link --global
    
    log_success "源码构建完成"
}

# ==================== 运行向导 ====================
run_onboarding() {
    if [[ "$SKIP_ONBOARD" == "true" ]]; then
        log_info "跳过向导 (--no-onboard)"
        return 0
    fi
    
    log_step "运行 OpenClaw 配置向导"
    
    local onboard_flags=""
    if [[ "$SKIP_DAEMON" != "true" ]]; then
        onboard_flags="--install-daemon"
    fi
    
    log_info "启动向导..."
    openclaw onboard $onboard_flags || {
        log_warn "向导未完成，您可以稍后手动运行: openclaw onboard"
        return 0
    }
    
    log_success "向导完成"
}

# ==================== 系统服务 ====================
setup_daemon() {
    if [[ "$SKIP_DAEMON" == "true" ]]; then
        log_info "跳过守护进程安装"
        return 0
    fi
    
    log_step "配置系统服务"
    
    local os=$(detect_os)
    
    # 检查服务状态
    if openclaw gateway status &>/dev/null; then
        log_success "Gateway 服务已在运行"
        return 0
    fi
    
    log_info "启动 Gateway..."
    if [[ "$os" == "macos" ]]; then
        log_info "macOS 服务通过 launchd 管理"
    else
        log_info "Linux 服务通过 systemd 管理"
    fi
    
    log_info "您可以通过以下命令管理服务:"
    log_info "  查看状态: openclaw gateway status"
    log_info "  启动服务: openclaw gateway start"
    log_info "  停止服务: openclaw gateway stop"
    log_info "  重启服务: openclaw gateway restart"
}

# ==================== 健康检查 ====================
health_check() {
    log_step "运行健康检查"
    
    log_info "运行 doctor 检查..."
    openclaw doctor || {
        log_warn "Doctor 发现一些问题，请查看上方输出"
    }
    
    log_info "检查 Gateway 状态..."
    if openclaw gateway status &>/dev/null; then
        log_success "Gateway 运行正常"
    else
        log_warn "Gateway 未运行，您可以稍后启动: openclaw gateway start"
    fi
}

# ==================== 显示信息 ====================
show_summary() {
    log_step "部署完成"
    
    echo ""
    echo -e "${BOLD}${SUCCESS}OpenClaw 部署成功!${NC}"
    echo ""
    echo -e "${BOLD}可用命令:${NC}"
    echo -e "  ${INFO}openclaw --help${NC}          显示帮助"
    echo -e "  ${INFO}openclaw dashboard${NC}       打开 Web 控制面板"
    echo -e "  ${INFO}openclaw gateway status${NC}  查看 Gateway 状态"
    echo -e "  ${INFO}openclaw agent${NC}           启动 AI 对话"
    echo -e "  ${INFO}openclaw doctor${NC}          运行诊断"
    echo ""
    echo -e "${BOLD}配置文件位置:${NC}"
    echo -e "  ${INFO}~/.openclaw/${NC}            工作目录"
    echo -e "  ${INFO}~/.openclaw/config.json${NC}  主配置文件"
    echo ""
    echo -e "${BOLD}文档链接:${NC}"
    echo -e "  ${INFO}https://docs.openclaw.ai${NC}  官方文档"
    echo -e "  ${INFO}https://discord.gg/clawd${NC}  Discord 社区"
    echo ""
    
    # 尝试打开 dashboard
    if command_exists open && [[ "$(detect_os)" == "macos" ]]; then
        echo -e "${BOLD}是否打开 Dashboard? (y/n)${NC}"
        read -r response
        if [[ "$response" =~ ^[Yy]$ ]]; then
            openclaw dashboard
        fi
    fi
}

# ==================== 主流程 ====================
main() {
    # 显示横幅
    echo -e "${BOLD}"
    echo "   ____                      __                __"
    echo "  / __ \____  ___  _________/ /     __________/ /"
    echo " / / / / __ \/ _ \/ ___/ __  /_____/ ___/ ___/ / "
    echo "/ /_/ / /_/ /  __/ /  / /_/ /_____(__  |__  ) /  "
    echo "\____/ .___/\___/_/   \__,_/     /____/____/_/   "
    echo "    /_/  一键部署脚本 v1.0.0"
    echo -e "${NC}"
    
    log_info "开始部署 OpenClaw..."
    log_info "检测到系统: $(detect_os) ($(detect_arch))"
    
    # 检查必需命令
    if ! command_exists curl && ! command_exists wget; then
        log_error "需要 curl 或 wget 来下载文件"
        exit 1
    fi
    
    # 执行安装步骤
    install_node
    install_package_manager
    install_openclaw
    run_onboarding
    setup_daemon
    health_check
    show_summary
}

# ==================== 参数解析 ====================
print_usage() {
    cat << EOF
OpenClaw 一键部署脚本

用法: $0 [选项]

选项:
  -h, --help              显示此帮助信息
  -v, --verbose           启用详细输出
  -m, --method METHOD     安装方法: auto, npm, pnpm, bun, source (默认: auto)
  --no-onboard            跳过配置向导
  --no-daemon             不安装系统服务
  --cn-mirror             使用国内镜像加速
  --port PORT             设置 Gateway 端口 (默认: 18789)

示例:
  $0                      使用默认设置安装 (npm)
  $0 --method pnpm        使用 pnpm 安装
  $0 --method bun         使用 Bun 安装 (最快)
  $0 --method source      从源码安装
  $0 --no-onboard         安装但不运行向导
  $0 --cn-mirror          使用国内镜像加速

环境变量:
  OPENCLAW_PORT           Gateway 端口
  OPENCLAW_SOURCE_DIR     源码安装目录 (默认: ~/openclaw-source)
  USE_CN_MIRROR           使用国内镜像 (true/false)

EOF
}

# 解析命令行参数
while [[ $# -gt 0 ]]; do
    case $1 in
        -h|--help)
            print_usage
            exit 0
            ;;
        -v|--verbose)
            VERBOSE="true"
            shift
            ;;
        -m|--method)
            INSTALL_METHOD="$2"
            shift 2
            ;;
        --no-onboard)
            SKIP_ONBOARD="true"
            shift
            ;;
        --no-daemon)
            SKIP_DAEMON="true"
            shift
            ;;
        --cn-mirror)
            export USE_CN_MIRROR="true"
            shift
            ;;
        --port)
            OPENCLAW_PORT="$2"
            shift 2
            ;;
        *)
            log_error "未知参数: $1"
            print_usage
            exit 1
            ;;
    esac
done

# 运行主程序
main