sophhub 0.1.0

package/skills/builtin/sophnet-infinite-talk/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: sophnet-infinite-talk
+description: 当用户需要生成数字人视频（照片 + 音频驱动说话）时使用。接收人物形象图片 URL 和驱动音频 URL，在主会话中创建任务，然后在子会话中轮询查询任务进度，任务完成或失败后将结果报回主会话。
+---
+
+# Sophnet Infinite Talk（数字人）
+
+## 概述
+
+使用 `scripts/gen.py` 调用 Sophnet InfiniteTalk 接口，通过图片 + 音频驱动生成数字人说话视频。
+
+脚本路径：`{baseDir}/scripts/gen.py`
+
+## 何时使用
+
+- 用户要求"生成数字人视频"、"让照片说话"、"图片 + 音频合成视频"
+- 用户提供了人物照片和音频，希望生成说话视频
+- 用户想要数字人、虚拟人、照片驱动等功能
+
+## 输入参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--image-url` | 是 | 人物形象图片 URL 或本地文件路径（本地文件会自动上传 OSS 转为 URL） |
+| `--audio-url` | 是 | 驱动音频 URL 或本地文件路径（本地文件会自动上传 OSS 转为 URL） |
+| `--prompt` | 否 | 动作/表情提示词（默认: "自信的面对镜头"） |
+
+## 提取本地文件路径（如适用）
+
+当用户在聊天中上传图片或音频时，文件通常保存在工作区的 `media/inbound/images/` 或 `media/inbound/audio/` 目录下。可通过 Media Understanding 日志获取确切的绝对路径。
+
+典型日志格式：
+
+```
+[Media Understanding] Resolved relative path: "media/inbound/images/xxx.jpg" -> "/absolute/path/to/workspace/media/inbound/images/xxx.jpg"
+```
+
+使用解析后的绝对路径作为 `--image-url` 或 `--audio-url` 参数（脚本会自动上传 OSS 转为 URL）。
+
+## 处理流程（必须遵循）
+
+### 第一步：主会话 — 创建任务
+
+在主会话中调用 `create` 子命令提交任务：
+
+```bash
+# 使用 URL
+uv run {baseDir}/scripts/gen.py create \
+  --image-url "https://example.com/photo.png" \
+  --audio-url "https://example.com/audio.mp3" \
+  --prompt "自信的面对镜头"
+
+# 使用本地文件（自动上传 OSS）
+uv run {baseDir}/scripts/gen.py create \
+  --image-url "/path/to/photo.png" \
+  --audio-url "/path/to/audio.mp3"
+```
+
+成功输出示例：
+
+```json
+{"task_id": "7iOckhZZjgx6gzbESAqL1n"}
+```
+
+- 记录 `task_id`，向用户回复：**任务创建成功，已经创建子会话进行任务监控，完成后会通知您**
+- 如果返回 `error` 字段，直接告知用户失败原因。
+
+### 第二步：创建子会话 — 轮询查询任务
+
+脚本的 `query` 子命令执行**单次查询**并返回结果，**轮询循环由调用方（子会话）负责实现**。每 10 秒调用一次 `query`，最多轮询 360 次（约 1 小时超时）：
+
+```bash
+uv run {baseDir}/scripts/gen.py query --task-id "<task_id>"
+```
+
+可能的返回值：
+
+- 进行中：`{"status": "processing", "video_url": null}`
+- 成功：`{"status": "succeeded", "video_url": "https://..."}`
+- 失败：`{"status": "failed", "error": "失败原因"}`
+
+轮询规则：
+- `status` 为 `succeeded` 且 `video_url` 非空 → 停止轮询，获取 `video_url`
+- `status` 为 `failed` 或包含 `error` → 停止轮询，获取错误信息
+- 单次查询网络错误（返回 `{"error": "..."}` 无 `status` 字段）→ 视为临时失败，继续轮询（连续 3 次网络错误再终止）
+- 其他状态（如 `processing`、`queued`）→ 等待 10 秒后继续查询
+
+### 第三步：报告结果到主会话
+
+将子会话获取的最终结果报回主会话：
+
+- **成功**：将 `video_url` 展示给用户
+- **失败**：将错误信息展示给用户，引导重试
+
+### 第四步：自动清理子会话（必须执行）
+
+在子会话完成结果回传后，**必须立即自动删除该子会话**，避免会话资源残留。
+
+清理规则：
+- 成功回传主会话后，立即删除子会话。
+- 失败回传主会话后，立即删除子会话。
+- 超时回传主会话后，立即删除子会话。
+- 删除失败时，向主会话报告清理失败原因，并重试 1 次。
+
+## 输出格式
+
+成功：
+
+```text
+🎬 数字人视频生成成功！
+📸 使用图片: ![image](image_url)
+🎵 使用音频: <audio controls src="audio_url"></audio>
+🎭 动作提示: [prompt]
+✅ 生成视频: <video controls width="100%" src="video_url"></video>
+⚠️ 提示: 本内容由AI生成，视频保存24小时，请及时下载保存!
+```
+
+失败：
+
+```text
+❌ 数字人视频生成失败
+原因: [error]
+💡 建议: 请检查图片和音频链接是否有效，或稍后重试
+```
+
+## 失败处理
+
+- 若创建任务失败，直接告知用户失败原因。
+- 若轮询超时（1 小时），告知用户任务仍在处理中，可稍后重试。
+- 若单次查询网络错误，继续重试；连续 3 次网络错误再终止轮询并告知用户。
+- 引导用户检查图片和音频链接是否有效。
+
+## 注意事项
+
+- `--image-url` 和 `--audio-url` 必填，缺少任何一个都无法创建任务。
+- `--prompt` 可选，有默认值 "自信的面对镜头"，用于控制数字人的动作和表情。
+- 任务创建（主会话）和轮询查询（子会话）分两步执行，避免主会话长时间阻塞。
+- 子会话在最终结果回传主会话后必须自动删除，不能保留空闲子会话。
+- 脚本所有输出均为 JSON 格式（包括错误），便于程序化解析。
+- 视频生成可能需要较长时间，轮询超时上限为 1 小时，链接有效期 24 小时。

package/skills/builtin/sophnet-infinite-talk/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "sophnet-infinite-talk"
+version = "0.1.0"
+description = "Digital human video generation using Sophnet InfiniteTalk API"
+requires-python = ">=3.10"
+dependencies = [
+  "requests>=2.28.0",
+  "sophnet-tools>=0.0.1",
+]

package/skills/builtin/sophnet-infinite-talk/scripts/gen.py

@@ -0,0 +1,172 @@
+#!/usr/bin/env python3
+"""
+Sophnet Infinite Talk (Digital Human) Script
+
+Two-phase workflow:
+  create: submit a task, return task_id
+  query:  poll task status by task_id
+
+Usage:
+  python gen.py create --image-url <url> --audio-url <url> [--prompt <text>]
+  python gen.py query  --task-id <id>
+"""
+import os
+import sys
+import argparse
+import json
+import requests
+from typing import Optional, Any, Dict
+import sophnet_tools
+
+TASK_URL = "https://www.sophnet.com/api/open-apis/projects/easyllms/videogenerator/task"
+DEFAULT_PROMPT = "自信的面对镜头"
+
+
+def _is_url(path: str) -> bool:
+    return path.startswith(("http://", "https://"))
+
+
+def _resolve_to_url(path: str, label: str) -> str:
+    """本地文件上传 OSS 转为 URL；已经是 URL 则直接返回。失败时抛出 ValueError。"""
+    if _is_url(path):
+        return path
+    if not os.path.isfile(path):
+        raise ValueError(f"{label}文件不存在: {path}")
+    url = sophnet_tools.upload_oss(path)
+    if not url:
+        raise ValueError(f"{label}文件上传 OSS 失败: {path}")
+    return url
+
+
+def _headers(api_key: str) -> dict:
+    return {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json",
+    }
+
+
+def create_task(
+    api_key: str, image_url: str, audio_url: str, prompt: str = DEFAULT_PROMPT
+) -> Dict[str, Any]:
+    """提交数字人视频任务，返回 {"task_id": "..."} 或 {"error": "..."}。"""
+    payload = {
+        "model": "InfiniteTalk",
+        "content": [
+            {"type": "text", "text": prompt},
+            {
+                "type": "image_url",
+                "image_url": {"url": image_url},
+                "role": "first_frame",
+            },
+            {"type": "audio_url", "audio_url": audio_url},
+        ],
+    }
+    try:
+        resp = requests.post(
+            TASK_URL, headers=_headers(api_key), json=payload, timeout=60
+        )
+        resp.raise_for_status()
+        task_id = resp.text.strip()
+        if task_id:
+            return {"task_id": task_id}
+        return {"error": f"未能从响应中解析 task_id: {task_id}"}
+    except requests.exceptions.RequestException as e:
+        return {"error": f"HTTP 请求失败: {e}"}
+
+
+def _normalize_video_url(raw: Any) -> Optional[str]:
+    """API 在排队时可能返回字符串 'None'，视为无效。"""
+    if raw is None:
+        return None
+    s = str(raw).strip()
+    return None if s in ("", "None", "none") else s
+
+
+def get_task(api_key: str, task_id: str) -> Dict[str, Any]:
+    """
+    查询任务状态。
+
+    返回:
+      进行中: {"status": "processing", "video_url": null}
+      成功:   {"status": "succeeded", "video_url": "<url>"}
+      失败:   {"status": "failed", "error": "<reason>"}
+    """
+    try:
+        resp = requests.get(
+            f"{TASK_URL}/{task_id}", headers=_headers(api_key), timeout=30
+        )
+        resp.raise_for_status()
+        data = resp.json()
+    except requests.exceptions.RequestException as e:
+        return {"error": f"HTTP 请求失败: {e}"}
+
+    status = (data.get("status") or "").strip()
+    video_url = _normalize_video_url((data.get("content") or {}).get("video_url"))
+
+    if status == "succeeded":
+        if video_url:
+            return {"status": "succeeded", "video_url": video_url}
+        return {"status": "failed", "error": "任务标记为成功但未返回有效视频地址"}
+
+    if "failed" in status.lower():
+        err = (
+            data.get("message")
+            or data.get("error")
+            or (data.get("content") or {}).get("error")
+            or status
+        )
+        return {"status": "failed", "error": str(err)}
+
+    return {"status": status, "video_url": video_url}
+
+
+def _json_out(obj: Dict[str, Any]) -> None:
+    print(json.dumps(obj, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    api_key = sophnet_tools.get_api_key()
+    if api_key is None:
+        _json_out(
+            {"error": "未找到 Sophnet API Key，请联系客户支持"}
+        )
+        sys.exit(1)
+
+    parser = argparse.ArgumentParser(description="Sophnet Infinite Talk (数字人)")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_create = sub.add_parser("create", help="创建数字人视频任务")
+    p_create.add_argument(
+        "--image-url", required=True, help="人物形象图片 URL 或本地路径"
+    )
+    p_create.add_argument(
+        "--audio-url", required=True, help="驱动音频 URL 或本地路径"
+    )
+    p_create.add_argument(
+        "--prompt",
+        default=DEFAULT_PROMPT,
+        help=f"动作/表情提示词（默认: {DEFAULT_PROMPT}）",
+    )
+
+    p_query = sub.add_parser("query", help="查询数字人任务状态")
+    p_query.add_argument("--task-id", required=True, help="任务 ID")
+
+    args = parser.parse_args()
+
+    if args.command == "create":
+        try:
+            image_url = _resolve_to_url(args.image_url, "图片")
+            audio_url = _resolve_to_url(args.audio_url, "音频")
+        except ValueError as e:
+            _json_out({"error": str(e)})
+            sys.exit(1)
+        result = create_task(api_key, image_url, audio_url, args.prompt)
+        _json_out(result)
+        if "error" in result:
+            sys.exit(1)
+
+    elif args.command == "query":
+        result = get_task(api_key, args.task_id)
+        _json_out(result)
+        if "error" in result:
+            sys.exit(1)

package/skills/builtin/sophnet-oss/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: sophnet-oss
+description: Convert a local file path to a downloadable URL (valid for 24 hours). Use when users want to turn a file path into a shareable link, get a URL for a file, or need a temporary URL to access a local file.
+---
+
+# File Path to URL
+
+将本地文件路径转换为可访问的下载 URL，链接有效期为 24 小时。
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** - This skill must execute in a single, sequential operation:
+
+- **NO sub-tasks** - Never spawn background sessions or use sessions_spawn
+- **NO task splitting** - Complete the conversion in one continuous run
+- **NO parallel execution** - Convert one file at a time
+
+## Prerequisites
+
+- Python packages: sophnet-tools
+
+## Usage
+
+When a user wants to convert a file path to a URL:
+
+1. **Extract file path** from user input or recent logs (see Path Extraction below).
+2. **Run the script** using uv from workspace or skill directory:
+
+```bash
+uv run --with sophnet-tools \
+  python {baseDir}/scripts/upload_file.py \
+  --file /absolute/path/to/file \
+  --timeout 120
+```
+
+## Parameters
+
+- `--file`: 要转换为 URL 的本地文件路径（必填）
+- `--timeout`: 请求超时秒数（默认 120，大文件可适当增大）
+
+## Output
+
+The script outputs structured key-value pairs:
+
+```
+FILE_PATH=/absolute/path/to/file
+UPLOAD_STATUS=uploaded
+DOWNLOAD_URL=https://...signed-url...
+```
+
+On failure:
+
+```
+FILE_PATH=/absolute/path/to/file
+UPLOAD_STATUS=failed
+ERROR=error description
+```
+
+**转换成功后，向用户展示为：**
+
+```
+文件路径已转换为可访问链接：
+
+文件路径：/absolute/path/to/file
+下载链接：https://...signed-url...
+
+⏰ 链接有效期：24小时
+```
+
+## Path Extraction
+
+When users provide files through chat, look for log patterns like:
+
+```
+Resolved relative path: "media/inbound/images/xxx.pdf" -> "/absolute/path/to/workspace/media/inbound/images/xxx.pdf"
+```
+
+Extract the absolute path (right side of `->`) for use with the script.
+
+对于用户提供或引用的文件，优先从上述日志中取解析后的绝对路径，再传入脚本做路径转 URL。
+
+## Example Workflow
+
+User: "把这个文件转成链接" / "给我这个文件的 URL"
+
+1. Extract file path from logs (pattern: `Resolved relative path: "..." -> "/absolute/..."`) or user input
+2. Run: `uv run --with sophnet-tools python {baseDir}/scripts/upload_file.py --file /absolute/path/to/file --timeout 120`
+3. Parse the output and display the URL to the user
+
+## Notes
+
+- 返回的 URL 有效期为 **24 小时**
+- 任意类型文件均可转换（无扩展名限制）
+- 大文件可增大 `--timeout`（默认 120 秒）
+- 始终使用绝对路径以保证可靠
+
+## ⚠️ FORBIDDEN OPERATIONS
+
+**Do NOT:**
+
+- Spawn sub-agent sessions (sessions_spawn)
+- Run multiple parallel conversions
+- Split the task into separate operations
+- Use background processes
+
+**ONLY:**
+
+- Run the script once with the file path
+- Return the URL to the user in a single response

package/skills/builtin/sophnet-oss/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "sophnet-oss"
+version = "0.1.0"
+description = "Skill-local runtime dependencies for sophnet-oss"
+requires-python = ">=3.10"
+dependencies = [
+  "sophnet-tools>=0.0.1",
+]

package/skills/builtin/sophnet-oss/scripts/upload_file.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""Upload a file to Sophnet OSS and print the signed download URL."""
+
+import argparse
+import sys
+import os
+
+def main():
+    parser = argparse.ArgumentParser(description="Upload a file to Sophnet OSS")
+    parser.add_argument("--file", required=True, help="Path to the file to upload")
+    parser.add_argument("--timeout", type=int, default=120, help="Request timeout in seconds (default: 120)")
+    args = parser.parse_args()
+
+    file_path = os.path.abspath(os.path.expanduser(args.file))
+
+    if not os.path.isfile(file_path):
+        print(f"FILE_PATH={file_path}")
+        print("UPLOAD_STATUS=failed")
+        print(f"ERROR=file_not_found: {file_path}")
+        sys.exit(1)
+
+    try:
+        import sophnet_tools
+    except ImportError:
+        print(f"FILE_PATH={file_path}")
+        print("UPLOAD_STATUS=failed")
+        print("ERROR=sophnet-tools package not installed")
+        sys.exit(1)
+
+    signed_url = sophnet_tools.upload_oss(file_path, timeout=args.timeout)
+
+    if signed_url:
+        print(f"FILE_PATH={file_path}")
+        print("UPLOAD_STATUS=uploaded")
+        print(f"DOWNLOAD_URL={signed_url}")
+    else:
+        print(f"FILE_PATH={file_path}")
+        print("UPLOAD_STATUS=failed")
+        print("ERROR=upload_failed_no_url_returned")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

package/skills/builtin/sophnet-qa-install/SKILL.md

@@ -0,0 +1,210 @@
+---
+name: sophnet-qa-install
+description: 创建或更新智能客服系统（知识管理员 + 问答助手），包括工作空间初始化、模板下载、角色配置和配置文件注入。当用户要求创建客服系统、更新客服系统、智能问答、知识库客服时使用。
+version: 1.0.3
+---
+
+# 智能客服系统创建与更新
+
+创建或更新包含「知识管理员」和「问答助手」两个 Agent 的智能客服系统。创建和更新共用同一套流程（Step 2～6），区别仅在于：新安装需收集参数（Step 1），更新则复用已有配置并需用户确认。
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** — 按顺序逐步执行，不要拆分子任务或并行处理。
+
+## Prerequisites
+
+- Python 3.10+
+- unzip
+
+## 流程
+
+### Step 0: 校验安装状态
+
+执行校验脚本，根据返回状态决定后续流程。`{version}` 取自本文件 frontmatter 中的 `version` 字段：
+
+```bash
+uv run {baseDir}/scripts/check_installed.py --version {version}
+```
+
+脚本输出三种状态：
+
+#### 退出码 0 — `INSTALLED`（已安装，无需操作）
+
+向用户展示以下提示，并**终止流程**（不再执行 Step 1～6）。其中「客服子系统的API Secret」从 `openclaw.json` 的 `channels.bot-api.accounts["qa-agent"].apiSecret` 读取（与 `scripts/update_config.py` 中 `get_api_secret` 一致）。
+
+```
+智能客服系统已经安装，无需重复安装。
+
+📂 知识库目录：/home/node/.openclaw/workspace-knowledge/knowledge
+🤖 管理员会话：knowledge-admin
+💁 客服助手会话：qa-agent
+🔑 客服子系统的API Secret: <api_secret>
+
+📝 常用命令（在 knowledge-admin 会话中使用）：
+  • 通过附件按钮上传文件，并输入：将文档加入知识库
+  • 将 https://xxx 中的内容加入到知识库
+  • 将 xxx 写入到知识库
+  • 昨天客户都问了哪些问题
+  • 昨天客户都有哪些反馈
+  • 删除 xxx 知识库
+```
+
+#### 退出码 2 — `UPDATABLE`（可更新）
+
+文件已存在但版本低于目标版本，有新版本可用。脚本会额外输出已有配置中的 `ADMIN_NAME` 和 `QA_NAME`（如 `ADMIN_NAME=客服管理员`、`QA_NAME=客服助手`）。
+
+**必须先向用户确认，禁止直接更新。** 向用户展示以下提示并等待回复。其中 `{current_version}` 从 `check_installed.py` 输出或 `workspace-knowledge/git_version` 文件获取：
+
+```
+智能客服系统检测到新版本可用（{current_version} → {version}）。
+
+⚠️ 更新说明：
+  • 更新不会修改知识库内容
+  • 更新会重置 Agent 设置（角色配置等将恢复为模板默认值）
+  • 更新前会自动备份当前 Agent 配置到 backup_v{current_version} 目录
+
+是否确认更新？请回复「确认更新」或「取消」。
+```
+
+- 若用户回复确认（如"确认更新"、"确认"、"更新"、"好的"、"是"等肯定回复）：先执行配置备份，再**跳过 Step 1**，使用脚本输出的 `admin_name` 和 `qa_name`，从 Step 2 开始执行更新流程。
+- 若用户回复取消或其他非肯定回复：**终止流程**，不执行任何更新操作。
+
+##### 备份配置（用户确认后、Step 2 前执行）
+
+依次备份主工作空间和 workspace-qa 目录下的 `.md` 配置文件：
+
+```bash
+uv run {baseDir}/scripts/backup_md.py \
+  --current-version {current_version} \
+  --dir /home/node/.openclaw/workspace-knowledge
+```
+
+```bash
+uv run {baseDir}/scripts/backup_md.py \
+  --current-version {current_version} \
+  --dir /home/node/.openclaw/workspace-knowledge/workspace-qa
+```
+
+脚本成功后会输出备份目录路径（如 `备份成功: /home/node/.openclaw/workspace-knowledge/backup_v1.0.1`）。向用户展示备份结果：
+
+```
+✅ 当前 Agent 配置已备份到：
+  • {backup_dir_1}
+正在开始更新...
+```
+
+备份完成后，继续执行 Step 2～6。
+
+#### 退出码 1 — `NOT_INSTALLED`（未安装）
+
+未安装或未完整安装，继续执行 Step 1 开始完整安装流程。
+
+> 校验逻辑：先检查 Step 2 目录与软链接是否存在；若存在则比对 `workspace-knowledge/git_version` 与目标版本号；再检查 openclaw.json 中是否已配置 knowledge-admin 与 qa-agent。详见 `scripts/check_installed.py`。
+
+### Step 1: 收集参数
+
+向用户确认以下两个角色名称（有默认值，用户可直接回车跳过）：
+
+| 参数         | 说明               | 默认值     |
+| ------------ | ------------------ | ---------- |
+| `admin_name` | 知识管理员显示名称 | 客服管理员 |
+| `qa_name`    | 客服助手显示名称   | 客服助手   |
+
+### Step 2: 创建目录结构
+
+```bash
+mkdir -p /home/node/.openclaw/workspace-knowledge/workspace-qa/
+mkdir -p /home/node/.openclaw/workspace-knowledge/knowledge/
+```
+
+在 workspace-qa 下创建指向上级 knowledge 的软链接：
+
+```bash
+cd /home/node/.openclaw/workspace-knowledge/workspace-qa/
+ln -sf ../knowledge knowledge
+```
+
+### Step 3: 下载模板文件
+
+```bash
+cd /home/node/.openclaw/workspace-knowledge/
+wget -O workspace-knowledge.zip https://oss-upload-temp.sophnet.com/workspace-knowledge_v{version}.zip
+unzip -o workspace-knowledge.zip
+rm -f workspace-knowledge.zip
+```
+
+### Step 4: 替换占位符
+
+使用脚本替换 .md 文件中的 `{{客服助手}}` 和 `{{知识库管理员}}` 占位符。
+
+先替换主工作空间目录（不含子文件夹）：
+
+```bash
+uv run {baseDir}/scripts/update_md.py \
+  --dir /home/node/.openclaw/workspace-knowledge \
+  --qa-name "{qa_name}" \
+  --admin-name "{admin_name}"
+```
+
+再替换 workspace-qa 目录（不含子文件夹）：
+
+```bash
+uv run {baseDir}/scripts/update_md.py \
+  --dir /home/node/.openclaw/workspace-knowledge/workspace-qa \
+  --qa-name "{qa_name}" \
+  --admin-name "{admin_name}"
+```
+
+> `{baseDir}` 为本 skill 所在目录，`{qa_name}` 和 `{admin_name}` 替换为 Step 1 收集的值。
+
+### Step 5: 更新 openclaw.json
+
+```bash
+uv run {baseDir}/scripts/update_config.py \
+  --admin-name "{admin_name}" \
+  --qa-name "{qa_name}"
+```
+
+### Step 6: 完成提示
+
+全部执行成功后，向用户展示以下信息。其中「客服子系统的API Secret」取 Step 5 中 `update_config.py` 输出里的「客服助手 API Secret」；若未保留该输出，可从 `openclaw.json` 的 `channels.bot-api.accounts["qa-agent"].apiSecret` 读取（与 `scripts/update_config.py` 中 `get_api_secret` 一致）。
+
+```
+✅ 您的智能客服系统已创建完成！
+
+📂 知识库目录：/home/node/.openclaw/workspace-knowledge/knowledge
+🤖 管理员会话：knowledge-admin
+💁 客服助手会话：qa-agent
+🔑 客服子系统的API Secret: <api_secret>
+
+📌 快速上手：
+1. 将知识库文档上传至 knowledge 目录
+2. 切换到 knowledge-admin 会话，输入：处理一下 knowledge 里面的文档
+3. 完成知识库初步创建后，即可通过 qa-agent 对外提供问答服务
+
+📝 常用管理命令（在 knowledge-admin 会话中使用）：
+  • 通过附件按钮上传文件，并输入：将文档加入知识库
+  • 将 https://xxx 中的内容加入到知识库
+  • 将 xxx 写入到知识库
+  • 昨天客户都问了哪些问题
+  • 昨天客户都有哪些反馈
+  • 删除 xxx 知识库
+```
+
+## Error Handling
+
+- **已安装检测**：Step 0 使用 `check_installed.py` 检测安装状态；`INSTALLED` 直接展示常用命令并结束，不执行 Step 1～6
+- **可更新检测**：`UPDATABLE` 先提示用户有新版本并说明更新影响（不修改知识库、会重置 Agent 设置），等待用户明确确认后才执行 Step 2～6 完成更新；用户未确认则终止流程
+- **目录已存在**：Step 2 使用 `mkdir -p`，已有目录不会报错
+- **模板已下载**：Step 3 使用 `unzip -o` 覆盖已有文件
+- **Agent 已存在**：Step 5 中 `update_config.py` 会检测重复并报错；若未执行 Step 0 而直接到 Step 5 报错，可提示用户「智能客服已安装」，并给出上述常用命令
+
+## ⚠️ FORBIDDEN OPERATIONS
+
+**Do NOT:**
+
+- 修改 knowledge/ 目录下的知识库内容
+- 直接编辑 openclaw.json（必须通过脚本）
+- 跳过占位符替换步骤
+- 检测到可更新时未经用户确认直接执行更新（必须等用户明确回复确认）