openclaw-multi-auto 1.5.9 → 1.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-multi-auto",
-  "version": "1.5.9",
+  "version": "1.6.1",
   "description": "Multi-channel AI gateway with extensible messaging integrations",
   "keywords": [],
   "homepage": "https://github.com/openclaw/openclaw#readme",

package/scripts/create-instance.sh

@@ -1,8 +1,9 @@
 #!/usr/bin/env bash
 # =================================================================
 # OpenClaw 深度集成初始化工具 (create-instance.sh)
-# 功能：安装全局运行时、安装扩展、创建实例目录、复制文件、配置模型、启动服务
-# 正确顺序：安装全局 openclaw → 安装 page-action-cache → 创建实例
+# 功能：创建实例目录、复制文件、安装依赖、配置模型、启动服务
+# 增强：支持环境变量 OPENCLAW_SOURCE_DIR 定位源码，自动复制 docs 到根目录供 TUI 使用
+# 增强：支持 --profile 命令行习惯，自动配置 profile 软链接
 # =================================================================
 
 set -e
@@ -14,130 +15,75 @@ YELLOW='\033[1;33m'
 BLUE='\033[0;34m'
 NC='\033[0m'
 
-# --- 0. 检查必要命令 ---
-echo -e "${BLUE}🔍 检查必要命令...${NC}"
+# --- 检查必要命令 ---
 for cmd in node pnpm; do
     if ! command -v "$cmd" &> /dev/null; then
         echo -e "${RED}❌ 错误: 未找到命令 '$cmd'，请先安装${NC}"
         exit 1
     fi
 done
-echo -e "${GREEN}✅ 必要命令检查完成${NC}"
 
-# --- 1. 设置全局目录 ---
-GLOBAL_DIR="$HOME/openclaw-runtime"
-echo -e "${BLUE}📂 全局运行时目录: $GLOBAL_DIR${NC}"
-
-# 创建全局目录
-if [ ! -d "$GLOBAL_DIR" ]; then
-    echo -e "${YELLOW}📁 创建全局目录...${NC}"
-    mkdir -p "$GLOBAL_DIR"
-fi
-
-cd "$GLOBAL_DIR"
-echo -e "${GREEN}✅ 切换到全局目录: $(pwd)${NC}"
-
-# --- 2. 安装全局 openclaw-multi-auto ---
-echo -e "${BLUE}🤖 正在检查/安装全局 openclaw-multi-auto...${NC}"
-
-# 检查是否已安装 openclaw-multi-auto
-if pnpm list openclaw-multi-auto 2>&1 | grep -q "openclaw-multi-auto"; then
-    echo -e "${YELLOW}⚠️  openclaw-multi-auto 已在全局安装${NC}"
-    echo -e "${YELLOW}💡 如需更新，请使用: pnpm install openclaw-multi-auto@latest${NC}"
+# --- 1. 路径溯源与环境检查 ---
+if [ -n "$OPENCLAW_SOURCE_DIR" ] && [ -d "$OPENCLAW_SOURCE_DIR" ]; then
+    SOURCE_CODE="$OPENCLAW_SOURCE_DIR"
+    echo -e "${BLUE}📂 使用环境变量指定的源码路径: $SOURCE_CODE${NC}"
 else
-    echo -e "${YELLOW}📦 正在安装 openclaw-multi-auto 到全局目录...${NC}"
-    if ! pnpm install openclaw-multi-auto --registry=https://registry.npmmirror.com 2>&1; then
-        echo -e "${RED}❌ openclaw-multi-auto 安装失败${NC}"
-        echo -e "${YELLOW}💡 提示: 请检查网络连接或包名是否正确${NC}"
-        exit 1
+    LOCAL_SOURCE="$HOME/openclaw-runtime/node_modules/openclaw-multi-auto"
+    if [ -d "$LOCAL_SOURCE" ]; then
+        SOURCE_CODE="$LOCAL_SOURCE"
+        echo -e "${BLUE}📂 使用本地 pnpm 安装的源码路径: $SOURCE_CODE${NC}"
+    else
+        GLOBAL_PREFIX=$(npm config get prefix)
+        SOURCE_CODE="${GLOBAL_PREFIX}/lib/node_modules/openclaw-multi-auto"
+        echo -e "${YELLOW}⚠️  未找到环境变量和本地路径，尝试使用全局安装路径: $SOURCE_CODE${NC}"
     fi
-    echo -e "${GREEN}✅ openclaw-multi-auto 安装成功${NC}"
 fi
 
-# 检查全局安装结果
-if [ ! -d "node_modules/openclaw-multi-auto" ]; then
-    echo -e "${RED}❌ 严重错误: openclaw-multi-auto 未正确安装到 node_modules${NC}"
+if [ ! -d "$SOURCE_CODE" ]; then
+    echo -e "${RED}❌ 错误: 未找到 OpenClaw 源码目录: $SOURCE_CODE${NC}"
+    echo -e "${YELLOW}请确认已正确安装 openclaw-multi-auto，或设置 OPENCLAW_SOURCE_DIR 环境变量指向正确路径。${NC}"
     exit 1
 fi
 
-SOURCE_CODE="$GLOBAL_DIR/node_modules/openclaw-multi-auto"
-echo -e "${GREEN}✅ 全局 openclaw-multi-auto 路径: $SOURCE_CODE${NC}"
-
-# --- 3. 安装 page-action-cache 扩展到 openclaw-multi-auto ---
-echo -e "${BLUE}🤖 正在安装 page-action-cache 扩展到 openclaw-multi-auto...${NC}"
-
-# 扩展目录：openclaw-multi-auto/extensions
-OPENCLAW_EXTENSIONS_DIR="$SOURCE_CODE/extensions"
-if [ ! -d "$OPENCLAW_EXTENSIONS_DIR" ]; then
-    echo -e "${YELLOW}📁 创建 openclaw-multi-auto/extensions 目录...${NC}"
-    mkdir -p "$OPENCLAW_EXTENSIONS_DIR"
-fi
-
-# 检查 page-action-cache 是否已安装
-if [ -d "$OPENCLAW_EXTENSIONS_DIR/page-action-cache" ]; then
-    echo -e "${YELLOW}⚠️  page-action-cache 已在 openclaw-multi-auto 安装${NC}"
-    echo -e "${YELLOW}💡 如需更新，请手动更新${NC}"
-else
-    echo -e "${YELLOW}📦 正在安装 page-action-cache 到 openclaw-multi-auto/extensions...${NC}"
-    if ! pnpm add page-action-cache --registry=https://registry.npmmirror.com 2>&1; then
-        echo -e "${RED}❌ page-action-cache 安装失败${NC}"
-        echo -e "${YELLOW}💡 提示: 请检查网络连接或包名是否正确${NC}"
-        exit 1
-    fi
-
-    # 复制 page-action-cache 到 openclaw-multi-auto/extensions 目录
-    if [ -d "node_modules/page-action-cache" ]; then
-        echo -e "${YELLOW}📁 复制 page-action-cache 到 openclaw-multi-auto/extensions...${NC}"
-        cp -r "node_modules/page-action-cache" "$OPENCLAW_EXTENSIONS_DIR/"
-        echo -e "${GREEN}✅ page-action-cache 安装并复制成功${NC}"
-    else
-        echo -e "${YELLOW}⚠️  page-action-cache 已安装但未在 node_modules 中找到${NC}"
-    fi
-fi
-
-echo -e "${GREEN}✅ 全局扩展安装完成${NC}"
-echo -e "${BLUE}📝 全局运行时已就绪${NC}"
+INSTANCES_BASE=$(eval echo "$HOME/openclaws")
 
-# --- 4. 获取实例名称 ---
+# --- 2. 获取实例名称 ---
 INSTANCE_NAME="${1:-}"
 if [ -z "$INSTANCE_NAME" ]; then
     read -p "请输入实例名称 (默认: yunwei): " INPUT_NAME
     INSTANCE_NAME="${INPUT_NAME:-yunwei}"
 fi
 
-# --- 5. 获取端口 ---
+# --- 3. 获取端口 ---
 if [ -n "$2" ]; then
     PORT="$2"
 else
-    INSTANCES_BASE=$(eval echo "$HOME/openclaws")
     EXISTING_COUNT=$(find "$INSTANCES_BASE" -maxdepth 1 -type d -name "*" ! -name ".*" 2>/dev/null | wc -l | tr -d ' ')
     PORT=$((18789 + EXISTING_COUNT * 100))
 fi
 
-# --- 6. 定义实例目录并清理旧残留 ---
-INSTANCES_BASE=$(eval echo "$HOME/openclaws")
+# --- 4. 定义实例目录并清理旧残留 ---
 INSTANCE_DIR="$INSTANCES_BASE/${INSTANCE_NAME}"
 DIST_DIR="${INSTANCE_DIR}/dist"
 
 echo -e "${BLUE}🏗️  正在深度初始化实例: ${INSTANCE_NAME} (端口 ${PORT})${NC}"
 echo "SOURCE_CODE = $SOURCE_CODE"
-echo "GLOBAL_DIR = $GLOBAL_DIR"
 
 if [ -d "$INSTANCE_DIR" ]; then
     echo -e "${YELLOW}⚠️  清理旧实例目录...${NC}"
     rm -rf "$INSTANCE_DIR"
 fi
+[ -d "${INSTANCES_BASE}/node_modules" ] && rm -rf "${INSTANCES_BASE}/node_modules"
+[ -f "${INSTANCES_BASE}/pnpm-workspace.yaml" ] && rm -f "${INSTANCES_BASE}/pnpm-workspace.yaml"
 
-# --- 7. 完整目录结构创建 ---
-echo -e "${YELLOW}📁 创建实例目录结构...${NC}"
+# --- 5. 完整目录结构创建 ---
 mkdir -p "${INSTANCE_DIR}/config" "${INSTANCE_DIR}/tmp" "${INSTANCE_DIR}/workspace"
 mkdir -p "${INSTANCE_DIR}/state"
 mkdir -p "${INSTANCE_DIR}/workspace/memory"
 mkdir -p "${INSTANCE_DIR}/agents/main/agent/sessions"
 mkdir -p "${INSTANCE_DIR}/credentials" "${INSTANCE_DIR}/media"
-echo -e "${GREEN}✅ 目录结构创建完成${NC}"
 
-# --- 8. 动态提取母本版本号 ---
+# --- 6. 动态提取母本版本号 ---
 echo -e "${BLUE}🔍 正在提取母本版本信息...${NC}"
 PKG_PATH="${SOURCE_CODE}/package.json"
 if [ -f "$PKG_PATH" ]; then
@@ -148,53 +94,47 @@ else
     echo -e "${YELLOW}⚠️  未找到 package.json，使用兜底版本: ${CURRENT_VERSION}${NC}"
 fi
 
-# --- 9. 从全局目录复制到实例目录 ---
-echo -e "${BLUE}🔄 从全局运行时复制到实例目录...${NC}"
-
-# 定义需要复制的目录和文件
-DIRS_TO_COPY="dist extensions scripts skills docs ui assets"
-FILES_TO_COPY="package.json openclaw.mjs"
-
-cd "$SOURCE_CODE"
-
-# 复制所有必要目录
-for dir in $DIRS_TO_COPY; do
-    if [ -d "${SOURCE_CODE}/${dir}" ]; then
-        echo -ne "${YELLOW}📁 复制 ${dir}...${NC}"
-        cp -r "${SOURCE_CODE}/${dir}" "${INSTANCE_DIR}/"
-        echo -e "${GREEN} [完成]${NC}"
-    else
-        echo -e "${YELLOW}⚠️  跳过 ${dir} (不存在)${NC}"
+# --- 7. 核心代码同步 (物理对齐) ---
+echo -e "${BLUE}🔄 分发代码产物...${NC}"
+rm -rf "$DIST_DIR" && mkdir -p "$DIST_DIR"
+if [ -d "${SOURCE_CODE}/dist" ]; then
+    cp -r "${SOURCE_CODE}/dist/." "${DIST_DIR}/"
+    echo "cp exit code: $?"
+
+    if [ -f "${DIST_DIR}/index.js" ]; then
+        for chunk in $(grep -oE "utils-[A-Za-z0-9]+\.js" "${DIST_DIR}/index.js" 2>/dev/null | sort -u); do
+            if [ ! -f "${DIST_DIR}/${chunk}" ]; then
+                echo -e "${RED}❌ 致命错误: dist 缺失关键模块 ${chunk}${NC}"
+                echo -e "${YELLOW}请在源码端执行: rm -rf dist && pnpm build && npm publish${NC}"
+                exit 1
+            fi
+        done
     fi
-done
+else
+    echo -e "${RED}❌ 错误: 母本 dist 不存在${NC}"
+    exit 1
+fi
 
-# 复制所有必要文件
-for file in $FILES_TO_COPY; do
-    if [ -f "${SOURCE_CODE}/${file}" ]; then
-        echo -ne "${YELLOW}📄 复制 ${file}...${NC}"
-        cp "${SOURCE_CODE}/${file}" "${INSTANCE_DIR}/"
-        echo -e "${GREEN} [完成]${NC}"
-    else
-        echo -e "${YELLOW}⚠️  跳过 ${file} (不存在)${NC}"
-    fi
-done
+cp "${SOURCE_CODE}/package.json" "${INSTANCE_DIR}/package.json"
+[ -f "${SOURCE_CODE}/pnpm-lock.yaml" ] && cp "${SOURCE_CODE}/pnpm-lock.yaml" "${INSTANCE_DIR}/pnpm-lock.yaml"
 
-# 复制 pnpm-lock.yaml (如果存在)
-if [ -f "${SOURCE_CODE}/pnpm-lock.yaml" ]; then
-    cp "${SOURCE_CODE}/pnpm-lock.yaml" "${INSTANCE_DIR}/"
+# 复制 control-ui（如果存在）
+if [ -d "${SOURCE_CODE}/dist/control-ui" ]; then
+    cp -r "${SOURCE_CODE}/dist/control-ui" "${INSTANCE_DIR}/dist/"
 fi
 
-echo -e "${GREEN}✅ 核心代码复制完成${NC}"
-
-# --- 10. 安装实例依赖 ---
 export SHARP_BINARY_HOST="https://npmmirror.com/mirrors/sharp"
 export SHARP_LIBVIPS_BINARY_HOST="https://npmmirror.com/mirrors/sharp-libvips"
 
 cd "${INSTANCE_DIR}"
 echo -e "${YELLOW}📍 安装路径确认: $(pwd)${NC}"
 
-echo -e "${BLUE}📦 安装依赖包...${NC}"
-pnpm install --shamefully-hoist --ignore-workspace --registry=https://registry.npmmirror.com
+if [ -f "${INSTANCES_BASE}/pnpm-workspace.yaml" ]; then
+    echo -e "${YELLOW}⚠️  检测到 ${INSTANCES_BASE}/pnpm-workspace.yaml，临时重命名以避免干扰${NC}"
+    mv "${INSTANCES_BASE}/pnpm-workspace.yaml" "${INSTANCES_BASE}/pnpm-workspace.yaml.bak.$(date +%s)"
+fi
+
+pnpm install --shamefully-hoist --ignore-workspace --registry=https://registry.npmmirror.com --no-frozen-lockfile
 
 if [ ! -d "node_modules" ]; then
     echo -e "${RED}❌ 严重错误: pnpm install 完成但 node_modules 目录未创建！${NC}"
@@ -202,7 +142,7 @@ if [ ! -d "node_modules" ]; then
 fi
 echo -e "${GREEN}✅ 依赖安装成功，node_modules 已生成在实例目录${NC}"
 
-# --- 11. 模型配置 ---
+# --- 8. 参数与交互式获取 ---
 MODEL_PROVIDER="${3:-}"
 if [ -z "$MODEL_PROVIDER" ]; then
     echo -e "${BLUE}--- 请选择模型供应商 ---${NC}"
@@ -223,7 +163,7 @@ if [ -z "$API_KEY" ]; then
     read -p "请输入您的 ${MODEL_PROVIDER} API Key: " API_KEY
 fi
 
-# --- 12. 生成深度配置文件 ---
+# --- 9. 生成深度配置文件 ---
 DEFAULT_MODEL="zai/glm-5"
 ZAI_KEY=""; DS_KEY=""; MX_KEY=""; KIMI_KEY=""; QWEN_KEY=""
 
@@ -233,88 +173,328 @@ case "$MODEL_PROVIDER" in
     minimax) PRIMARY_MODEL="minimax-cn/MiniMax-M2.5-highspeed"; MX_KEY="$API_KEY" ;;
     kimi) PRIMARY_MODEL="kimi/moonshot-v1-8k"; KIMI_KEY="$API_KEY" ;;
     qwen) PRIMARY_MODEL="qwen/qwen-plus"; QWEN_KEY="$API_KEY" ;;
-    *) PRIMARY_MODEL="zai/glm-5"; ZAI_KEY="$API_KEY" ;;
 esac
 
-echo -e "${BLUE}⚙️  生成配置文件...${NC}"
-cat > "${INSTANCE_DIR}/config/deep.json" << EOF
+if date -u +"%Y-%m-%dT%H:%M:%S.%3NZ" 2>/dev/null; then
+    TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.%3NZ")
+else
+    TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
+fi
+
+cat > "${INSTANCE_DIR}/config/openclaw.json" << EOF
 {
-  "gateway": {
-    "mode": "local",
-    "port": ${PORT},
-    "bind": "127.0.0.1",
-    "autoStart": true
-  },
-  "plugins": {
-    "entries": {
-      "page-action-cache": {
-        "path": "${INSTANCE_DIR}/extensions/page-action-cache",
-        "enabled": true,
-        "config": {
-          "enabled": true,
-          "autoUseCache": true,
-          "scenarioRecognitionEnabled": true,
-          "llmClassificationThreshold": 0.8,
-          "cacheLevelStrategy": "auto",
-          "defaultCacheLevel": "L1",
-          "pageChangeDetectionEnabled": true,
-          "changeInvalidationThreshold": 0.5,
-          "invalidationStrategy": "soft",
-          "variableExtractionEnabled": true,
-          "allowUserConfirmVariables": true,
-          "allowUserForcedRefresh": true,
-          "enableUserCacheErrorReport": true,
-          "trackExecutionStats": true,
-          "statsUpdateInterval": 60000
-        }
-      }
-    }
+  "meta": {
+    "lastTouchedVersion": "${CURRENT_VERSION}",
+    "lastTouchedAt": "${TIMESTAMP}"
   },
-  "model": {
-    "defaultProvider": "${MODEL_PROVIDER}",
+  "models": {
     "providers": {
       "zai": {
+        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
         "apiKey": "${ZAI_KEY}",
-        "baseURL": "https://open.bigmodel.cn/api/paas/v4",
-        "models": ["zai/glm-5"]
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "glm-5",
+            "name": "GLM-5",
+            "input": ["text"],
+            "contextWindow": 32768,
+            "maxTokens": 4096
+          }
+        ]
       },
       "deepseek": {
+        "baseUrl": "https://api.deepseek.com",
         "apiKey": "${DS_KEY}",
-        "baseURL": "https://api.deepseek.com/v1",
-        "models": ["deepseek/deepseek-chat"]
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "deepseek-chat",
+            "name": "DeepSeek-Chat",
+            "input": ["text"],
+            "contextWindow": 32768,
+            "maxTokens": 4096
+          }
+        ]
       },
       "minimax-cn": {
+        "baseUrl": "https://api.minimax.chat/v1",
         "apiKey": "${MX_KEY}",
-        "baseURL": "https://api.minimax.chat/v1",
-        "models": ["minimax-cn/MiniMax-M2.5-highspeed"]
-      },
-      "kimi": {
-        "apiKey": "${KIMI_KEY}",
-        "baseURL": "https://api.moonshot.cn/v1",
-        "models": ["kimi/moonshot-v1-8k"]
+        "api": "openai-completions",
+        "models": [
+          {
+            "id": "MiniMax-M2.5-highspeed",
+            "name": "MiniMax-M2.5-highspeed",
+            "input": ["text"],
+            "cost": { "input": 0.000002, "output": 0.000006 },
+            "contextWindow": 65536,
+            "maxTokens": 8192
+          }
+        ]
       },
-      "qwen": {
-        "apiKey": "${QWEN_KEY}",
-        "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
-        "models": ["qwen/qwen-plus"]
+      "ollama": {
+        "baseUrl": "http://127.0.0.1:11434",
+        "api": "ollama",
+        "models": [
+          {
+            "id": "qwen3-vl:8b",
+            "name": "Qwen3-VL-8B",
+            "input": ["text", "image"],
+            "contextWindow": 32768,
+            "maxTokens": 4096
+          }
+        ]
       }
     }
-  }
+  },
+  "agents": {
+    "defaults": {
+      "model": { "primary": "${PRIMARY_MODEL}" },
+      "imageModel": {
+        "primary": "ollama/qwen3-vl:8b",
+        "fallbacks": [
+          "ollama/qwen3-vl:8b"
+        ]
+      },
+      "models": {
+        "ollama/qwen3-vl:8b": {}
+      },
+      "workspace": "${INSTANCE_DIR}/workspace",
+      "compaction": { "mode": "safeguard" }
+    }
+  },
+  "commands": { "native": "auto", "restart": false },
+  "gateway": { "port": ${PORT}, "mode": "local" }
 }
 EOF
 
-echo -e "${GREEN}✅ 配置文件生成完成${NC}"
+# --- 10. 预装可选技能 (失败不影响主流程) ---
+echo -e "${BLUE}🤖 正在注入飞书运维机器人引导...${NC}"
+SKILLS_DIR="${INSTANCE_DIR}/workspace/skills"
+mkdir -p "$SKILLS_DIR"
 
-# --- 13. 完成 ---
-echo -e "${GREEN}🎉 ${INSTANCE_NAME} 实例创建完成！${NC}"
-echo -e "${BLUE}📂 实例路径: ${INSTANCE_DIR}${NC}"
-echo -e "${BLUE}🔌 端口: ${PORT}${NC}"
-echo -e "${BLUE}🤖 模型: ${PRIMARY_MODEL}${NC}"
-echo -e "${BLUE}📦 全局运行时: ${GLOBAL_DIR}${NC}"
-echo -e "${BLUE}📝 配置文件: ${INSTANCE_DIR}/config/deep.json${NC}"
+SKILL_PKG="jinyu-skill-feishu-config"
+REGISTRY="https://registry.npmmirror.com"
 
-echo -e "${YELLOW}--- 启动命令 ---${NC}"
-echo -e "${BLUE}cd ${INSTANCE_DIR}${NC}"
-echo -e "${BLUE}node openclaw.mjs gateway run --config config/deep.json${NC}"
+TEMP_DIR=$(mktemp -d)
+cd "$TEMP_DIR"
 
-echo -e "${GREEN}🚀 已就绪，可以启动实例！${NC}"
+if npm pack "$SKILL_PKG@latest" --registry="$REGISTRY" --quiet > /dev/null; then
+    TARBALL=$(ls *.tgz)
+    mkdir -p "$SKILLS_DIR/feishu-config"
+    tar -xzf "$TARBALL" -C "$SKILLS_DIR/feishu-config" --strip-components=1
+    echo -e "${GREEN}✅ 技能 feishu-config 安装成功${NC}"
+else
+    echo -e "${YELLOW}⚠️  技能 feishu-config 下载失败，跳过（可手动安装）${NC}"
+fi
+
+cd - > /dev/null
+rm -rf "$TEMP_DIR"
+
+# --- 如果实例是 yunwei，安装角色包并初始化 workspace ---
+if [ "$INSTANCE_NAME" = "yunwei" ]; then
+    echo -e "${BLUE}🛠️  检测到运维实例，正在安装角色包 role-openclaw-yunwei...${NC}"
+    TEMP_ROLE_DIR=$(mktemp -d)
+    cd "$TEMP_ROLE_DIR"
+    if npm pack role-openclaw-yunwei@latest --registry=https://registry.npmmirror.com --quiet > /dev/null; then
+        TARBALL=$(ls *.tgz)
+        tar -xzf "$TARBALL" --strip-components=1
+        rm "$TARBALL"
+
+        # 1. 将 memory、skills 等目录复制到 workspace 根目录（排除 .md 文件）
+        for item in *; do
+            if [ -d "$item" ]; then
+                # 目录（如 memory、skills）复制到 workspace
+                cp -r "$item" "$INSTANCE_DIR/workspace/"
+            elif [ -f "$item" ]; then
+                # 非 .md 文件（如 package.json）也复制到 workspace
+                cp "$item" "$INSTANCE_DIR/workspace/" 2>/dev/null || true
+            fi
+        done
+
+        # 2. 创建实例根目录下的 docs 目录，并将所有 .md 文件复制过去
+        mkdir -p "$INSTANCE_DIR/docs/reference/templates"
+        cp *.md "$INSTANCE_DIR/docs/reference/templates/" 2>/dev/null || true
+
+        echo -e "${GREEN}✅ 角色包安装完成，workspace 已初始化${NC}"
+    else
+        echo -e "${YELLOW}⚠️  角色包下载失败，请检查网络或手动安装${NC}"
+    fi
+    cd - > /dev/null
+    rm -rf "$TEMP_ROLE_DIR"
+fi
+
+# --- 设置 profile 链接以便 openclaw --profile 使用 ---
+echo -e "${BLUE}🔗 配置 profile 链接以支持 --profile 命令行...${NC}"
+PROFILES_DIR="$HOME/.openclaw/profiles"
+mkdir -p "$PROFILES_DIR"
+
+# 配置文件软链接
+ln -sf "$INSTANCE_DIR/config/openclaw.json" "$PROFILES_DIR/$INSTANCE_NAME.json"
+
+# 状态目录软链接（profile 默认状态目录为 ~/.openclaw/profiles/<profile>/）
+# 使用 -sfn 以确保目录链接正确
+ln -sfn "$INSTANCE_DIR/state" "$PROFILES_DIR/$INSTANCE_NAME"
+
+echo -e "${GREEN}✅ 现在可以使用 'openclaw --profile $INSTANCE_NAME ...' 管理此实例${NC}"
+
+# --- 11. 生成增强型启动脚本 ---
+cat > "${INSTANCE_DIR}/start.sh" << 'EOF'
+#!/usr/bin/env bash
+# =================================================================
+# OpenClaw 实例启动脚本 (yunwei 优化版)
+# 功能：启动网关、运行 TUI 或其他命令
+# =================================================================
+
+# 确保全局安装的 openclaw 命令可用
+export PATH="$HOME/.npm-global/bin:$PATH"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR"
+INSTANCE_NAME=$(basename "$SCRIPT_DIR")
+
+# 导出核心配置路径
+export OPENCLAW_CONFIG_PATH="$SCRIPT_DIR/config/openclaw.json"
+export OPENCLAW_TMP_DIR="$SCRIPT_DIR/tmp"
+export OPENCLAW_STATE_DIR="$SCRIPT_DIR/state"
+
+# 从配置中提取 workspace 路径并导出
+if [ -f "$OPENCLAW_CONFIG_PATH" ]; then
+    export OPENCLAW_WORKSPACE=$(node -e "
+        const cfg = require('$OPENCLAW_CONFIG_PATH');
+        console.log(cfg.agents?.defaults?.workspace || '');
+    ")
+fi
+
+# 从配置中导出 API Key（如果存在 env 字段）
+if [ -f "$OPENCLAW_CONFIG_PATH" ]; then
+    eval $(node -e "
+        const env = require('$OPENCLAW_CONFIG_PATH').env || {};
+        Object.keys(env).forEach(k => {
+            if (env[k]) console.log('export ' + k + '=\"' + env[k] + '\"');
+        });
+    ")
+fi
+
+# macOS launchd 守护配置（可选）
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    PLIST_LABEL="ai.openclaw.$INSTANCE_NAME"
+    PLIST_PATH="$HOME/Library/LaunchAgents/$PLIST_LABEL.plist"
+    if [ ! -f "$PLIST_PATH" ]; then
+        cat > "$PLIST_PATH" <<EOP
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key><string>$PLIST_LABEL</string>
+    <key>ProgramArguments</key><array><string>/bin/bash</string><string>$SCRIPT_DIR/start.sh</string></array>
+    <key>RunAtLoad</key><true/><key>KeepAlive</key><true/>
+    <key>WorkingDirectory</key><string>$SCRIPT_DIR</string>
+</dict>
+</plist>
+EOP
+        launchctl load "$PLIST_PATH" 2>/dev/null || true
+    fi
+fi
+
+# 定义可执行文件路径：优先使用全局 openclaw，否则用绝对路径 node
+if command -v openclaw &> /dev/null; then
+    OPENCLAW_EXEC="openclaw"
+else
+    OPENCLAW_EXEC="node $SCRIPT_DIR/dist/index.js"
+fi
+
+# 根据命令行参数执行对应操作
+if [ $# -eq 0 ]; then
+    # 无参数：启动网关
+    GATEWAY_PORT=$(node -e "console.log(require('$OPENCLAW_CONFIG_PATH').gateway.port)")
+    echo "🚀 使用 $OPENCLAW_EXEC 启动 OpenClaw-$INSTANCE_NAME 网关..."
+    exec $OPENCLAW_EXEC gateway run --port "$GATEWAY_PORT"
+else
+    if [ "$1" = "tui" ]; then
+        # TUI 必须在 workspace 目录下运行，以正确加载模板文件
+        echo "🚀 启动 OpenClaw-$INSTANCE_NAME TUI (workspace mode)..."
+        cd "$OPENCLAW_WORKSPACE"
+        # 使用绝对路径调用 node，避免相对路径问题
+        exec node "$SCRIPT_DIR/dist/index.js" tui
+    else
+        # 其他命令直接在实例目录执行
+        echo "🚀 使用 $OPENCLAW_EXEC 执行 OpenClaw-$INSTANCE_NAME 命令: $@"
+        exec $OPENCLAW_EXEC "$@"
+    fi
+fi
+EOF
+
+chmod +x "${INSTANCE_DIR}/start.sh"
+
+# --- 12. 执行拉起 ---
+echo -e "${BLUE}⚡ 正在后台启动服务...${NC}"
+nohup "${INSTANCE_DIR}/start.sh" > "${INSTANCE_DIR}/workspace/server.log" 2>&1 &
+PID=$!
+
+sleep 5
+
+check_port() {
+    if command -v lsof &> /dev/null; then
+        lsof -i :$PORT -sTCP:LISTEN -t &> /dev/null
+    elif command -v nc &> /dev/null; then
+        nc -z localhost $PORT 2>/dev/null
+    elif command -v curl &> /dev/null; then
+        curl --head --connect-timeout 1 http://localhost:$PORT &> /dev/null
+    else
+        return 0
+    fi
+}
+
+if kill -0 $PID 2>/dev/null; then
+    if check_port; then
+        echo -e "${GREEN}================================================${NC}"
+        echo -e "${GREEN}🎉 实例 [${INSTANCE_NAME}] 初始化成功！${NC}"
+        echo -e "🌐 本地网关: http://localhost:${PORT}"
+        echo -e "📄 实时日志: tail -f ${INSTANCE_DIR}/workspace/server.log"
+        echo -e "${GREEN}================================================${NC}"
+
+        # --- 交互式菜单 ---
+        if [ -t 0 ]; then
+            echo
+            echo -e "${BLUE}请选择下一步操作：${NC}"
+            echo "1) 启动 TUI (终端交互界面)"
+            echo "2) 打开 Web UI (浏览器)"
+            echo "3) 退出"
+            read -p "请输入数字 [1-3]: " choice
+            case $choice in
+                1)
+                    echo -e "${YELLOW}启动 TUI...${NC}"
+                    cd "$INSTANCE_DIR"
+                    ./start.sh tui
+                    ;;
+                2)
+                    TOKEN=$(node -e "console.log(require('$INSTANCE_DIR/config/openclaw.json').gateway?.auth?.token || '')")
+                    if [ -n "$TOKEN" ]; then
+                        URL="http://localhost:$PORT/?token=$TOKEN"
+                        echo -e "${GREEN}请在浏览器中打开: ${BLUE}$URL${NC}"
+                        if [[ "$OSTYPE" == "darwin"* ]]; then
+                            open "$URL"
+                        elif command -v xdg-open &> /dev/null; then
+                            xdg-open "$URL"
+                        fi
+                    else
+                        echo -e "${RED}未找到 token，请手动查看配置文件。${NC}"
+                    fi
+                    ;;
+                3)
+                    echo "退出"
+                    exit 0
+                    ;;
+                *)
+                    echo "无效选择"
+                    ;;
+            esac
+        fi
+    else
+        echo -e "${YELLOW}⚠️  进程存在但端口 ${PORT} 未监听（可能启动较慢或检查工具问题），请查看日志: ${INSTANCE_DIR}/workspace/server.log${NC}"
+    fi
+else
+    echo -e "${RED}❌ 启动失败，请查看日志: tail -n 20 ${INSTANCE_DIR}/workspace/server.log${NC}"
+    exit 1
+fi