1. OpenClaw 装 Skill 失败先别急着重装OpenClaw 的 Skill 机制是它最像「插件系统」的地方装一个glm-web-search就能联网搜索装一个cron-scheduler就能跑定时任务。但很多人第一次装 Skill 就卡住报错五花八门——Skill not found、Permission denied or access outside allowed path、Assertion failed: new_time loop-time看着像玄学其实绝大多数都落在四个点上ClawHub 没装、fs.allow-path白名单没放行、Node.js 版本太低、ClawHub 源拉不动。这篇不堆概念直接按「报错现象 → 原因 → 可复制命令 → 怎么验证修好了」的顺序走一遍。适合正在本地搭 AI 工具链、被 OpenClaw Skill 安装卡住的同学。你不需要从头读遇到哪个报错就跳到对应小节命令复制过去改路径即可。装 Skill 之前建议先把下面这套环境自检跑一遍能省掉一半来回试错的时间。openclaw -v node -v openclaw config list | grep fs.allow openclaw skills list这四条分别看OpenClaw 版本、Node 版本、当前文件访问白名单、已装 Skill 列表。哪条报错或输出不对基本就锁定问题区了。2. 装 Skill 前先把 TaoToken 这条链路配通Skill 装好只是第一步很多 Skill尤其是联网搜索、代码执行类真正跑起来要靠模型能力。我自己的做法是模型侧统一走 TaoToken这样 Skill 调用模型时不用每个都单独配 Key换模型也只改一处。TaoToken 的定位是模型 API 聚合入口兼容 OpenAI 风格的调用方式对 OpenClaw 这类工具链比较友好。你需要先去控制台拿一个 API Key地址是 https://taotoken.net/api-keys 拿到后模型对话调试可以在 https://taotoken.net/models 里直接试确认 Key 和模型名对得上再去配 OpenClaw。如果你后面要长期跑编码类、Agent 类 Skill可以看下 Coding Planhttps://taotoken.net/coding-plan 比按量调用更适合高频场景。接入文档在 https://taotoken.net/doc 配置字段和报错码都能查到。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 第一次接触可以先从模型对话页熟悉调用格式。注意TaoToken 是正常的模型 API 服务入口配置时只填 API 地址和 Key不要在里面塞任何来路不明的转发地址。3. 可复制配置config.toml 与 settings.json 骨架OpenClaw 的配置分两层全局的config.toml管文件访问白名单、ClawHub 源这些Skill 自己的settings.json管这个 Skill 用哪个模型、传什么参数。下面两份骨架可以直接抄路径按你自己的改。先看config.toml重点是fs.allow-path和 ClawHub 源# ~/.openclaw/config.toml [fs] # 白名单Skill 只能访问这些目录多个用逗号分隔 allow-path /root/.openclaw/workspace,/root/.openclaw/skills [clawhub] # 默认官方源国内拉不动时换成镜像 mirror https://clawhub.openclaw.dev # mirror https://mirror.aliyun.com/clawhub/ [model] # 模型侧统一走 TaoToken base-url https://taotoken.net/api api-key sk-你的TaoToken密钥 default-model gpt-4o-minifs.allow-path是新手最容易踩的坑。新版本 OpenClaw 默认只允许访问白名单目录你的 Skill 装在~/.openclaw/skills但白名单里只有 workspace就会报access outside allowed path。开发测试环境图省事可以设成*但生产环境一定只放必要目录。再看某个 Skill 的settings.json以联网搜索类 Skill 为例{ name: glm-web-search, enabled: true, model: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: gpt-4o-mini }, options: { maxResults: 5, timeout: 15000 } }改完配置别急着装 Skill先让 OpenClaw 重新读一遍openclaw config reload openclaw config list | grep fs.allow第二条命令的输出里allow-path应该和你写的一致。如果还是旧值说明配置文件路径不对用openclaw config path确认它到底读的哪个文件。4. 逐项验证从 ClawHub 到 Skill 真正跑起来配置对了接下来按顺序验证每一步都有明确的成功标志别跳步。第一步确认 ClawHub 装了。ClawHub 是 OpenClaw 的技能市场没它就像去超市没办卡npm install -g clawhub # 或者 pnpm add -g clawhub clawhub initclawhub init成功会输出初始化完成失败多半是 Node 版本或权限问题往下看第 5 节。第二步装一个 Skill 试水clawhub search web-search clawhub install glm-web-search openclaw skills listopenclaw skills list里能看到glm-web-search且状态是 enabled就说明装上了。如果列表里没有回到fs.allow-path检查 Skill 目录在不在白名单。第三步验证 Skill 真能调用模型。这一步最容易「装上了但用不了」。直接跑一次openclaw run glm-web-search --query 今天有什么AI新闻成功的话会返回搜索结果摘要。如果报模型相关错误八成是settings.json里的baseUrl或apiKey不对。你可以先用 curl 单独验证 TaoToken 这条链路通不通curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里有choices字段就说明 Key 和地址没问题问题在 OpenClaw 的 Skill 配置层。这一步能把「模型侧问题」和「Skill 侧问题」彻底分开省很多瞎猜。5. 本篇常见错排查fs.allow-path、Node 版本、ClawHub 源把最常见的几类报错集中列一下对照着改。报错一Error: Skill not found原因通常是 ClawHub 没装或没 init。先clawhub init再clawhub search 关键词确认能搜到。搜不到就是源的问题换镜像openclaw config set clawhub.mirror https://mirror.aliyun.com/clawhub/报错二Permission denied or access outside allowed path这是fs.allow-path白名单没放行。开发环境临时放开openclaw config set fs.allow-path *生产环境只放必要目录openclaw config set fs.allow-path /root/.openclaw/workspace,/root/.openclaw/skills改完openclaw config reload再openclaw skills list看 Skill 是否恢复可用。报错三Assertion failed: new_time loop-time这是 Node.js 版本不兼容的典型信号OpenClaw 要求 Node 22 及以上。用 nvm 管理版本最省事curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node -vnode -v输出 v22.x 就对了。注意nvm use只对当前终端生效要持久化得nvm alias default 22。报错四Request timeout or network errorClawHub 源拉不动。除了换镜像也可以手动 clone 到 Skill 目录cd ~/.openclaw/skills git clone https://github.com/xxx/xxx-skill.git openclaw skills list手动装的 Skill 同样要确保目录在fs.allow-path白名单里否则装上了也调不了。报错五Error: Tool ripgrep not found某些 Skill 依赖外部命令行工具缺啥装啥# Ubuntu/Debian sudo apt-get install ripgrep # macOS brew install ripgrep报错六EACCES: permission denied全局安装权限问题别硬用 sudo改 npm 全局目录更干净mkdir ~/.npm-global npm config set prefix ~/.npm-global export PATH$PATH:$HOME/.npm-global/bin排查完可以跑一次安全审计看有没有遗漏openclaw security audit6. 装完 Skill 之后模型侧怎么接更省心Skill 装好、fs.allow-path放行、Node 升到 22这三步做完OpenClaw 的 Skill 安装基本不会再卡。剩下的就是模型侧怎么接。我的习惯是模型统一走 TaoTokenSkill 的settings.json里只填一次baseUrl和 Key后面加新 Skill 直接复用不用每个都去翻密钥。如果你只是偶尔跑几个 Skill用模型对话页调试就够了https://taotoken.net/models 。如果要长期跑编码类、Agent 类 Skill按量调用容易超预算可以看 Coding Planhttps://taotoken.net/coding-plan 。所有配置字段和报错码在接入文档里都能查到https://taotoken.net/doc 。Key 在控制台管理https://taotoken.net/api-keys 。最后留一个我踩过的坑改完config.toml一定要openclaw config reload我有一次改完白名单没 reload折腾了半小时以为配置写错了其实只是没生效。装 Skill 报错时先跑第 1 节那四条自检命令八成问题当场就定位了。
