@yyy9527/openclaw-manager 0.1.0

package/scripts/set_qwen_vendor_model.sh

@@ -0,0 +1,142 @@
+#!/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 '[set-qwen] %s\n' "$*"
+}
+
+fail() {
+  printf '[set-qwen][ERROR] %s\n' "$*" >&2
+  exit 1
+}
+
+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
+}
+
+escape_env_value() {
+  local raw="$1"
+  raw="${raw//\\/\\\\}"
+  raw="${raw//\"/\\\"}"
+  printf '"%s"' "${raw}"
+}
+
+upsert_env_key() {
+  local file="$1"
+  local key="$2"
+  local value="$3"
+  local escaped
+  local tmp_file
+  escaped="$(escape_env_value "${value}")"
+  tmp_file="$(mktemp)"
+
+  if [ -f "${file}" ]; then
+    awk -v key="${key}" -v val="${escaped}" '
+      BEGIN { updated = 0 }
+      $0 ~ "^[[:space:]]*" key "=" && updated == 0 {
+        print key "=" val
+        updated = 1
+        next
+      }
+      { print }
+      END {
+        if (updated == 0) {
+          print key "=" val
+        }
+      }
+    ' "${file}" > "${tmp_file}"
+  else
+    {
+      printf '# 由 set-model:qwen 生成；可按实例补充自定义键\n'
+      printf '%s=%s\n' "${key}" "${escaped}"
+    } > "${tmp_file}"
+  fi
+  mv "${tmp_file}" "${file}"
+}
+
+resolve_template_file() {
+  local id="$1"
+  local template_dir="${PROJECT_ROOT}/config/model-env-templates"
+  local candidate_env="${template_dir}/${id}.env"
+  local candidate_example="${template_dir}/${id}.env.example"
+  if [ -f "${candidate_env}" ]; then
+    printf '%s\n' "${candidate_env}"
+    return 0
+  fi
+  if [ -f "${candidate_example}" ]; then
+    printf '%s\n' "${candidate_example}"
+    return 0
+  fi
+  return 1
+}
+
+write_instance_model_env() {
+  local id="$1"
+  local home_dir="${OPENCLAW_HOME_ROOT}/${id}"
+  local model_env="${home_dir}/model.env"
+  local template_file
+
+  MODEL_PROVIDER_ID="openai"
+  MODEL_PRIMARY="openai/${QWEN_MODEL:-qwen-max}"
+  MODEL_BASE_URL="${QWEN_BASE_URL:-https://dashscope.aliyuncs.com/compatible-mode/v1}"
+  MODEL_API_KEY_ENV="${QWEN_API_KEY_ENV:-DASHSCOPE_API_KEY}"
+  MODEL_API="openai-completions"
+  MODEL_ID="${QWEN_MODEL:-qwen-max}"
+  MODEL_NAME="Qwen Vendor"
+  MODEL_CONTEXT_WINDOW=131072
+  MODEL_MAX_TOKENS=8192
+
+  if template_file="$(resolve_template_file "${id}")"; then
+    # shellcheck source=/dev/null
+    source "${template_file}"
+    log "实例 ${id} 使用模板：${template_file}"
+  fi
+
+  mkdir -p "${home_dir}"
+  if [ ! -f "${model_env}" ]; then
+    printf '# 由 set-model:qwen 生成；可按实例补充自定义键\n' > "${model_env}"
+  fi
+
+  # 仅更新受控键，避免覆盖用户自定义键。
+  upsert_env_key "${model_env}" "MODEL_PROVIDER_ID" "${MODEL_PROVIDER_ID}"
+  upsert_env_key "${model_env}" "MODEL_PRIMARY" "${MODEL_PRIMARY}"
+  upsert_env_key "${model_env}" "MODEL_BASE_URL" "${MODEL_BASE_URL}"
+  upsert_env_key "${model_env}" "MODEL_API_KEY_ENV" "${MODEL_API_KEY_ENV}"
+  upsert_env_key "${model_env}" "MODEL_API" "${MODEL_API}"
+  upsert_env_key "${model_env}" "MODEL_ID" "${MODEL_ID}"
+  upsert_env_key "${model_env}" "MODEL_NAME" "${MODEL_NAME}"
+  upsert_env_key "${model_env}" "MODEL_CONTEXT_WINDOW" "${MODEL_CONTEXT_WINDOW}"
+  upsert_env_key "${model_env}" "MODEL_MAX_TOKENS" "${MODEL_MAX_TOKENS}"
+  log "实例 ${id} 模型配置已安全更新：${model_env}"
+}
+
+main() {
+  load_env
+  [ -n "${OPENCLAW_INSTANCE_IDS:-}" ] || fail "OPENCLAW_INSTANCE_IDS 未配置"
+  if [ -z "${OPENCLAW_HOME_ROOT:-}" ]; then
+    OPENCLAW_HOME_ROOT="${OPENCLAW_DATA_ROOT:-${HOME}/openclaws}"
+  fi
+  [ -n "${QWEN_API_KEY:-${DASHSCOPE_API_KEY:-}}" ] || fail "缺少 QWEN_API_KEY 或 DASHSCOPE_API_KEY"
+
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  for id in "${instance_list[@]}"; do
+    write_instance_model_env "${id}"
+  done
+
+  bash "${PROJECT_ROOT}/scripts/sync_model_configs.sh"
+  log "Qwen 厂商模型配置已写入各实例家目录。执行 npm run apply-config 使其生效。"
+}
+
+main "$@"

package/scripts/setup_env.sh

@@ -0,0 +1,156 @@
+#!/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 '[setup_env] %s\n' "$*"
+}
+
+warn() {
+  printf '[setup_env][WARN] %s\n' "$*" >&2
+}
+
+require_cmd() {
+  local cmd="$1"
+  local install_hint="$2"
+  if command -v "${cmd}" >/dev/null 2>&1; then
+    log "已检测到 ${cmd}"
+  else
+    warn "未检测到 ${cmd}。建议执行：${install_hint}"
+    return 1
+  fi
+}
+
+install_with_brew_if_missing() {
+  local formula="$1"
+  local check_cmd="$2"
+  if command -v "${check_cmd}" >/dev/null 2>&1; then
+    log "${formula} 已存在，跳过安装"
+    return 0
+  fi
+  log "通过 Homebrew 安装 ${formula}"
+  brew install "${formula}"
+}
+
+install_pnpm_if_missing() {
+  if command -v pnpm >/dev/null 2>&1; then
+    log "pnpm 已存在，跳过安装"
+    return 0
+  fi
+  log "通过 npm 安装 pnpm"
+  npm install -g pnpm
+}
+
+ensure_pnpm_home() {
+  export PNPM_HOME="${PNPM_HOME:-${HOME}/Library/pnpm}"
+  mkdir -p "${PNPM_HOME}"
+  case ":${PATH}:" in
+    *":${PNPM_HOME}:"*) ;;
+    *) export PATH="${PNPM_HOME}:${PATH}" ;;
+  esac
+}
+
+install_clawhub_with_pnpm_if_missing() {
+  if command -v clawhub >/dev/null 2>&1; then
+    log "clawhub 已存在，跳过安装"
+    return 0
+  fi
+  log "通过 pnpm 全局安装 clawhub（失败将自动重试）"
+  local max_retries=3
+  local attempt=1
+  while [ "${attempt}" -le "${max_retries}" ]; do
+    if pnpm add -g clawhub; then
+      return 0
+    fi
+    warn "pnpm 安装 clawhub 第 ${attempt}/${max_retries} 次失败，准备重试。"
+    sleep 2
+    attempt=$((attempt + 1))
+  done
+  warn "pnpm 安装 clawhub 多次失败，请手动执行：pnpm add -g clawhub"
+}
+
+install_cask_with_brew_if_missing() {
+  local cask="$1"
+  local app_check="$2"
+  if [ -e "${app_check}" ]; then
+    log "${cask} 已存在，跳过安装"
+    return 0
+  fi
+  log "通过 Homebrew Cask 安装 ${cask}"
+  brew install --cask "${cask}"
+}
+
+copy_template_if_missing() {
+  local src="$1"
+  local dst="$2"
+  if [ -f "${dst}" ]; then
+    log "${dst} 已存在，跳过"
+    return 0
+  fi
+  mkdir -p "$(dirname "${dst}")"
+  cp "${src}" "${dst}"
+  log "已创建 ${dst}"
+}
+
+main() {
+  log "开始初始化 macOS 环境（幂等执行）"
+
+  if [[ "$(uname -s)" != "Darwin" ]]; then
+    warn "当前系统不是 macOS，脚本可能不适用。"
+  fi
+
+  if ! command -v brew >/dev/null 2>&1; then
+    warn "未检测到 Homebrew，请先安装："
+    warn "/bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+    exit 1
+  fi
+
+  install_with_brew_if_missing "node" "node"
+  install_with_brew_if_missing "jq" "jq"
+  install_with_brew_if_missing "yq" "yq"
+  install_with_brew_if_missing "gh" "gh"
+  install_cask_with_brew_if_missing "docker" "/Applications/Docker.app"
+  install_with_brew_if_missing "ollama" "ollama"
+
+  install_pnpm_if_missing
+  ensure_pnpm_home
+  install_clawhub_with_pnpm_if_missing
+
+  require_cmd "node" "brew install node"
+  require_cmd "npm" "brew install node"
+  require_cmd "pnpm" "npm install -g pnpm"
+  require_cmd "docker" "brew install --cask docker"
+  require_cmd "ollama" "brew install ollama"
+
+  if ! docker info >/dev/null 2>&1; then
+    warn "Docker Desktop 似乎未启动，请手动启动后重试脚本。"
+    exit 1
+  fi
+  log "Docker daemon 状态正常"
+
+  copy_template_if_missing "${PROJECT_ROOT}/config/openclaw.env.example" "${CONFIG_FILE}"
+  copy_template_if_missing "${PROJECT_ROOT}/.env.example" "${ENV_FILE}"
+
+  set -a
+  # shellcheck source=/dev/null
+  source "${CONFIG_FILE}"
+  set +a
+
+  if [ -z "${OPENCLAW_HOME_ROOT:-}" ]; then
+    OPENCLAW_HOME_ROOT="${OPENCLAW_DATA_ROOT:-${HOME}/openclaws}"
+  fi
+
+  mkdir -p "${OPENCLAW_HOME_ROOT}" "${PROJECT_ROOT}/logs"
+  log "已确保实例家目录根路径存在：${OPENCLAW_HOME_ROOT}"
+  log "已确保 logs 目录存在"
+
+  "${PROJECT_ROOT}/scripts/skills_sync.sh"
+
+  log "环境初始化完成"
+}
+
+main "$@"

package/scripts/skills_sync.sh

@@ -0,0 +1,154 @@
+#!/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}"
+
+log() {
+  printf '[skills-sync] %s\n' "$*"
+}
+
+warn() {
+  printf '[skills-sync][WARN] %s\n' "$*" >&2
+}
+
+load_env() {
+  [ -f "${CONFIG_FILE}" ] || {
+    warn "缺少配置文件：${CONFIG_FILE}"
+    exit 1
+  }
+  set -a
+  # shellcheck source=/dev/null
+  source "${CONFIG_FILE}"
+  set +a
+}
+
+install_slug_with_retry() {
+  local slug="$1"
+  local max_retries="${OPENCLAW_CLAWHUB_INSTALL_RETRIES:-4}"
+  local attempt=1
+  while [ "${attempt}" -le "${max_retries}" ]; do
+    local output
+    output="$(clawhub --no-input --workdir "${OPENCLAW_HOME_ROOT}/shared" --dir skills install "${slug}" 2>&1 || true)"
+    if printf '%s' "${output}" | awk '/Installed|Up to date/{found=1} END{exit found?0:1}'; then
+      return 0
+    fi
+    if printf '%s' "${output}" | awk '/Rate limit exceeded|Too many requests/{found=1} END{exit found?0:1}'; then
+      warn "clawhub install ${slug} 命中限流，第 ${attempt}/${max_retries} 次，退避后重试。"
+      sleep $((attempt * 5))
+    else
+      warn "clawhub install ${slug} 第 ${attempt}/${max_retries} 次失败：$(printf '%s' "${output}" | tr '\n' ' ' | cut -c1-140)"
+      sleep 2
+    fi
+    attempt=$((attempt + 1))
+  done
+  return 1
+}
+
+resolve_best_slug() {
+  local query="$1"
+  local result
+  result="$(clawhub --no-input search "${query}" 2>/dev/null || true)"
+  printf '%s\n' "${result}" | awk 'NR>1 && $1 !~ /^-/ {print $1; exit}'
+}
+
+search_slugs() {
+  local query="$1"
+  local result
+  result="$(clawhub --no-input search "${query}" 2>/dev/null || true)"
+  printf '%s\n' "${result}" | awk 'NR>1 && $1 !~ /^-/ {print $1}'
+}
+
+ensure_dirs() {
+  if [ -z "${OPENCLAW_HOME_ROOT:-}" ]; then
+    OPENCLAW_HOME_ROOT="${OPENCLAW_DATA_ROOT:-${HOME}/openclaws}"
+  fi
+  OPENCLAW_SHARED_SKILLS_DIR="${OPENCLAW_SHARED_SKILLS_DIR:-${OPENCLAW_HOME_ROOT}/shared/skills}"
+
+  mkdir -p "${OPENCLAW_SHARED_SKILLS_DIR}"
+  log "共享技能目录：${OPENCLAW_SHARED_SKILLS_DIR}"
+
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  for id in "${instance_list[@]}"; do
+    local_home="${OPENCLAW_HOME_ROOT}/${id}"
+    local_skills="${local_home}/skills"
+    mkdir -p "${local_skills}"
+    printf "instance=%s\n" "${id}" > "${local_home}/.openclaw-home"
+    log "实例技能目录：${local_skills}"
+  done
+}
+
+install_from_clawhub() {
+  local skills_file="${PROJECT_ROOT}/config/clawhub-skills.txt"
+  local enabled="${OPENCLAW_ENABLE_CLAWHUB_SKILLS:-true}"
+  if [ "${enabled}" != "true" ]; then
+    log "已禁用 clawhub 自动安装，跳过"
+    return 0
+  fi
+
+  if ! command -v clawhub >/dev/null 2>&1; then
+    warn "未检测到 clawhub 命令，跳过技能自动安装。"
+    return 0
+  fi
+
+  if ! clawhub whoami >/dev/null 2>&1; then
+    warn "clawhub 未登录，可能触发限流导致安装失败。建议先执行：npm run clawhub:login"
+  fi
+
+  if [ ! -f "${skills_file}" ]; then
+    warn "未找到 ${skills_file}，跳过技能自动安装。"
+    return 0
+  fi
+
+  log "优先安装 find-skills 技能用于检索能力扩展"
+  if install_slug_with_retry "find-skills"; then
+    log "find-skills 安装成功"
+  else
+    warn "find-skills 安装失败，后续继续搜索但不自动安装不确定技能。"
+  fi
+
+  while IFS= read -r skill || [ -n "${skill}" ]; do
+    skill="$(printf '%s' "${skill}" | xargs)"
+    [ -z "${skill}" ] && continue
+    [[ "${skill}" =~ ^# ]] && continue
+
+    log "通过 find-skills 流程检索：${skill}"
+    local normalized
+    normalized="$(printf '%s' "${skill}" | tr ' ' '-')"
+    local slugs
+    slugs="$(search_slugs "${skill}")"
+    if [ -z "${slugs}" ]; then
+      warn "未搜索到可用技能：${skill}"
+      continue
+    fi
+
+    local matched=""
+    while IFS= read -r slug; do
+      if [ "${slug}" = "${normalized}" ] || [ "${slug}" = "${skill}" ]; then
+        matched="${slug}"
+        break
+      fi
+    done <<< "${slugs}"
+
+    if [ -n "${matched}" ]; then
+      log "命中精确 slug，开始安装：${matched}"
+      if ! install_slug_with_retry "${matched}"; then
+        warn "技能 ${matched} 安装失败，请稍后重试。"
+      fi
+      continue
+    fi
+
+    warn "未找到精确匹配 slug（${normalized}），为避免误装已跳过自动安装。"
+    warn "建议候选（前3）：$(printf '%s\n' "${slugs}" | head -n 3 | tr '\n' ' ')"
+  done < "${skills_file}"
+}
+
+main() {
+  load_env
+  ensure_dirs
+  install_from_clawhub
+  log "技能目录同步完成"
+}
+
+main "$@"

package/scripts/sync_model_configs.sh

@@ -0,0 +1,217 @@
+#!/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 '[sync-model] %s\n' "$*"
+}
+
+warn() {
+  printf '[sync-model][WARN] %s\n' "$*" >&2
+}
+
+load_env() {
+  [ -f "${CONFIG_FILE}" ] || {
+    warn "缺少配置文件：${CONFIG_FILE}"
+    exit 1
+  }
+  set -a
+  # shellcheck source=/dev/null
+  source "${CONFIG_FILE}"
+  if [ -f "${ENV_FILE}" ]; then
+    # shellcheck source=/dev/null
+    source "${ENV_FILE}"
+  fi
+  set +a
+}
+
+escape_env_value() {
+  local raw="$1"
+  raw="${raw//\\/\\\\}"
+  raw="${raw//\"/\\\"}"
+  printf '"%s"' "${raw}"
+}
+
+upsert_env_key() {
+  local file="$1"
+  local key="$2"
+  local value="$3"
+  local escaped
+  local tmp_file
+  escaped="$(escape_env_value "${value}")"
+  tmp_file="$(mktemp)"
+
+  if [ -f "${file}" ]; then
+    awk -v key="${key}" -v val="${escaped}" '
+      BEGIN { updated = 0 }
+      $0 ~ "^[[:space:]]*" key "=" && updated == 0 {
+        print key "=" val
+        updated = 1
+        next
+      }
+      { print }
+      END {
+        if (updated == 0) {
+          print key "=" val
+        }
+      }
+    ' "${file}" > "${tmp_file}"
+  else
+    {
+      printf '# 每个实例独立模型配置（修改后执行 npm run apply-config 生效）\n'
+      printf '%s=%s\n' "${key}" "${escaped}"
+    } > "${tmp_file}"
+  fi
+  mv "${tmp_file}" "${file}"
+}
+
+resolve_template_file() {
+  local id="$1"
+  local template_dir="${PROJECT_ROOT}/config/model-env-templates"
+  local candidate_env="${template_dir}/${id}.env"
+  local candidate_example="${template_dir}/${id}.env.example"
+  if [ -f "${candidate_env}" ]; then
+    printf '%s\n' "${candidate_env}"
+    return 0
+  fi
+  if [ -f "${candidate_example}" ]; then
+    printf '%s\n' "${candidate_example}"
+    return 0
+  fi
+  return 1
+}
+
+ensure_default_model_env() {
+  local instance_id="$1"
+  local home_dir="${OPENCLAW_HOME_ROOT}/${instance_id}"
+  local model_env="${home_dir}/model.env"
+  local template_file
+
+  mkdir -p "${home_dir}"
+  if [ -f "${model_env}" ]; then
+    return 0
+  fi
+  printf '# 每个实例独立模型配置（修改后执行 npm run apply-config 生效）\n' > "${model_env}"
+
+  MODEL_PROVIDER_ID="openai"
+  MODEL_PRIMARY="openai/${QWEN_MODEL:-qwen-max}"
+  MODEL_BASE_URL="${QWEN_BASE_URL:-https://dashscope.aliyuncs.com/compatible-mode/v1}"
+  MODEL_API_KEY_ENV="${QWEN_API_KEY_ENV:-DASHSCOPE_API_KEY}"
+  MODEL_API="openai-completions"
+  MODEL_ID="${QWEN_MODEL:-qwen-max}"
+  MODEL_NAME="Qwen Vendor"
+  MODEL_CONTEXT_WINDOW=131072
+  MODEL_MAX_TOKENS=8192
+
+  if template_file="$(resolve_template_file "${instance_id}")"; then
+    # shellcheck source=/dev/null
+    source "${template_file}"
+    log "实例 ${instance_id} 使用模板：${template_file}"
+  fi
+
+  # 仅补齐受控键，避免覆盖用户追加的自定义配置。
+  upsert_env_key "${model_env}" "MODEL_PROVIDER_ID" "${MODEL_PROVIDER_ID}"
+  upsert_env_key "${model_env}" "MODEL_PRIMARY" "${MODEL_PRIMARY}"
+  upsert_env_key "${model_env}" "MODEL_BASE_URL" "${MODEL_BASE_URL}"
+  upsert_env_key "${model_env}" "MODEL_API_KEY_ENV" "${MODEL_API_KEY_ENV}"
+  upsert_env_key "${model_env}" "MODEL_API" "${MODEL_API}"
+  upsert_env_key "${model_env}" "MODEL_ID" "${MODEL_ID}"
+  upsert_env_key "${model_env}" "MODEL_NAME" "${MODEL_NAME}"
+  upsert_env_key "${model_env}" "MODEL_CONTEXT_WINDOW" "${MODEL_CONTEXT_WINDOW}"
+  upsert_env_key "${model_env}" "MODEL_MAX_TOKENS" "${MODEL_MAX_TOKENS}"
+  log "已生成默认模型配置：${model_env}"
+}
+
+sync_instance_model() {
+  local instance_id="$1"
+  local home_dir="${OPENCLAW_HOME_ROOT}/${instance_id}"
+  local model_env="${home_dir}/model.env"
+  local openclaw_json="${home_dir}/openclaw.json"
+  local resolved_api_key=""
+
+  ensure_default_model_env "${instance_id}"
+
+  set -a
+  # shellcheck source=/dev/null
+  source "${model_env}"
+  set +a
+
+  : "${MODEL_PROVIDER_ID:?MODEL_PROVIDER_ID 未配置}"
+  : "${MODEL_PRIMARY:?MODEL_PRIMARY 未配置}"
+  : "${MODEL_BASE_URL:?MODEL_BASE_URL 未配置}"
+  : "${MODEL_API_KEY_ENV:?MODEL_API_KEY_ENV 未配置}"
+  : "${MODEL_API:?MODEL_API 未配置}"
+  : "${MODEL_ID:?MODEL_ID 未配置}"
+  : "${MODEL_NAME:?MODEL_NAME 未配置}"
+  : "${MODEL_CONTEXT_WINDOW:?MODEL_CONTEXT_WINDOW 未配置}"
+  : "${MODEL_MAX_TOKENS:?MODEL_MAX_TOKENS 未配置}"
+
+  # MODEL_API_KEY_ENV 兼容两种写法：
+  # 1) 环境变量名（推荐），例如 DASHSCOPE_API_KEY
+  # 2) 直接填写 API Key（不推荐，但兼容历史配置）
+  if [ -n "${!MODEL_API_KEY_ENV:-}" ]; then
+    resolved_api_key="${!MODEL_API_KEY_ENV}"
+  else
+    resolved_api_key="${MODEL_API_KEY_ENV}"
+  fi
+
+  if [ -z "${resolved_api_key}" ]; then
+    warn "实例 ${instance_id} 未解析到可用 API Key（MODEL_API_KEY_ENV=${MODEL_API_KEY_ENV}）"
+    exit 1
+  fi
+
+  [ -f "${openclaw_json}" ] || printf '{}\n' > "${openclaw_json}"
+  local tmp_file
+  tmp_file="$(mktemp)"
+
+  jq \
+    --arg provider_id "${MODEL_PROVIDER_ID}" \
+    --arg primary "${MODEL_PRIMARY}" \
+    --arg base_url "${MODEL_BASE_URL}" \
+    --arg api_key "${resolved_api_key}" \
+    --arg api_type "${MODEL_API}" \
+    --arg model_id "${MODEL_ID}" \
+    --arg model_name "${MODEL_NAME}" \
+    --argjson context_window "${MODEL_CONTEXT_WINDOW}" \
+    --argjson max_tokens "${MODEL_MAX_TOKENS}" \
+    '
+    .agents.defaults.model.primary = $primary
+    | .models.providers[$provider_id].baseUrl = $base_url
+    | .models.providers[$provider_id].apiKey = $api_key
+    | .models.providers[$provider_id].api = $api_type
+    | .models.providers[$provider_id].models = [
+        {
+          id: $model_id,
+          name: $model_name,
+          reasoning: false,
+          input: ["text"],
+          cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+          contextWindow: $context_window,
+          maxTokens: $max_tokens
+        }
+      ]
+    ' "${openclaw_json}" > "${tmp_file}"
+
+  mv "${tmp_file}" "${openclaw_json}"
+  log "实例 ${instance_id} 模型配置已同步到家目录"
+}
+
+main() {
+  load_env
+  if [ -z "${OPENCLAW_HOME_ROOT:-}" ]; then
+    OPENCLAW_HOME_ROOT="${OPENCLAW_DATA_ROOT:-${HOME}/openclaws}"
+  fi
+  : "${OPENCLAW_INSTANCE_IDS:?OPENCLAW_INSTANCE_IDS 未配置}"
+
+  IFS=',' read -r -a instance_list <<<"${OPENCLAW_INSTANCE_IDS}"
+  for id in "${instance_list[@]}"; do
+    sync_instance_model "${id}"
+  done
+  log "全部实例模型配置同步完成"
+}
+
+main "$@"