1. OpenClaw 插件 skill 符号链接创建失败到底卡在哪如果你在 Windows 上跑 OpenClaw看到[skills] failed to create plugin skill symlink EPERM这行日志先别急着怀疑 OpenClaw 本身崩了。这个报错的意思是Node.js 调用fs.symlink()时被 Windows 拒绝错误码EPERM: operation not permitted, symlink。换句话说OpenClaw 主服务、WebSocket、会话系统大概率都是正常的真正被卡住的只是「把 plugin skill 目录链接到~/.openclaw/plugin-skills/」这一步。OpenClaw 的 plugin skill 机制本质上是一个目录映射它希望把某个 skill比如browser-automation的真实目录通过符号链接挂载到统一的 plugin-skills 目录下这样运行时就能像访问本地目录一样加载 skill。在 Linux/macOS 上这是常规操作ln -s一行搞定但在 Windows 上普通用户默认没有创建 symlink 的权限必须开启开发者模式或以管理员身份运行否则就会直接抛 EPERM。这个问题之所以值得单独写一篇是因为它不只是「一个报错」那么简单。它背后牵扯的是 Windows 对现代 Node.js 工程生态的支持短板symlink 权限、PATH 污染、全局 npm 安装的权限混乱全都会在 OpenClaw 这类需要动态加载插件的工具上集中爆发。你如果只是临时绕过后面装 pnpm、turborepo、MCP 相关工具时还会继续踩。这篇内容面向的是已经在 Windows 上装好 OpenClaw、能正常对话但插件 skill 加载失败的人以及准备把 OpenClaw 当成长期 AI Runtime 来用、想一次性把环境理顺的人。我会按「先定位 → 再修权限 → 再换目录联接 → 最后接 TaoToken 验证模型通道」的顺序讲每一步都给可复制的命令和配置。先说结论EPERM 不是 OpenClaw 的 bug是 Windows 权限模型 Node.js symlink 调用的组合问题。解决路径有三条优先级从高到低是开启开发者模式根本解、管理员终端临时跑应急、用 junction 目录联接替代 symlink兼容解。下面逐条展开。2. TaoToken 前置统一 Key 与 API 通道让 skill 加载后能直接验证在动手修 symlink 之前先把模型接入通道准备好这样 skill 一旦加载成功你就能立刻发一条请求验证整条链路而不是修完权限发现模型又连不上白折腾一轮。TaoToken 在这里的角色是「统一 Key / API 通道」。你不需要为每个模型单独配一套 base_url 和 key而是通过一个统一的入口拿到 API Key然后在 OpenClaw 或相关工具里填同一个 Base URL 和 Model ID。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 这个不加 UTM。具体要准备三样东西我把它叫「三件套」配置项填什么说明Base URLhttps://taotoken.net/api统一 API 入口不要带多余路径API Key在控制台生成的 Key形如sk-...只显示一次记得存好Model ID你实际要用的模型标识比如claude-sonnet-4-5这类按控制台文档填拿 Key 的路径是先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进控制台在 API Keys 页面创建一个新 Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 页面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建完复制出来后面配置要用。如果你只是想先验证模型能不能通可以用模型对话页面直接测https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。这一步不依赖 OpenClaw能先确认 Key 和 Base URL 是对的。如果你后面要做长期编码或 Agent 类任务可以考虑 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置格式不确定时以文档为准。这里要强调一点TaoToken 是统一的 API 通道不是让你绕过什么而是把多个模型的接入收敛成一套配置。你修 symlink 是为了让 skill 能加载配 TaoToken 是为了让加载后的 skill 能真正调到模型。两件事分开做但要在同一次验证里合起来测。3. 可复制配置开发者模式、目录权限检查与 junction 切换这一节是全文的核心操作区。我按「先查权限 → 再开开发者模式 → 再决定用 symlink 还是 junction」的顺序给命令和配置。3.1 先确认当前 symlink 权限状态打开 PowerShell普通权限即可先看当前用户有没有创建符号链接的特权。执行whoami /priv | Select-String -Pattern SeCreateSymbolicLinkPrivilege如果输出里没有SeCreateSymbolicLinkPrivilege说明当前会话没有创建 symlink 的权限EPERM 就是必然的。如果输出了但状态是Disabled同样需要提权或开开发者模式。再看一下 OpenClaw 的 plugin-skills 目录现状$skillDir $env:USERPROFILE\.openclaw\plugin-skills Get-ChildItem $skillDir -Force | Format-Table Name, LinkType, Target -AutoSizeLinkType列会显示SymbolicLink、Junction或空。如果之前创建失败这里可能是空的或者残留了半成品目录。清理残留Remove-Item $env:USERPROFILE\.openclaw\plugin-skills\* -Recurse -Force -ErrorAction SilentlyContinue3.2 开启 Windows 开发者模式根本解路径是设置 → 系统 → 开发者选项 → 开发人员模式打开开关然后重启电脑。重启是必须的因为 symlink 权限在会话级别生效不重启可能还是旧状态。如果你习惯命令行也可以用注册表方式开启需要管理员权限New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock -Name AllowDevelopmentWithoutDevLicense -PropertyType DWORD -Value 1 -Force执行完同样重启。重启后再跑一次 3.1 的权限检查应该能看到SeCreateSymbolicLinkPrivilege处于可用状态。3.3 用 junction 替代 symlink兼容解如果你不想开开发者模式或者公司机器策略限制改不了可以用目录联接junction替代。junction 是 Windows 原生的目录映射不需要 symlink 特权普通用户就能建。先找到 skill 的真实目录比如 browser-automation skill 在D:\AI-Runtime\openclaw\skills\browser-automation然后建 junction 到 plugin-skills$target D:\AI-Runtime\openclaw\skills\browser-automation $link $env:USERPROFILE\.openclaw\plugin-skills\browser-automation New-Item -ItemType Junction -Path $link -Target $target验证Get-Item $link | Format-List Name, LinkType, TargetLinkType应该显示JunctionTarget指向真实目录。3.4 OpenClaw 配置里切换 symlink / junction 策略如果你的 OpenClaw 版本支持在配置里指定链接方式可以在配置文件里加一段。配置文件通常在~/.openclaw/config.json或项目根目录的openclaw.config.json。参考片段{ skills: { pluginSkillsDir: ~/.openclaw/plugin-skills, linkStrategy: junction, autoLink: true, skills: [ { name: browser-automation, source: D:/AI-Runtime/openclaw/skills/browser-automation, enabled: true } ] }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, modelId: claude-sonnet-4-5 } }注意linkStrategy字段名以你实际版本为准有的版本叫symlinkMode或linkType。如果不确定先查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里关于配置结构的说明或者直接看 OpenClaw 自己的 schema。如果你用的是 Codex 类的auth.json配置结构类似{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-5 }三件套Base URL Key Model ID在任何一种配置里都不能缺缺一个就会在验证阶段报 401 或 model not found。3.5 推荐的项目结构把 OpenClaw 从全局 npm 安装改成独立 workspace能大幅降低 symlink 失败概率。推荐结构D:\AI-Runtime ├── openclaw ├── dify ├── mcp ├── pnpm-store └── docker初始化方式mkdir D:\AI-Runtime\openclaw cd D:\AI-Runtime\openclaw npm init -y npm install openclaw npx openclaw这样 skill 目录、node_modules、plugin-skills 都在同一个盘符下junction 和 symlink 的路径解析都更稳定也不会污染全局 PATH。4. 验证请求skill 加载成功 模型通道打通配置改完重启 OpenClaw观察启动日志。成功的标志是这两类信息同时出现第一类skill 加载成功。日志里不再有failed to create plugin skill symlink EPERM而是类似[skills] loaded plugin skill: browser-automation [skills] plugin-skills dir ready: C:\Users\你\.openclaw\plugin-skills第二类模型通道正常。发一条最小请求验证curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回里有choices字段和正常内容说明 Key、Base URL、Model ID 三件套都对。如果返回 401检查 Key 是否复制完整如果返回 model not found检查 Model ID 拼写。再回到 OpenClaw 里触发一次用到 skill 的操作比如让 browser-automation 打开一个页面。如果 skill 正常加载且模型通道正常你会看到 skill 被调用、模型返回结果的完整链路。我实测下来最容易出问题的不是 symlink 本身而是「skill 加载了但模型没配好」或者「模型配好了但 skill 目录是空的」。所以验证一定要分两步先确认 plugin-skills 目录下有正确的链接再确认模型请求能通。检查 plugin-skills 目录Get-ChildItem $env:USERPROFILE\.openclaw\plugin-skills -Force | Format-Table Name, LinkType, Target -AutoSize应该能看到browser-automation这一项LinkType是Junction或SymbolicLinkTarget指向真实 skill 目录。如果这一步正常但 OpenClaw 日志里还是报 skill 加载失败那问题可能出在 skill 的manifest.json或入口文件路径上跟 symlink 无关了。这时候去看 skill 目录里有没有manifest.json以及main字段指向的文件是否存在。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节把实际会撞到的报错逐个对照给出定位方向。EPERM: operation not permitted, symlink这是本篇主问题。原因Windows 普通用户无 symlink 特权。解决开开发者模式 重启或改用 junction。如果开了开发者模式还报检查是不是在管理员终端里跑但环境变量没继承换个新终端重试。401 Unauthorized模型通道问题跟 symlink 无关。检查三件套Base URL 是不是https://taotoken.net/api不要多加/v1之外的路径Key 是不是完整复制注意前后空格Model ID 是不是控制台里实际存在的。如果用的是auth.json检查 JSON 格式有没有多逗号。local proxy failed这个通常出现在你本地配了代理但代理没起来或者代理地址写错。注意这里说的是本地开发环境的网络配置问题不是让你去搞什么特殊网络手段。检查你的环境变量HTTP_PROXY/HTTPS_PROXY是否指向了一个不存在的本地端口。如果不需要代理直接清掉这两个变量Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinuereading choices of undefined这个报错说明代码在解析响应时choices字段不存在。常见原因API 返回的是错误对象而不是正常响应但代码没判断状态码就直接读choices。定位方法把原始响应打出来看。用 curl 直接请求一次看返回体到底是什么。如果是 401 或 404先解决鉴权或路径问题如果返回体是正常的但字段名不对检查是不是用了 OpenAI 兼容格式之外的响应结构。OAuth 相关报错如果你用的是需要 OAuth 的接入方式报错通常出现在 token 过期或回调地址不匹配。检查你的 OAuth 配置里的 redirect URI 是否和实际一致token 是否过期。如果用的是 API Key 方式一般不会碰到 OAuth 问题。Claude Code 类工具如果走 OAuth参考接入文档里的说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。skill 加载了但调用时报 not found检查 skill 的manifest.json里name字段和你在配置里引用的名字是否一致。junction 建对了不代表 skill 元数据对。另外检查plugin-skills目录下的链接名是否和 skill 名一致不一致会导致按名查找失败。重启后 symlink 又失效如果你用的是 symlink 而不是 junction某些 Windows 更新或安全策略可能会重置权限。这种情况建议直接切 junction稳定性更好。切换方式就是删掉旧链接用 3.3 的命令重建。6. 把 OpenClaw 当长期 Runtime配置收口与后续动作修完 symlink、配好 TaoToken 之后你的 OpenClaw 应该能正常加载 plugin skill 并调用模型了。但如果你打算把它当长期 AI Runtime 用还有几件事值得做。第一把配置收口到项目目录不要散落在全局。~/.openclaw/config.json放通用配置项目目录放项目级覆盖。这样换机器或重装时迁移成本低。第二skill 目录统一放在D:\AI-Runtime\openclaw\skills\下plugin-skills 只放链接不放实体。这样备份和版本管理都清晰。第三模型通道统一走 TaoToken 的 Base URL不要在多个工具里各配一套。Coding Plan 适合长期编码任务https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。需要临时验证模型时用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。Key 管理在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第四如果你后面要接 Claude Code 类的编码工具配置格式和 OpenClaw 类似都是 Base URL Key Model ID 三件套。参考文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相关入口https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 。最后说一个我踩过的坑一开始我用全局 npm 装 OpenClawsymlink 失败后反复重装结果 PATH 里堆了好几个版本的 openclaw排查了半天才发现是 PATH 污染。后来改成独立 workspace junction一次就过了。所以如果你还在全局安装阶段建议直接切到 3.5 的目录结构能省掉后面很多莫名其妙的报错。整个链路理顺之后OpenClaw 的 plugin skill 加载、模型调用、会话管理就都能稳定跑起来了。EPERM 只是 Windows 环境的一个门槛跨过去之后剩下的就是正常使用和按需扩展 skill 了。
1. OpenClaw 插件 skill 符号链接创建失败到底卡在哪如果你在 Windows 上跑 OpenClaw看到[skills] failed to create plugin skill symlink EPERM这行日志先别急着怀疑 OpenClaw 本身崩了。这个报错的意思是Node.js 调用fs.symlink()时被 Windows 拒绝错误码EPERM: operation not permitted, symlink。换句话说OpenClaw 主服务、WebSocket、会话系统大概率都是正常的真正被卡住的只是「把 plugin skill 目录链接到~/.openclaw/plugin-skills/」这一步。OpenClaw 的 plugin skill 机制本质上是一个目录映射它希望把某个 skill比如browser-automation的真实目录通过符号链接挂载到统一的 plugin-skills 目录下这样运行时就能像访问本地目录一样加载 skill。在 Linux/macOS 上这是常规操作ln -s一行搞定但在 Windows 上普通用户默认没有创建 symlink 的权限必须开启开发者模式或以管理员身份运行否则就会直接抛 EPERM。这个问题之所以值得单独写一篇是因为它不只是「一个报错」那么简单。它背后牵扯的是 Windows 对现代 Node.js 工程生态的支持短板symlink 权限、PATH 污染、全局 npm 安装的权限混乱全都会在 OpenClaw 这类需要动态加载插件的工具上集中爆发。你如果只是临时绕过后面装 pnpm、turborepo、MCP 相关工具时还会继续踩。这篇内容面向的是已经在 Windows 上装好 OpenClaw、能正常对话但插件 skill 加载失败的人以及准备把 OpenClaw 当成长期 AI Runtime 来用、想一次性把环境理顺的人。我会按「先定位 → 再修权限 → 再换目录联接 → 最后接 TaoToken 验证模型通道」的顺序讲每一步都给可复制的命令和配置。先说结论EPERM 不是 OpenClaw 的 bug是 Windows 权限模型 Node.js symlink 调用的组合问题。解决路径有三条优先级从高到低是开启开发者模式根本解、管理员终端临时跑应急、用 junction 目录联接替代 symlink兼容解。下面逐条展开。2. TaoToken 前置统一 Key 与 API 通道让 skill 加载后能直接验证在动手修 symlink 之前先把模型接入通道准备好这样 skill 一旦加载成功你就能立刻发一条请求验证整条链路而不是修完权限发现模型又连不上白折腾一轮。TaoToken 在这里的角色是「统一 Key / API 通道」。你不需要为每个模型单独配一套 base_url 和 key而是通过一个统一的入口拿到 API Key然后在 OpenClaw 或相关工具里填同一个 Base URL 和 Model ID。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 这个不加 UTM。具体要准备三样东西我把它叫「三件套」配置项填什么说明Base URLhttps://taotoken.net/api统一 API 入口不要带多余路径API Key在控制台生成的 Key形如sk-...只显示一次记得存好Model ID你实际要用的模型标识比如claude-sonnet-4-5这类按控制台文档填拿 Key 的路径是先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进控制台在 API Keys 页面创建一个新 Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 页面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建完复制出来后面配置要用。如果你只是想先验证模型能不能通可以用模型对话页面直接测https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。这一步不依赖 OpenClaw能先确认 Key 和 Base URL 是对的。如果你后面要做长期编码或 Agent 类任务可以考虑 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置格式不确定时以文档为准。这里要强调一点TaoToken 是统一的 API 通道不是让你绕过什么而是把多个模型的接入收敛成一套配置。你修 symlink 是为了让 skill 能加载配 TaoToken 是为了让加载后的 skill 能真正调到模型。两件事分开做但要在同一次验证里合起来测。3. 可复制配置开发者模式、目录权限检查与 junction 切换这一节是全文的核心操作区。我按「先查权限 → 再开开发者模式 → 再决定用 symlink 还是 junction」的顺序给命令和配置。3.1 先确认当前 symlink 权限状态打开 PowerShell普通权限即可先看当前用户有没有创建符号链接的特权。执行whoami /priv | Select-String -Pattern SeCreateSymbolicLinkPrivilege如果输出里没有SeCreateSymbolicLinkPrivilege说明当前会话没有创建 symlink 的权限EPERM 就是必然的。如果输出了但状态是Disabled同样需要提权或开开发者模式。再看一下 OpenClaw 的 plugin-skills 目录现状$skillDir $env:USERPROFILE\.openclaw\plugin-skills Get-ChildItem $skillDir -Force | Format-Table Name, LinkType, Target -AutoSizeLinkType列会显示SymbolicLink、Junction或空。如果之前创建失败这里可能是空的或者残留了半成品目录。清理残留Remove-Item $env:USERPROFILE\.openclaw\plugin-skills\* -Recurse -Force -ErrorAction SilentlyContinue3.2 开启 Windows 开发者模式根本解路径是设置 → 系统 → 开发者选项 → 开发人员模式打开开关然后重启电脑。重启是必须的因为 symlink 权限在会话级别生效不重启可能还是旧状态。如果你习惯命令行也可以用注册表方式开启需要管理员权限New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock -Name AllowDevelopmentWithoutDevLicense -PropertyType DWORD -Value 1 -Force执行完同样重启。重启后再跑一次 3.1 的权限检查应该能看到SeCreateSymbolicLinkPrivilege处于可用状态。3.3 用 junction 替代 symlink兼容解如果你不想开开发者模式或者公司机器策略限制改不了可以用目录联接junction替代。junction 是 Windows 原生的目录映射不需要 symlink 特权普通用户就能建。先找到 skill 的真实目录比如 browser-automation skill 在D:\AI-Runtime\openclaw\skills\browser-automation然后建 junction 到 plugin-skills$target D:\AI-Runtime\openclaw\skills\browser-automation $link $env:USERPROFILE\.openclaw\plugin-skills\browser-automation New-Item -ItemType Junction -Path $link -Target $target验证Get-Item $link | Format-List Name, LinkType, TargetLinkType应该显示JunctionTarget指向真实目录。3.4 OpenClaw 配置里切换 symlink / junction 策略如果你的 OpenClaw 版本支持在配置里指定链接方式可以在配置文件里加一段。配置文件通常在~/.openclaw/config.json或项目根目录的openclaw.config.json。参考片段{ skills: { pluginSkillsDir: ~/.openclaw/plugin-skills, linkStrategy: junction, autoLink: true, skills: [ { name: browser-automation, source: D:/AI-Runtime/openclaw/skills/browser-automation, enabled: true } ] }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, modelId: claude-sonnet-4-5 } }注意linkStrategy字段名以你实际版本为准有的版本叫symlinkMode或linkType。如果不确定先查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里关于配置结构的说明或者直接看 OpenClaw 自己的 schema。如果你用的是 Codex 类的auth.json配置结构类似{ base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-5 }三件套Base URL Key Model ID在任何一种配置里都不能缺缺一个就会在验证阶段报 401 或 model not found。3.5 推荐的项目结构把 OpenClaw 从全局 npm 安装改成独立 workspace能大幅降低 symlink 失败概率。推荐结构D:\AI-Runtime ├── openclaw ├── dify ├── mcp ├── pnpm-store └── docker初始化方式mkdir D:\AI-Runtime\openclaw cd D:\AI-Runtime\openclaw npm init -y npm install openclaw npx openclaw这样 skill 目录、node_modules、plugin-skills 都在同一个盘符下junction 和 symlink 的路径解析都更稳定也不会污染全局 PATH。4. 验证请求skill 加载成功 模型通道打通配置改完重启 OpenClaw观察启动日志。成功的标志是这两类信息同时出现第一类skill 加载成功。日志里不再有failed to create plugin skill symlink EPERM而是类似[skills] loaded plugin skill: browser-automation [skills] plugin-skills dir ready: C:\Users\你\.openclaw\plugin-skills第二类模型通道正常。发一条最小请求验证curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回里有choices字段和正常内容说明 Key、Base URL、Model ID 三件套都对。如果返回 401检查 Key 是否复制完整如果返回 model not found检查 Model ID 拼写。再回到 OpenClaw 里触发一次用到 skill 的操作比如让 browser-automation 打开一个页面。如果 skill 正常加载且模型通道正常你会看到 skill 被调用、模型返回结果的完整链路。我实测下来最容易出问题的不是 symlink 本身而是「skill 加载了但模型没配好」或者「模型配好了但 skill 目录是空的」。所以验证一定要分两步先确认 plugin-skills 目录下有正确的链接再确认模型请求能通。检查 plugin-skills 目录Get-ChildItem $env:USERPROFILE\.openclaw\plugin-skills -Force | Format-Table Name, LinkType, Target -AutoSize应该能看到browser-automation这一项LinkType是Junction或SymbolicLinkTarget指向真实 skill 目录。如果这一步正常但 OpenClaw 日志里还是报 skill 加载失败那问题可能出在 skill 的manifest.json或入口文件路径上跟 symlink 无关了。这时候去看 skill 目录里有没有manifest.json以及main字段指向的文件是否存在。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节把实际会撞到的报错逐个对照给出定位方向。EPERM: operation not permitted, symlink这是本篇主问题。原因Windows 普通用户无 symlink 特权。解决开开发者模式 重启或改用 junction。如果开了开发者模式还报检查是不是在管理员终端里跑但环境变量没继承换个新终端重试。401 Unauthorized模型通道问题跟 symlink 无关。检查三件套Base URL 是不是https://taotoken.net/api不要多加/v1之外的路径Key 是不是完整复制注意前后空格Model ID 是不是控制台里实际存在的。如果用的是auth.json检查 JSON 格式有没有多逗号。local proxy failed这个通常出现在你本地配了代理但代理没起来或者代理地址写错。注意这里说的是本地开发环境的网络配置问题不是让你去搞什么特殊网络手段。检查你的环境变量HTTP_PROXY/HTTPS_PROXY是否指向了一个不存在的本地端口。如果不需要代理直接清掉这两个变量Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinuereading choices of undefined这个报错说明代码在解析响应时choices字段不存在。常见原因API 返回的是错误对象而不是正常响应但代码没判断状态码就直接读choices。定位方法把原始响应打出来看。用 curl 直接请求一次看返回体到底是什么。如果是 401 或 404先解决鉴权或路径问题如果返回体是正常的但字段名不对检查是不是用了 OpenAI 兼容格式之外的响应结构。OAuth 相关报错如果你用的是需要 OAuth 的接入方式报错通常出现在 token 过期或回调地址不匹配。检查你的 OAuth 配置里的 redirect URI 是否和实际一致token 是否过期。如果用的是 API Key 方式一般不会碰到 OAuth 问题。Claude Code 类工具如果走 OAuth参考接入文档里的说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。skill 加载了但调用时报 not found检查 skill 的manifest.json里name字段和你在配置里引用的名字是否一致。junction 建对了不代表 skill 元数据对。另外检查plugin-skills目录下的链接名是否和 skill 名一致不一致会导致按名查找失败。重启后 symlink 又失效如果你用的是 symlink 而不是 junction某些 Windows 更新或安全策略可能会重置权限。这种情况建议直接切 junction稳定性更好。切换方式就是删掉旧链接用 3.3 的命令重建。6. 把 OpenClaw 当长期 Runtime配置收口与后续动作修完 symlink、配好 TaoToken 之后你的 OpenClaw 应该能正常加载 plugin skill 并调用模型了。但如果你打算把它当长期 AI Runtime 用还有几件事值得做。第一把配置收口到项目目录不要散落在全局。~/.openclaw/config.json放通用配置项目目录放项目级覆盖。这样换机器或重装时迁移成本低。第二skill 目录统一放在D:\AI-Runtime\openclaw\skills\下plugin-skills 只放链接不放实体。这样备份和版本管理都清晰。第三模型通道统一走 TaoToken 的 Base URL不要在多个工具里各配一套。Coding Plan 适合长期编码任务https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。需要临时验证模型时用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。Key 管理在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第四如果你后面要接 Claude Code 类的编码工具配置格式和 OpenClaw 类似都是 Base URL Key Model ID 三件套。参考文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相关入口https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 。最后说一个我踩过的坑一开始我用全局 npm 装 OpenClawsymlink 失败后反复重装结果 PATH 里堆了好几个版本的 openclaw排查了半天才发现是 PATH 污染。后来改成独立 workspace junction一次就过了。所以如果你还在全局安装阶段建议直接切到 3.5 的目录结构能省掉后面很多莫名其妙的报错。整个链路理顺之后OpenClaw 的 plugin skill 加载、模型调用、会话管理就都能稳定跑起来了。EPERM 只是 Windows 环境的一个门槛跨过去之后剩下的就是正常使用和按需扩展 skill 了。
