@yyy9527/openclaw-manager 0.1.0

package/scripts/check_env.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+ENV_FILE="${OPENCLAW_DOTENV_FILE:-${PROJECT_ROOT}/.env}"
+CONFIG_FILE="${OPENCLAW_CONFIG_FILE:-${PROJECT_ROOT}/config/openclaw.env}"
+
+log() {
+  printf '[check-env] %s\n' "$*"
+}
+
+warn() {
+  printf '[check-env][WARN] %s\n' "$*" >&2
+}
+
+if [ ! -f "${ENV_FILE}" ]; then
+  warn "未找到环境文件：${ENV_FILE}"
+  warn "请先从 .env.example 复制并填写，或通过 --env-file 指定其他文件。"
+  exit 1
+fi
+
+set -a
+# shellcheck source=/dev/null
+[ -f "${CONFIG_FILE}" ] && source "${CONFIG_FILE}"
+# shellcheck source=/dev/null
+source "${ENV_FILE}"
+set +a
+
+missing=()
+require_var() {
+  local key="$1"
+  if [ -z "${!key:-}" ]; then
+    missing+=("${key}")
+  fi
+}
+
+# 基础协作能力必需项
+require_var "GIT_TOKEN"
+
+# 飞书开启时必需项
+if [ "${FEISHU_ENABLED:-true}" = "true" ]; then
+  require_var "FEISHU_WEBHOOK_URL"
+fi
+
+if [ "${#missing[@]}" -gt 0 ]; then
+  warn "检测到缺失的环境变量（来源：${ENV_FILE}）："
+  for key in "${missing[@]}"; do
+    warn "  - ${key}"
+  done
+  warn "请补齐后重试。"
+  exit 1
+fi
+
+log ".env 关键变量检查通过"

package/scripts/health_check.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+CONFIG_FILE="${OPENCLAW_CONFIG_FILE:-${PROJECT_ROOT}/config/openclaw.env}"
+ENV_FILE="${OPENCLAW_DOTENV_FILE:-${PROJECT_ROOT}/.env}"
+
+log() {
+  printf '[health-check] %s\n' "$*"
+}
+
+fail() {
+  printf '[health-check][ERROR] %s\n' "$*" >&2
+  exit 1
+}
+
+require_cmd() {
+  local cmd="$1"
+  command -v "${cmd}" >/dev/null 2>&1 || fail "缺少命令：${cmd}"
+}
+
+api_get() {
+  local url="$1"
+  curl --silent --show-error \
+    -H "Accept: application/json" \
+    "${url}"
+}
+
+load_env() {
+  [ -f "${CONFIG_FILE}" ] || fail "缺少配置文件：${CONFIG_FILE}"
+  [ -f "${ENV_FILE}" ] || fail "缺少环境文件：${ENV_FILE}"
+  set -a
+  # shellcheck source=/dev/null
+  source "${CONFIG_FILE}"
+  # shellcheck source=/dev/null
+  source "${ENV_FILE}"
+  set +a
+}
+
+check_docker() {
+  log "检查 Docker daemon 状态"
+  docker info >/dev/null 2>&1 || fail "Docker daemon 不可用，请先启动 Docker Desktop"
+}
+
+check_gitee() {
+  [ "${GIT_PLATFORM}" = "gitee" ] || fail "当前只支持 gitee 健康检查，检测到 GIT_PLATFORM=${GIT_PLATFORM}"
+  : "${GIT_API_BASE:?GIT_API_BASE 未配置}"
+  : "${GIT_REPO:?GIT_REPO 未配置}"
+  : "${GIT_TOKEN:?GIT_TOKEN 未配置}"
+
+  log "检查 Gitee 用户令牌有效性"
+  local user_json
+  user_json="$(api_get "${GIT_API_BASE}/user?access_token=${GIT_TOKEN}")"
+  local user_message
+  user_message="$(printf '%s' "${user_json}" | jq -r '.message // empty')"
+  [ -z "${user_message}" ] || fail "Gitee 用户鉴权失败：${user_message}"
+  local login
+  login="$(printf '%s' "${user_json}" | jq -r '.login // empty')"
+  [ -n "${login}" ] || fail "Gitee 令牌校验失败（未读取到 login）"
+  log "Gitee 用户鉴权通过：${login}"
+
+  log "检查 Gitee 仓库可访问性"
+  local repo_json
+  repo_json="$(api_get "${GIT_API_BASE}/repos/${GIT_REPO}?access_token=${GIT_TOKEN}")"
+  local repo_message
+  repo_message="$(printf '%s' "${repo_json}" | jq -r '.message // empty')"
+  if [ -n "${repo_message}" ]; then
+    fail "仓库访问失败：${repo_message}。请检查 GIT_REPO（应为 owner/repo）和 token 权限。"
+  fi
+  local full_name
+  full_name="$(printf '%s' "${repo_json}" | jq -r '.full_name // empty')"
+  [ -n "${full_name}" ] || fail "仓库访问失败，请检查 GIT_REPO 或 token 权限"
+  log "仓库可访问：${full_name}"
+
+  log "检查 Issue API 基础可用性"
+  local issues_json
+  issues_json="$(api_get "${GIT_API_BASE}/repos/${GIT_REPO}/issues?access_token=${GIT_TOKEN}&state=open&page=1&per_page=1")"
+  local issues_message
+  issues_message="$(printf '%s' "${issues_json}" | jq -r 'if type=="object" then .message // empty else empty end')"
+  if [ -n "${issues_message}" ]; then
+    fail "Issue API 调用失败：${issues_message}"
+  fi
+  printf '%s' "${issues_json}" | jq -e 'if type=="array" then true else false end' >/dev/null || fail "Issue API 返回异常"
+  log "Issue API 可用"
+}
+
+check_feishu_config() {
+  if [ "${FEISHU_ENABLED:-true}" = "true" ]; then
+    : "${FEISHU_WEBHOOK_URL:?FEISHU_WEBHOOK_URL 未配置}"
+    log "飞书通知已启用，Webhook 已配置"
+  else
+    log "飞书通知已禁用，跳过"
+  fi
+}
+
+main() {
+  require_cmd curl
+  require_cmd jq
+  require_cmd docker
+  load_env
+  check_docker
+  check_gitee
+  check_feishu_config
+  log "健康检查通过"
+}
+
+main "$@"

package/scripts/install_openclaw.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+CONFIG_FILE="${OPENCLAW_CONFIG_FILE:-${PROJECT_ROOT}/config/openclaw.env}"
+ENV_FILE="${OPENCLAW_DOTENV_FILE:-${PROJECT_ROOT}/.env}"
+
+log() {
+  printf '[install_openclaw] %s\n' "$*"
+}
+
+fail() {
+  printf '[install_openclaw][ERROR] %s\n' "$*" >&2
+  exit 1
+}
+
+ensure_file() {
+  local file="$1"
+  [ -f "${file}" ] || fail "缺少文件：${file}"
+}
+
+ensure_cmd() {
+  local cmd="$1"
+  command -v "${cmd}" >/dev/null 2>&1 || fail "缺少命令：${cmd}"
+}
+
+project_name_for_instance() {
+  local instance_id="$1"
+  printf '%s-%s' "${OPENCLAW_NAME_PREFIX}" "${instance_id}" | tr '[:upper:]' '[:lower:]'
+}
+
+load_env() {
+  set -a
+  # shellcheck source=/dev/null
+  source "${CONFIG_FILE}"
+  if [ -f "${ENV_FILE}" ]; then
+    # shellcheck source=/dev/null
+    source "${ENV_FILE}"
+  fi
+  set +a
+}
+
+check_required_vars() {
+  : "${OPENCLAW_IMAGE:?OPENCLAW_IMAGE 未配置}"
+  : "${OPENCLAW_VERSION:?OPENCLAW_VERSION 未配置}"
+  : "${OPENCLAW_INSTANCE_IDS:?OPENCLAW_INSTANCE_IDS 未配置}"
+  : "${OPENCLAW_BASE_HTTP_PORT:?OPENCLAW_BASE_HTTP_PORT 未配置}"
+  : "${OPENCLAW_CONTAINER_PORT:?OPENCLAW_CONTAINER_PORT 未配置}"
+  if [ -z "${OPENCLAW_HOME_ROOT:-}" ]; then
+    # 向后兼容旧变量名
+    OPENCLAW_HOME_ROOT="${OPENCLAW_DATA_ROOT:-}"
+  fi
+  : "${OPENCLAW_HOME_ROOT:?OPENCLAW_HOME_ROOT 未配置}"
+  OPENCLAW_SHARED_SKILLS_DIR="${OPENCLAW_SHARED_SKILLS_DIR:-${OPENCLAW_HOME_ROOT}/shared/skills}"
+}
+
+split_instances() {
+  local ids="${OPENCLAW_INSTANCE_IDS}"
+  IFS=',' read -r -a INSTANCE_LIST <<<"${ids}"
+}
+
+port_in_use() {
+  local port="$1"
+  lsof -iTCP:"${port}" -sTCP:LISTEN -n -P >/dev/null 2>&1
+}
+
+compose_up_for_instance() {
+  local instance_id="$1"
+  local ordinal="$2"
+  local http_port="$((OPENCLAW_BASE_HTTP_PORT + ordinal))"
+  local instance_home_dir="${OPENCLAW_HOME_ROOT}/${instance_id}"
+  local data_dir="${instance_home_dir}"
+  local logs_dir="${PROJECT_ROOT}/logs/${OPENCLAW_NAME_PREFIX}-${instance_id}"
+
+  if port_in_use "${http_port}"; then
+    fail "HTTP 端口已被占用：${http_port}（实例 ${instance_id}）"
+  fi
+  mkdir -p "${instance_home_dir}" "${OPENCLAW_SHARED_SKILLS_DIR}" "${logs_dir}"
+  log "准备启动实例 ${instance_id}（host_http=${http_port}, container_port=${OPENCLAW_CONTAINER_PORT}）"
+
+  OPENCLAW_INSTANCE_ID="${instance_id}" \
+  OPENCLAW_INSTANCE_ORDINAL="${ordinal}" \
+  OPENCLAW_HTTP_PORT="${http_port}" \
+  OPENCLAW_CONTAINER_PORT="${OPENCLAW_CONTAINER_PORT}" \
+  OPENCLAW_INSTANCE_HOME_DIR="${instance_home_dir}" \
+  OPENCLAW_INSTANCE_DATA_DIR="${data_dir}" \
+  OPENCLAW_INSTANCE_LOG_DIR="${logs_dir}" \
+  docker compose -p "$(project_name_for_instance "${instance_id}")" -f "${PROJECT_ROOT}/docker-compose.yml" up -d --remove-orphans
+}
+
+main() {
+  ensure_file "${CONFIG_FILE}"
+  ensure_file "${PROJECT_ROOT}/docker-compose.yml"
+  ensure_cmd docker
+
+  if ! docker info >/dev/null 2>&1; then
+    fail "Docker daemon 未就绪，请先启动 Docker Desktop。"
+  fi
+
+  load_env
+  check_required_vars
+  split_instances
+  "${PROJECT_ROOT}/scripts/skills_sync.sh"
+
+  local i=0
+  for id in "${INSTANCE_LIST[@]}"; do
+    compose_up_for_instance "${id}" "${i}"
+    i=$((i + 1))
+  done
+
+  if ! "${PROJECT_ROOT}/scripts/bootstrap_models.sh"; then
+    log "模型引导未完全成功，可稍后手动执行：npm run bootstrap-models"
+  fi
+
+  log "全部实例启动完成"
+}
+
+main "$@"

package/scripts/openclaw_ctl.sh

@@ -0,0 +1,323 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+DEFAULT_CONFIG_FILE="${PROJECT_ROOT}/config/openclaw.env"
+DEFAULT_DOTENV_FILE="${PROJECT_ROOT}/.env"
+
+OPENCLAW_CONFIG_FILE="${OPENCLAW_CONFIG_FILE:-${DEFAULT_CONFIG_FILE}}"
+OPENCLAW_DOTENV_FILE="${OPENCLAW_DOTENV_FILE:-${DEFAULT_DOTENV_FILE}}"
+
+usage() {
+  cat <<'EOF'
+OpenClaw Manager CLI（多实例运维入口）
+
+用法:
+  ./scripts/openclaw_ctl.sh [--config <path>] [--env-file <path>] <command> [args]
+
+全局参数:
+  -h, --help             显示帮助
+  --config <path>        指定 openclaw 运行配置文件（默认 ./config/openclaw.env）
+  --env-file <path>      指定敏感变量文件（默认 ./.env）
+
+命令:
+  setup
+  install
+  start | stop | restart | status
+  logs [service]
+  list-claw
+  tui
+  chat-claw <name>
+  start-claw <name> | stop-claw <name> | status-claw <name> | logs-claw <name>
+  check-env
+  sync-skills
+  sync-model-configs
+  apply-config
+  bootstrap-models
+  set-qwen
+  health-check
+  self-test
+
+示例:
+  ./scripts/openclaw_ctl.sh --config ./config/openclaw.dev.env status
+  ./scripts/openclaw_ctl.sh --env-file ./.env.prod start-claw master
+EOF
+}
+
+project_name_for_instance() {
+  local instance_id="$1"
+  printf '%s-%s' "${OPENCLAW_NAME_PREFIX}" "${instance_id}" | tr '[:upper:]' '[:lower:]'
+}
+
+run_install() {
+  "${PROJECT_ROOT}/scripts/install_openclaw.sh"
+}
+
+load_config() {
+  local config_file="${OPENCLAW_CONFIG_FILE}"
+  if [ ! -f "${config_file}" ]; then
+    echo "缺少 ${config_file}" >&2
+    exit 1
+  fi
+  set -a
+  # shellcheck source=/dev/null
+  source "${config_file}"
+  set +a
+
+  if [ -z "${OPENCLAW_HOME_ROOT:-}" ]; then
+    OPENCLAW_HOME_ROOT="${OPENCLAW_DATA_ROOT:-}"
+  fi
+  : "${OPENCLAW_HOME_ROOT:?OPENCLAW_HOME_ROOT 未配置}"
+  OPENCLAW_SHARED_SKILLS_DIR="${OPENCLAW_SHARED_SKILLS_DIR:-${OPENCLAW_HOME_ROOT}/shared/skills}"
+}
+
+ensure_instance_exists() {
+  local target="$1"
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  for id in "${instance_list[@]}"; do
+    if [ "${id}" = "${target}" ]; then
+      return 0
+    fi
+  done
+  echo "未找到 claw 实例：${target}" >&2
+  exit 1
+}
+
+list_claws() {
+  load_config
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  for id in "${instance_list[@]}"; do
+    printf '%s\n' "${id}"
+  done
+}
+
+run_compose_for_instance() {
+  local target="$1"
+  shift
+  load_config
+  ensure_instance_exists "${target}"
+
+  local ordinal=0
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  for id in "${instance_list[@]}"; do
+    if [ "${id}" = "${target}" ]; then
+      OPENCLAW_INSTANCE_ID="${id}" \
+      OPENCLAW_INSTANCE_ORDINAL="${ordinal}" \
+      OPENCLAW_HTTP_PORT="$((OPENCLAW_BASE_HTTP_PORT + ordinal))" \
+      OPENCLAW_CONTAINER_PORT="${OPENCLAW_CONTAINER_PORT:-18789}" \
+      OPENCLAW_INSTANCE_HOME_DIR="${OPENCLAW_HOME_ROOT}/${id}" \
+      OPENCLAW_SHARED_SKILLS_DIR="${OPENCLAW_SHARED_SKILLS_DIR:-${OPENCLAW_HOME_ROOT}/shared/skills}" \
+      OPENCLAW_INSTANCE_DATA_DIR="${OPENCLAW_HOME_ROOT}/${id}" \
+      OPENCLAW_INSTANCE_LOG_DIR="${PROJECT_ROOT}/logs/${OPENCLAW_NAME_PREFIX}-${id}" \
+      docker compose -p "$(project_name_for_instance "${id}")" -f "${PROJECT_ROOT}/docker-compose.yml" "$@"
+      return 0
+    fi
+    ordinal=$((ordinal + 1))
+  done
+}
+
+chat_with_claw() {
+  local claw_name="$1"
+  local running_service
+  running_service="$(run_compose_for_instance "${claw_name}" ps --status running --services 2>/dev/null | awk 'NF{print $1; exit}')"
+  if [ "${running_service}" != "openclaw" ]; then
+    echo "实例 ${claw_name} 当前未运行，请先执行: npm run start-claw -- ${claw_name}" >&2
+    exit 1
+  fi
+
+  local max_wait=30
+  local waited=0
+  until run_compose_for_instance "${claw_name}" exec -T openclaw sh -lc 'openclaw health >/dev/null 2>&1'; do
+    waited=$((waited + 2))
+    if [ "${waited}" -ge "${max_wait}" ]; then
+      echo "实例 ${claw_name} 网关尚未就绪（等待 ${max_wait}s 超时）。可先执行: npm run apply-config" >&2
+      exit 1
+    fi
+    sleep 2
+  done
+
+  run_compose_for_instance "${claw_name}" exec openclaw sh -lc '
+    SESSION_KEY="chat-'${claw_name}'"
+    if command -v openclaw >/dev/null 2>&1; then
+      exec openclaw tui --session "${SESSION_KEY}"
+    elif command -v claw >/dev/null 2>&1; then
+      exec claw tui --session "${SESSION_KEY}"
+    else
+      echo "容器内未找到 openclaw/claw 命令，无法进入对话 TUI。"
+      exit 127
+    fi
+  '
+}
+
+compose_cmd_all_instances() {
+  load_config
+
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  local i=0
+  for id in "${instance_list[@]}"; do
+    OPENCLAW_INSTANCE_ID="${id}" \
+    OPENCLAW_INSTANCE_ORDINAL="${i}" \
+    OPENCLAW_HTTP_PORT="$((OPENCLAW_BASE_HTTP_PORT + i))" \
+    OPENCLAW_CONTAINER_PORT="${OPENCLAW_CONTAINER_PORT:-18789}" \
+    OPENCLAW_INSTANCE_HOME_DIR="${OPENCLAW_HOME_ROOT}/${id}" \
+    OPENCLAW_SHARED_SKILLS_DIR="${OPENCLAW_SHARED_SKILLS_DIR:-${OPENCLAW_HOME_ROOT}/shared/skills}" \
+    OPENCLAW_INSTANCE_DATA_DIR="${OPENCLAW_HOME_ROOT}/${id}" \
+    OPENCLAW_INSTANCE_LOG_DIR="${PROJECT_ROOT}/logs/${OPENCLAW_NAME_PREFIX}-${id}" \
+    docker compose -p "$(project_name_for_instance "${id}")" -f "${PROJECT_ROOT}/docker-compose.yml" "$@"
+    i=$((i + 1))
+  done
+}
+
+run_self_test() {
+  echo "[self-test] 检查脚本可执行权限"
+  test -x "${PROJECT_ROOT}/scripts/setup_env.sh"
+  test -x "${PROJECT_ROOT}/scripts/install_openclaw.sh"
+  test -x "${PROJECT_ROOT}/scripts/openclaw_ctl.sh"
+  test -x "${PROJECT_ROOT}/scripts/check_env.sh"
+  test -x "${PROJECT_ROOT}/scripts/health_check.sh"
+  test -x "${PROJECT_ROOT}/scripts/skills_sync.sh"
+  test -x "${PROJECT_ROOT}/scripts/sync_model_configs.sh"
+  test -x "${PROJECT_ROOT}/scripts/bootstrap_models.sh"
+  test -x "${PROJECT_ROOT}/scripts/apply_config.sh"
+  test -x "${PROJECT_ROOT}/scripts/set_qwen_vendor_model.sh"
+  echo "[self-test] 检查关键文件存在"
+  test -f "${PROJECT_ROOT}/docker-compose.yml"
+  test -f "${PROJECT_ROOT}/config/openclaw.env.example"
+  test -f "${PROJECT_ROOT}/config/clawhub-skills.txt"
+  test -f "${PROJECT_ROOT}/.env.example"
+  echo "[self-test] 检查 Git 仓库状态（里程碑提交前置）"
+  if ! git -C "${PROJECT_ROOT}" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    echo "[self-test][WARN] 当前目录不是 Git 仓库。里程碑提交会被阻塞，请先执行 git init。"
+  fi
+  echo "[self-test] 基础检查通过"
+}
+
+POSITIONAL_ARGS=()
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    -h|--help|help)
+      usage
+      exit 0
+      ;;
+    --config)
+      [ -n "${2:-}" ] || { echo "缺少 --config 的参数路径" >&2; exit 1; }
+      OPENCLAW_CONFIG_FILE="$2"
+      shift 2
+      ;;
+    --env-file)
+      [ -n "${2:-}" ] || { echo "缺少 --env-file 的参数路径" >&2; exit 1; }
+      OPENCLAW_DOTENV_FILE="$2"
+      shift 2
+      ;;
+    --)
+      shift
+      while [ "$#" -gt 0 ]; do
+        POSITIONAL_ARGS+=("$1")
+        shift
+      done
+      ;;
+    -*)
+      echo "未知参数: $1" >&2
+      usage
+      exit 1
+      ;;
+    *)
+      POSITIONAL_ARGS+=("$1")
+      shift
+      ;;
+  esac
+done
+
+export OPENCLAW_CONFIG_FILE
+export OPENCLAW_DOTENV_FILE
+
+set -- "${POSITIONAL_ARGS[@]}"
+command="${1:-}"
+case "${command}" in
+  setup)
+    "${PROJECT_ROOT}/scripts/setup_env.sh"
+    ;;
+  install)
+    run_install
+    ;;
+  start)
+    compose_cmd_all_instances up -d
+    ;;
+  stop)
+    compose_cmd_all_instances down
+    ;;
+  restart)
+    compose_cmd_all_instances restart
+    ;;
+  status)
+    compose_cmd_all_instances ps
+    ;;
+  logs)
+    service="${2:-}"
+    if [ -n "${service}" ]; then
+      compose_cmd_all_instances logs -f "${service}"
+    else
+      compose_cmd_all_instances logs --tail=200
+    fi
+    ;;
+  list-claw)
+    list_claws
+    ;;
+  tui)
+    node "${PROJECT_ROOT}/src/tui/index.js"
+    ;;
+  chat-claw)
+    claw_name="${2:-}"
+    [ -n "${claw_name}" ] || { echo "用法: ./scripts/openclaw_ctl.sh chat-claw <name>" >&2; exit 1; }
+    chat_with_claw "${claw_name}"
+    ;;
+  status-claw)
+    claw_name="${2:-}"
+    [ -n "${claw_name}" ] || { echo "用法: status-claw <name>" >&2; exit 1; }
+    run_compose_for_instance "${claw_name}" ps
+    ;;
+  start-claw)
+    claw_name="${2:-}"
+    [ -n "${claw_name}" ] || { echo "用法: start-claw <name>" >&2; exit 1; }
+    run_compose_for_instance "${claw_name}" up -d
+    ;;
+  stop-claw)
+    claw_name="${2:-}"
+    [ -n "${claw_name}" ] || { echo "用法: stop-claw <name>" >&2; exit 1; }
+    run_compose_for_instance "${claw_name}" down
+    ;;
+  logs-claw)
+    claw_name="${2:-}"
+    [ -n "${claw_name}" ] || { echo "用法: logs-claw <name>" >&2; exit 1; }
+    run_compose_for_instance "${claw_name}" logs --tail=200
+    ;;
+  self-test)
+    run_self_test
+    ;;
+  check-env)
+    "${PROJECT_ROOT}/scripts/check_env.sh"
+    ;;
+  sync-skills)
+    "${PROJECT_ROOT}/scripts/skills_sync.sh"
+    ;;
+  sync-model-configs)
+    "${PROJECT_ROOT}/scripts/sync_model_configs.sh"
+    ;;
+  apply-config)
+    "${PROJECT_ROOT}/scripts/apply_config.sh"
+    ;;
+  bootstrap-models)
+    "${PROJECT_ROOT}/scripts/bootstrap_models.sh"
+    ;;
+  set-qwen)
+    "${PROJECT_ROOT}/scripts/set_qwen_vendor_model.sh"
+    ;;
+  health-check)
+    "${PROJECT_ROOT}/scripts/health_check.sh"
+    ;;
+  *)
+    usage
+    exit 1
+    ;;
+esac