Files
zclaw_openfang/start.sh
iven d890fa1858 feat(scripts): add unified startup scripts for full stack development
Add comprehensive startup scripts for managing all ZCLAW services:

Windows (PowerShell):
- start.ps1 / start-all.ps1 - Unified service launcher
- Supports -NoBrowser, -NoGateway, -Dev, -Stop flags

Unix (Bash):
- start.sh - Cross-platform launcher for macOS/Linux

Makefile:
- make start / make start-unix
- make desktop / make desktop-build
- make setup / make test / make clean

pnpm commands:
- pnpm start - Start all services
- pnpm start:dev - Development mode with hot reload
- pnpm start:no-browser - Skip ChromeDriver
- pnpm start:no-gateway - Skip OpenFang gateway
- pnpm desktop - Start Tauri only
- pnpm chromedriver - Start ChromeDriver only

Services managed:
1. ChromeDriver (port 4444) - Browser automation
2. OpenFang Gateway (port 4200) - AI Agent runtime
3. Tauri Desktop - React + Rust frontend

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-17 09:23:44 +08:00

189 lines
5.9 KiB
Bash

#!/bin/bash
# ZCLAW Unified Start Script for macOS/Linux
# Usage: ./start.sh [--no-browser] [--no-gateway] [--dev] [--help]
set -e
# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
CYAN='\033[0;36m'
MAGENTA='\033[0;35m'
NC='\033[0m' # No Color
# Parse arguments
NO_BROWSER=false
NO_GATEWAY=false
DEV_MODE=false
while [[ $# -gt 0 ]]; do
case $1 in
--no-browser|-nb)
NO_BROWSER=true
shift
;;
--no-gateway|-ng)
NO_GATEWAY=true
shift
;;
--dev|-d)
DEV_MODE=true
shift
;;
--help|-h)
echo "ZCLAW Unified Start Script"
echo ""
echo "Usage: ./start.sh [options]"
echo ""
echo "Options:"
echo " --no-browser, -nb Skip starting ChromeDriver"
echo " --no-gateway, -ng Skip starting OpenFang gateway"
echo " --dev, -d Start in development mode"
echo " --help, -h Show this help message"
echo ""
echo "Examples:"
echo " ./start.sh # Start all services"
echo " ./start.sh --no-browser # Start without ChromeDriver"
echo " ./start.sh --dev # Start in dev mode"
exit 0
;;
*)
echo -e "${RED}Unknown option: $1${NC}"
exit 1
;;
esac
done
# Track PIDs for cleanup
PIDS=()
cleanup() {
echo -e "\n${CYAN}[INFO]${NC} Cleaning up..."
for pid in "${PIDS[@]}"; do
if kill -0 "$pid" 2>/dev/null; then
echo -e "${CYAN}[INFO]${NC} Stopping process $pid"
kill "$pid" 2>/dev/null || true
fi
done
}
trap cleanup EXIT INT TERM
echo ""
echo -e "${MAGENTA}═══════════════════════════════════════════${NC}"
echo -e "${MAGENTA} 🦞 ZCLAW - OpenFang Desktop Client${NC}"
echo -e "${MAGENTA}═══════════════════════════════════════════${NC}"
echo ""
# 1. Check ChromeDriver
if [ "$NO_BROWSER" = false ]; then
echo -e "${CYAN}[INFO]${NC} Checking ChromeDriver..."
if command -v chromedriver &> /dev/null; then
CHROMEDRIVER_PATH=$(which chromedriver)
echo -e "${GREEN}[OK]${NC} ChromeDriver found: $CHROMEDRIVER_PATH"
# Check if already running
if ! pgrep -x "chromedriver" > /dev/null; then
echo -e "${CYAN}[INFO]${NC} Starting ChromeDriver on port 4444..."
chromedriver --port=4444 > /dev/null 2>&1 &
PIDS+=($!)
sleep 0.5
if kill -0 ${PIDS[-1]} 2>/dev/null; then
echo -e "${GREEN}[OK]${NC} ChromeDriver started (PID: ${PIDS[-1]})"
else
echo -e "${YELLOW}[WARN]${NC} ChromeDriver failed to start. It may already be running."
fi
else
echo -e "${GREEN}[OK]${NC} ChromeDriver already running"
fi
else
echo -e "${YELLOW}[WARN]${NC} ChromeDriver not found. Browser automation will not work."
echo -e "${CYAN}[INFO]${NC} Install ChromeDriver: https://chromedriver.chromium.org/downloads"
fi
else
echo -e "${CYAN}[INFO]${NC} Skipping ChromeDriver (--no-browser)"
fi
echo ""
# 2. Check OpenFang Gateway
if [ "$NO_GATEWAY" = false ]; then
echo -e "${CYAN}[INFO]${NC} Checking OpenFang Gateway..."
GATEWAY_RUNNING=false
# Check if gateway is already running
if curl -s --connect-timeout 2 http://127.0.0.1:4200/health > /dev/null 2>&1; then
GATEWAY_RUNNING=true
echo -e "${GREEN}[OK]${NC} OpenFang Gateway already running on port 4200"
fi
if [ "$GATEWAY_RUNNING" = false ]; then
if command -v openfang &> /dev/null; then
echo -e "${CYAN}[INFO]${NC} Starting OpenFang Gateway..."
openfang gateway start &
PIDS+=($!)
echo -e "${CYAN}[INFO]${NC} Waiting for gateway to be ready..."
MAX_WAIT=30
WAITED=0
while [ $WAITED -lt $MAX_WAIT ]; do
if curl -s --connect-timeout 1 http://127.0.0.1:4200/health > /dev/null 2>&1; then
echo -e "${GREEN}[OK]${NC} OpenFang Gateway started on port 4200"
break
fi
sleep 1
WAITED=$((WAITED + 1))
printf "."
done
echo ""
if [ $WAITED -ge $MAX_WAIT ]; then
echo -e "${YELLOW}[WARN]${NC} Gateway did not respond within ${MAX_WAIT}s"
fi
else
echo -e "${YELLOW}[WARN]${NC} OpenFang CLI not found. Gateway not started."
echo -e "${CYAN}[INFO]${NC} Install OpenFang: https://github.com/openfang/openfang"
fi
fi
else
echo -e "${CYAN}[INFO]${NC} Skipping OpenFang Gateway (--no-gateway)"
fi
echo ""
# 3. Start Tauri Desktop App
echo -e "${CYAN}[INFO]${NC} Starting ZCLAW Desktop..."
cd desktop
if [ "$DEV_MODE" = true ]; then
echo -e "${CYAN}[INFO]${NC} Starting in development mode..."
pnpm tauri dev
else
# Check if built version exists
if [ -f "src-tauri/target/release/ZClaw" ] || [ -f "src-tauri/target/release/ZClaw.app/Contents/MacOS/ZClaw" ]; then
echo -e "${CYAN}[INFO]${NC} Starting built application..."
if [ -f "src-tauri/target/release/ZClaw.app/Contents/MacOS/ZClaw" ]; then
open src-tauri/target/release/ZClaw.app
else
./src-tauri/target/release/ZClaw &
fi
echo -e "${GREEN}[OK]${NC} ZCLAW Desktop started"
else
echo -e "${CYAN}[INFO]${NC} Built application not found, starting in dev mode..."
pnpm tauri dev
fi
fi
# Keep script running if in dev mode
if [ "$DEV_MODE" = true ]; then
echo ""
echo -e "${CYAN}[INFO]${NC} Press Ctrl+C to stop all services..."
wait
fi