简介这份《最全面的OpenClaw中文教程》面向希望本地部署AI助手、重视数据隐私与功能扩展的技术用户系统讲解开源AI智能体Gateway网关的完整用法。教程基于2026年2月9日稳定版本编写从认识OpenClaw、Gateway网关工作原理到AI智能体模型接入、Skills技能系统与ClawHub技能市场逐层展开并覆盖文件管理、知识管理、日程管理、自动化等核心场景帮助读者理解本地部署、多平台集成与按需付费的成本优势。资源为单个PDF文件压缩包约37.92MB内容结构清晰含版本说明、对比表格与真实案例演示便于对照学习。目前已有413人学习下载适合想用飞书、企微、QQ等平台随时调用AI助手并希望掌握Skills扩展与自定义开发的读者参考。1. 拿到《最全面的OpenClaw中文教程.pdf》之后我先翻的不是目录如果你最近在折腾 OpenClaw大概率经历过这个场景在 Windows 上敲完安装命令PowerShell 弹出一句openclaw无法安全验证 sl2环境。请在powershell中运行wsl-- status然后你就卡住了不知道该去查 WSL 还是去翻 Node.js 版本。这份《最全面的OpenClaw中文教程.pdf》解决的正是这类问题——它不是一份泛泛的概念介绍而是把 OpenClaw 从安装、部署到 skill 配置、Obsidian 联动的整条链路用中文串了一遍。适合两类人一是在 Windows 或 Ubuntu 上第一次搭 OpenClaw、被环境问题反复劝退的开发者二是已经跑起来但想搞清楚 skill 机制、想把本地模型接进去的熟手。我拿到之后先翻的不是目录而是排查章节因为环境验证那一步才是真正的分水岭。2. OpenClaw 的定位与运行环境选型为什么它绕不开 WSL2.1 OpenClaw 到底是个什么东西从这份教程的组织方式能看出来OpenClaw 是一个偏本地优先的智能体运行框架核心能力是把模型、工具调用skill和外部知识源比如 Obsidian 笔记库编排到一起。它和纯云端的方案最大的区别在于模型可以跑在本地数据不出机器skill 是文件系统里可读可改的配置而不是藏在某个后台里的黑匣子。教程里反复出现的几个关键词——openclaw skill、openclaw obsidian、qwen2.5-3b 关联到 openclaw——其实指向同一件事它要解决的是「本地模型 本地工具 本地知识」的编排问题。这也解释了为什么它的安装过程比一个普通 npm 包麻烦。普通 CLI 工具装完就能跑OpenClaw 装完之后还要验证运行环境、挂载模型、注册 skill任何一环没对齐都会在启动时报错。教程把安装拆成 Windows 和 Ubuntu 两条线不是凑篇幅而是因为这两条线的底层依赖确实不同。2.2 Windows 下为什么必须过 WSL 这一关热词里那句openclaw无法安全验证 sl2环境。请在powershell中运行wsl-- status是最高频的翻车点。它的本质是OpenClaw 在 Windows 上并不是原生运行的而是依赖 WSL2 提供的 Linux 兼容层。所谓「sl2环境」就是 WSL2验证失败通常意味着三种情况之一——WSL 根本没装、装了但默认版本还是 WSL1、或者 WSL 子系统本身起不来。先在 PowerShell 里确认状态# 查看 WSL 整体状态和已安装的发行版 wsl --status # 列出所有发行版及其 WSL 版本号 wsl --list --verbosewsl --status会告诉你默认发行版和默认 WSL 版本。如果输出里默认版本是 1需要手动切到 2# 把默认版本设为 WSL2这是 OpenClaw 能跑起来的前提 wsl --set-default-version 2 # 如果某个已装发行版还是 1单独转换把 Ubuntu 换成你的发行版名 wsl --set-version Ubuntu 2参数说明--set-default-version 2只影响之后新装的发行版已经装好的必须用--set-version单独转。转换过程可能要几分钟期间不要中断。转完之后再跑一次wsl --list --verbose确认 VERSION 列全是 2再回到 OpenClaw 的安装步骤。提示如果wsl --status直接报「未安装用于 Linux 的 Windows 子系统」先去「启用或关闭 Windows 功能」里勾选「适用于 Linux 的 Windows 子系统」和「虚拟机平台」重启后再执行wsl --install。2.3 Ubuntu 原生安装为什么反而更省心在 Ubuntu 上装 OpenClaw 没有 WSL 这层中转少了一个变量。教程里 Ubuntu 安装教程那条线明显更短因为依赖直接落在系统层。常见做法是先确认 Node.js 版本再走包管理安装。Node.js 官网下载 openclaw 这个搜索词说明不少人是从官网拿的 Node但要注意版本对齐# 确认 Node 版本OpenClaw 一般要求较新的 LTS node -v # 确认 npm 可用 npm -v # 如果版本过低用 nvm 管理多版本更稳妥 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 安装并切换到 Node 20 LTS nvm install 20 nvm use 20逻辑说明OpenClaw 的依赖树里有些包对 Node 版本敏感用系统自带的旧 Node 经常在安装阶段就报编译错误。用 nvm 的好处是版本可切换出问题能快速回退不用动系统级 Node。这一步做完再执行 OpenClaw 的安装命令成功率会高很多。3. 从安装到跑通OpenClaw 部署的完整操作链3.1 安装命令与首次启动的验证点环境确认无误之后安装本身不复杂但首次启动的验证点必须逐个过。教程里 openclaw安装、openclaw部署这两个环节是连在一起的我把它拆成可复现的步骤# 全局安装 OpenClaw具体包名以教程内为准 npm install -g openclaw # 确认安装成功查看版本 openclaw --version # 初始化配置生成默认配置文件 openclaw init # 启动服务 openclaw start逻辑说明init这一步会生成配置文件通常在用户目录下的隐藏文件夹里里面包含模型路径、skill 目录、端口等关键项。很多人跳过 init 直接 start结果因为找不到配置而报错。start之后不要只看它有没有退出要确认监听端口起来了并且日志里没有模型加载失败的记录。参数说明如果openclaw start卡在模型加载先检查配置文件里的模型路径是不是指向了一个真实存在的模型文件。qwen2.5-3b 关联到 openclaw 这个热词说明不少人在用 Qwen2.5-3B 这种小模型做本地推理路径写错是最常见的低级错误。3.2 skill 机制OpenClaw 真正好用的地方openclaw skill 是这套框架的核心扩展点。skill 本质上是一组描述「什么时候调用、调用什么、传什么参数」的配置放在指定目录里OpenClaw 启动时扫描加载。教程里对 skill 的讲解如果只看一遍容易漏掉目录约定我建议直接动手建一个最小 skill 验证# 进入 skill 目录路径以你的配置为准 cd ~/.openclaw/skills # 新建一个测试 skill 目录 mkdir hello-skill # 创建 skill 描述文件 cat hello-skill/skill.json EOF { name: hello-skill, description: 一个用于验证 skill 加载的最小示例, trigger: 当用户说你好时触发, action: { type: shell, command: echo hello from skill } } EOF逻辑说明trigger是自然语言描述OpenClaw 靠它判断何时激活这个 skillaction定义实际执行的动作这里用最简单的 shell 命令验证链路通不通。建完之后重启 OpenClaw在对话里说「你好」如果日志里出现 skill 被调用的记录说明 skill 机制正常工作。参数说明不同版本的 skill 描述字段可能有差异以教程内给出的 schema 为准。如果 skill 没被触发先看日志里有没有「skill loaded」的字样没有就是目录或文件名不对有加载但没触发就是 trigger 描述写得太模糊模型没匹配上。3.3 把 Obsidian 笔记库接进来openclaw obsidian 这个组合是很多人的实际诉求让 OpenClaw 能读自己的笔记基于笔记内容回答问题。教程里这部分的关键在于路径挂载和索引方式。常见做法是把 Obsidian 库目录作为一个数据源注册进去# 在配置文件中添加数据源示例结构字段以教程为准 # dataSources: # - type: obsidian # path: /home/user/MyVault # index: true逻辑说明path指向 Obsidian 库的根目录index: true表示启动时建立索引。索引这一步对笔记量大的库会比较慢但只做一次之后增量更新。如果不开索引OpenClaw 每次查询都要实时扫描文件响应会明显变慢。参数说明路径一定要用绝对路径相对路径在不同启动目录下会解析失败。另外 Obsidian 库里的附件和图片默认不索引如果笔记里大量引用图片需要额外配置附件处理否则检索结果会缺内容。4. 避坑与排查那些让 OpenClaw 起不来的高频问题4.1 现象启动报「无法安全验证 sl2环境」原因WSL2 未安装、默认版本为 1或虚拟机平台功能未启用。这是 Windows 用户遇到最多的第一道坎。解决按 2.2 节的步骤依次执行wsl --status、wsl --set-default-version 2、wsl --set-version 发行版 2。如果wsl --status本身报错去 Windows 功能里启用「适用于 Linux 的 Windows 子系统」和「虚拟机平台」重启后再试。转换版本后务必用wsl --list --verbose确认 VERSION 列为 2。4.2 现象安装过程卡在 node-gyp 编译报错原因Node 版本过低或缺少系统编译工具链。OpenClaw 的部分依赖需要本地编译纯净系统上经常缺 python 和 make。解决Ubuntu 下先补工具链sudo apt install -y build-essential python3再用 nvm 切到 Node 20 LTS。Windows 下如果是在 WSL 里操作同样在 WSL 的 Ubuntu 里补这些包不要在 PowerShell 里装。版本对齐之后重新npm install -g openclaw。4.3 现象skill 建好了但对话时从不触发原因trigger 描述过于宽泛或与用户实际说法不匹配也可能是 skill 目录不在配置的扫描路径内。解决先确认日志里有 skill 加载记录没有就检查目录路径和文件名。有加载但不触发把 trigger 写得更具体比如把「当用户说你好时触发」改成「当用户输入包含『你好』『hello』的问候语时触发」。改完重启用完全匹配的句子测试确认链路通了再放宽描述。4.4 现象接上 Obsidian 后查询很慢或查不到内容原因索引未开启或笔记库路径配置错误或附件未被处理。解决确认配置里index: true已开启路径是绝对路径。首次索引耐心等完成之后是增量。如果查不到某篇笔记的内容检查该笔记是否在库根目录的子目录里、是否被 Obsidian 的排除规则过滤掉了。图片和 PDF 附件默认不索引需要单独配置。4.5 现象本地模型加载失败或推理报显存不足原因模型路径错误、模型格式不匹配或显存不够跑当前量化版本。解决先确认模型文件真实存在且路径无误。qwen2.5-3b 这类小模型一般对显存要求不高但如果用的是未量化的完整权重显存占用会明显上升。换用量化版本如 GGUF 的 Q4 量化通常能解决。加载失败时看日志里的具体报错是找不到文件还是格式不支持两者处理方式不同。5. 进阶把 OpenClaw 用成日常工具的几个具体技巧跑通之后真正决定它好不好用的是几个细节。第一个是 skill 的粒度控制。我一开始把太多功能塞进一个 skill结果 trigger 互相干扰模型经常调错。后来改成每个 skill 只做一件事trigger 描述里带上明确的输入特征命中率明显提升。这个习惯是从反复调试里逼出来的不是看文档能看会的。第二个是模型切换策略。不是所有任务都需要同一个模型。简单问答用 qwen2.5-3b 这种小模型响应快、占用低需要长上下文推理时再切到更大的模型。教程里如果只给了一个模型配置示例可以自己复制多份配置按场景切换。下面是一个配置结构的示意配置项小模型场景大模型场景模型文件qwen2.5-3b 量化版更大参数量的量化版上下文长度较短省显存按需调大适用任务日常问答、skill 触发长文档分析、多步推理显存占用低高需提前确认第三个是 Obsidian 索引的维护。笔记库是活的每天在变。如果发现新写的笔记查不到先手动触发一次重建索引而不是怀疑配置坏了。索引重建的频率取决于笔记更新速度我一般一周重建一次日常靠增量。第四个是日志。OpenClaw 出问题时日志比任何猜测都可靠。启动阶段看加载了哪些 skill、模型有没有成功挂载运行阶段看 skill 调用记录和模型返回。把日志级别调到 debug 能看到更细的链路但日常跑建议保持默认不然日志量太大反而干扰排查。最后说一个验证方法每次改完配置或新增 skill不要直接上真实任务先用一个最小输入测一遍。比如新增了查笔记的 skill就先问一个你确定答案在库里的问题确认返回正确再继续。这个习惯帮我省了很多「改了配置结果整个服务起不来」的后悔药。从那以后我每次动配置之前都先备份一份改完先跑最小验证确认没问题再往下走。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/30 13:06:08 · 阅读 1.2k OpenClaw中文教程：从WSL环境验证到skill与Obsidian联动部署
简介这份《最全面的OpenClaw中文教程》面向希望本地部署AI助手、重视数据隐私与功能扩展的技术用户系统讲解开源AI智能体Gateway网关的完整用法。教程基于2026年2月9日稳定版本编写从认识OpenClaw、Gateway网关工作原理到AI智能体模型接入、Skills技能系统与ClawHub技能市场逐层展开并覆盖文件管理、知识管理、日程管理、自动化等核心场景帮助读者理解本地部署、多平台集成与按需付费的成本优势。资源为单个PDF文件压缩包约37.92MB内容结构清晰含版本说明、对比表格与真实案例演示便于对照学习。目前已有413人学习下载适合想用飞书、企微、QQ等平台随时调用AI助手并希望掌握Skills扩展与自定义开发的读者参考。1. 拿到《最全面的OpenClaw中文教程.pdf》之后我先翻的不是目录如果你最近在折腾 OpenClaw大概率经历过这个场景在 Windows 上敲完安装命令PowerShell 弹出一句openclaw无法安全验证 sl2环境。请在powershell中运行wsl-- status然后你就卡住了不知道该去查 WSL 还是去翻 Node.js 版本。这份《最全面的OpenClaw中文教程.pdf》解决的正是这类问题——它不是一份泛泛的概念介绍而是把 OpenClaw 从安装、部署到 skill 配置、Obsidian 联动的整条链路用中文串了一遍。适合两类人一是在 Windows 或 Ubuntu 上第一次搭 OpenClaw、被环境问题反复劝退的开发者二是已经跑起来但想搞清楚 skill 机制、想把本地模型接进去的熟手。我拿到之后先翻的不是目录而是排查章节因为环境验证那一步才是真正的分水岭。2. OpenClaw 的定位与运行环境选型为什么它绕不开 WSL2.1 OpenClaw 到底是个什么东西从这份教程的组织方式能看出来OpenClaw 是一个偏本地优先的智能体运行框架核心能力是把模型、工具调用skill和外部知识源比如 Obsidian 笔记库编排到一起。它和纯云端的方案最大的区别在于模型可以跑在本地数据不出机器skill 是文件系统里可读可改的配置而不是藏在某个后台里的黑匣子。教程里反复出现的几个关键词——openclaw skill、openclaw obsidian、qwen2.5-3b 关联到 openclaw——其实指向同一件事它要解决的是「本地模型 本地工具 本地知识」的编排问题。这也解释了为什么它的安装过程比一个普通 npm 包麻烦。普通 CLI 工具装完就能跑OpenClaw 装完之后还要验证运行环境、挂载模型、注册 skill任何一环没对齐都会在启动时报错。教程把安装拆成 Windows 和 Ubuntu 两条线不是凑篇幅而是因为这两条线的底层依赖确实不同。2.2 Windows 下为什么必须过 WSL 这一关热词里那句openclaw无法安全验证 sl2环境。请在powershell中运行wsl-- status是最高频的翻车点。它的本质是OpenClaw 在 Windows 上并不是原生运行的而是依赖 WSL2 提供的 Linux 兼容层。所谓「sl2环境」就是 WSL2验证失败通常意味着三种情况之一——WSL 根本没装、装了但默认版本还是 WSL1、或者 WSL 子系统本身起不来。先在 PowerShell 里确认状态# 查看 WSL 整体状态和已安装的发行版 wsl --status # 列出所有发行版及其 WSL 版本号 wsl --list --verbosewsl --status会告诉你默认发行版和默认 WSL 版本。如果输出里默认版本是 1需要手动切到 2# 把默认版本设为 WSL2这是 OpenClaw 能跑起来的前提 wsl --set-default-version 2 # 如果某个已装发行版还是 1单独转换把 Ubuntu 换成你的发行版名 wsl --set-version Ubuntu 2参数说明--set-default-version 2只影响之后新装的发行版已经装好的必须用--set-version单独转。转换过程可能要几分钟期间不要中断。转完之后再跑一次wsl --list --verbose确认 VERSION 列全是 2再回到 OpenClaw 的安装步骤。提示如果wsl --status直接报「未安装用于 Linux 的 Windows 子系统」先去「启用或关闭 Windows 功能」里勾选「适用于 Linux 的 Windows 子系统」和「虚拟机平台」重启后再执行wsl --install。2.3 Ubuntu 原生安装为什么反而更省心在 Ubuntu 上装 OpenClaw 没有 WSL 这层中转少了一个变量。教程里 Ubuntu 安装教程那条线明显更短因为依赖直接落在系统层。常见做法是先确认 Node.js 版本再走包管理安装。Node.js 官网下载 openclaw 这个搜索词说明不少人是从官网拿的 Node但要注意版本对齐# 确认 Node 版本OpenClaw 一般要求较新的 LTS node -v # 确认 npm 可用 npm -v # 如果版本过低用 nvm 管理多版本更稳妥 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 安装并切换到 Node 20 LTS nvm install 20 nvm use 20逻辑说明OpenClaw 的依赖树里有些包对 Node 版本敏感用系统自带的旧 Node 经常在安装阶段就报编译错误。用 nvm 的好处是版本可切换出问题能快速回退不用动系统级 Node。这一步做完再执行 OpenClaw 的安装命令成功率会高很多。3. 从安装到跑通OpenClaw 部署的完整操作链3.1 安装命令与首次启动的验证点环境确认无误之后安装本身不复杂但首次启动的验证点必须逐个过。教程里 openclaw安装、openclaw部署这两个环节是连在一起的我把它拆成可复现的步骤# 全局安装 OpenClaw具体包名以教程内为准 npm install -g openclaw # 确认安装成功查看版本 openclaw --version # 初始化配置生成默认配置文件 openclaw init # 启动服务 openclaw start逻辑说明init这一步会生成配置文件通常在用户目录下的隐藏文件夹里里面包含模型路径、skill 目录、端口等关键项。很多人跳过 init 直接 start结果因为找不到配置而报错。start之后不要只看它有没有退出要确认监听端口起来了并且日志里没有模型加载失败的记录。参数说明如果openclaw start卡在模型加载先检查配置文件里的模型路径是不是指向了一个真实存在的模型文件。qwen2.5-3b 关联到 openclaw 这个热词说明不少人在用 Qwen2.5-3B 这种小模型做本地推理路径写错是最常见的低级错误。3.2 skill 机制OpenClaw 真正好用的地方openclaw skill 是这套框架的核心扩展点。skill 本质上是一组描述「什么时候调用、调用什么、传什么参数」的配置放在指定目录里OpenClaw 启动时扫描加载。教程里对 skill 的讲解如果只看一遍容易漏掉目录约定我建议直接动手建一个最小 skill 验证# 进入 skill 目录路径以你的配置为准 cd ~/.openclaw/skills # 新建一个测试 skill 目录 mkdir hello-skill # 创建 skill 描述文件 cat hello-skill/skill.json EOF { name: hello-skill, description: 一个用于验证 skill 加载的最小示例, trigger: 当用户说你好时触发, action: { type: shell, command: echo hello from skill } } EOF逻辑说明trigger是自然语言描述OpenClaw 靠它判断何时激活这个 skillaction定义实际执行的动作这里用最简单的 shell 命令验证链路通不通。建完之后重启 OpenClaw在对话里说「你好」如果日志里出现 skill 被调用的记录说明 skill 机制正常工作。参数说明不同版本的 skill 描述字段可能有差异以教程内给出的 schema 为准。如果 skill 没被触发先看日志里有没有「skill loaded」的字样没有就是目录或文件名不对有加载但没触发就是 trigger 描述写得太模糊模型没匹配上。3.3 把 Obsidian 笔记库接进来openclaw obsidian 这个组合是很多人的实际诉求让 OpenClaw 能读自己的笔记基于笔记内容回答问题。教程里这部分的关键在于路径挂载和索引方式。常见做法是把 Obsidian 库目录作为一个数据源注册进去# 在配置文件中添加数据源示例结构字段以教程为准 # dataSources: # - type: obsidian # path: /home/user/MyVault # index: true逻辑说明path指向 Obsidian 库的根目录index: true表示启动时建立索引。索引这一步对笔记量大的库会比较慢但只做一次之后增量更新。如果不开索引OpenClaw 每次查询都要实时扫描文件响应会明显变慢。参数说明路径一定要用绝对路径相对路径在不同启动目录下会解析失败。另外 Obsidian 库里的附件和图片默认不索引如果笔记里大量引用图片需要额外配置附件处理否则检索结果会缺内容。4. 避坑与排查那些让 OpenClaw 起不来的高频问题4.1 现象启动报「无法安全验证 sl2环境」原因WSL2 未安装、默认版本为 1或虚拟机平台功能未启用。这是 Windows 用户遇到最多的第一道坎。解决按 2.2 节的步骤依次执行wsl --status、wsl --set-default-version 2、wsl --set-version 发行版 2。如果wsl --status本身报错去 Windows 功能里启用「适用于 Linux 的 Windows 子系统」和「虚拟机平台」重启后再试。转换版本后务必用wsl --list --verbose确认 VERSION 列为 2。4.2 现象安装过程卡在 node-gyp 编译报错原因Node 版本过低或缺少系统编译工具链。OpenClaw 的部分依赖需要本地编译纯净系统上经常缺 python 和 make。解决Ubuntu 下先补工具链sudo apt install -y build-essential python3再用 nvm 切到 Node 20 LTS。Windows 下如果是在 WSL 里操作同样在 WSL 的 Ubuntu 里补这些包不要在 PowerShell 里装。版本对齐之后重新npm install -g openclaw。4.3 现象skill 建好了但对话时从不触发原因trigger 描述过于宽泛或与用户实际说法不匹配也可能是 skill 目录不在配置的扫描路径内。解决先确认日志里有 skill 加载记录没有就检查目录路径和文件名。有加载但不触发把 trigger 写得更具体比如把「当用户说你好时触发」改成「当用户输入包含『你好』『hello』的问候语时触发」。改完重启用完全匹配的句子测试确认链路通了再放宽描述。4.4 现象接上 Obsidian 后查询很慢或查不到内容原因索引未开启或笔记库路径配置错误或附件未被处理。解决确认配置里index: true已开启路径是绝对路径。首次索引耐心等完成之后是增量。如果查不到某篇笔记的内容检查该笔记是否在库根目录的子目录里、是否被 Obsidian 的排除规则过滤掉了。图片和 PDF 附件默认不索引需要单独配置。4.5 现象本地模型加载失败或推理报显存不足原因模型路径错误、模型格式不匹配或显存不够跑当前量化版本。解决先确认模型文件真实存在且路径无误。qwen2.5-3b 这类小模型一般对显存要求不高但如果用的是未量化的完整权重显存占用会明显上升。换用量化版本如 GGUF 的 Q4 量化通常能解决。加载失败时看日志里的具体报错是找不到文件还是格式不支持两者处理方式不同。5. 进阶把 OpenClaw 用成日常工具的几个具体技巧跑通之后真正决定它好不好用的是几个细节。第一个是 skill 的粒度控制。我一开始把太多功能塞进一个 skill结果 trigger 互相干扰模型经常调错。后来改成每个 skill 只做一件事trigger 描述里带上明确的输入特征命中率明显提升。这个习惯是从反复调试里逼出来的不是看文档能看会的。第二个是模型切换策略。不是所有任务都需要同一个模型。简单问答用 qwen2.5-3b 这种小模型响应快、占用低需要长上下文推理时再切到更大的模型。教程里如果只给了一个模型配置示例可以自己复制多份配置按场景切换。下面是一个配置结构的示意配置项小模型场景大模型场景模型文件qwen2.5-3b 量化版更大参数量的量化版上下文长度较短省显存按需调大适用任务日常问答、skill 触发长文档分析、多步推理显存占用低高需提前确认第三个是 Obsidian 索引的维护。笔记库是活的每天在变。如果发现新写的笔记查不到先手动触发一次重建索引而不是怀疑配置坏了。索引重建的频率取决于笔记更新速度我一般一周重建一次日常靠增量。第四个是日志。OpenClaw 出问题时日志比任何猜测都可靠。启动阶段看加载了哪些 skill、模型有没有成功挂载运行阶段看 skill 调用记录和模型返回。把日志级别调到 debug 能看到更细的链路但日常跑建议保持默认不然日志量太大反而干扰排查。最后说一个验证方法每次改完配置或新增 skill不要直接上真实任务先用一个最小输入测一遍。比如新增了查笔记的 skill就先问一个你确定答案在库里的问题确认返回正确再继续。这个习惯帮我省了很多「改了配置结果整个服务起不来」的后悔药。从那以后我每次动配置之前都先备份一份改完先跑最小验证确认没问题再往下走。希望帮到你。本文还有配套的精品资源点击获取