1. 为什么你的 openclaw skill 装了却从不触发很多人第一次接触 openclaw 的 skill 机制会下意识觉得「我把 skill 目录放进去重启一下它就该干活了」。结果跑了一晚上日志里一次 tool_call 都没有模型全程在自说自话。问题不在 skill 本身而在于 openclaw 的 skill 调用本质上是 LLM Function Calling 的一层封装——skill 是被模型「决策调用」的不是 UI 或网关直接调用的。换句话说openclaw 里的 skill 等价于一个 tool/function。它要经过 Agent Prompt 注入、LLM 判断、tool_call 返回、Skill Dispatcher 执行、结果回喂模型这一整条链路任何一环断了skill 就是死的。这条链路里最容易被忽略的不是 handler 代码而是 config.toml 里的注册与绑定以及模型侧是否真的支持 tool calling。这篇面向需要在本地接入 LLM Function Calling 的开发者把 openclaw 的 skill 调用机制拆成可落地的配置动作先给一份能直接复制的 config.toml 骨架再配 TaoToken 统一 Key/API 通道最后用一次真实调用链路验证 skill 注册与触发是否生效。适合已经装好 openclaw、但 skill 死活不触发的人。2. 前置TaoToken 统一 Key 与 API 通道openclaw 的 skill 触发依赖模型返回结构化的 tool_call所以模型必须支持 Function Calling / Tool Calling。如果你本地同时接了多个模型供应商每个供应商一套 Key、一套 base_urlconfig.toml 会变得很难维护排查 skill 不触发时也分不清是模型不支持还是配置写错。我习惯用 TaoToken 做统一通道一个 Key 走所有模型base_url 固定切换模型只改 model 字段。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册后在控制台生成 API Key。API 地址是 https://taotoken.net/api 注意这个地址不带任何查询参数直接作为 OpenAI 兼容的 base_url 使用。拿 Key 的路径进控制台 → API Keys → 新建 → 复制。这个 Key 后面会写进 config.toml 的api_key字段。如果你还没建 Key先去做这一步否则下面的配置骨架跑不起来。注意openclaw 走的是 OpenAI 兼容协议base_url 要填到/api这一层不要自己拼/v1否则会出现 404 或路径重复。3. 可复制的 config.toml 骨架openclaw 的 skill 不触发八成是 config.toml 里 agent 没绑定 skill或者 skill 的 schema 没被正确加载。下面这份骨架把模型通道、agent、skill 注册三块拆开写你可以直接改字段用。先看模型与通道部分[llm] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model gpt-4o # 必须为 true否则模型不会返回 tool_call tool_calling true temperature 0.2tool_calling true这一行是很多人漏掉的。有些客户端默认不开工具调用模型就只会输出纯文本skill 永远等不到 tool_call。再看 agent 与 skill 绑定[agents.defaults] # 关键agent 必须显式绑定 skill否则 skill 不会被注入 prompt skills [paddleocr, websearch, filesystem] system_prompt 你可以使用以下工具。当用户上传图片并要求识别文字时优先调用 paddleocr。 当用户询问实时信息时调用 websearch。 agents.defaults.skills是 skill 触发的开关。没写这一行skill 目录放得再整齐也不会被注入到模型 prompt 里模型根本不知道有这个工具存在。最后是单个 skill 的注册[[skills]] name paddleocr enabled true manifest ./skills/paddleocr/manifest.json schema ./skills/paddleocr/schema.json handler ./skills/paddleocr/handler.py对应的 schema.json 决定了模型「什么时候用」这个工具{ name: paddleocr, description: 识别图片中的中文或英文文字返回纯文本。当用户上传图片并要求提取文字时使用。, parameters: { type: object, properties: { image_url: { type: string, description: 待识别图片的本地路径或 URL } }, required: [image_url] } }description 写「OCR」和写「识别图片中的中文或英文文字返回纯文本」是两种命运。前者模型基本不会触发后者触发率明显上升。schema 里的 description 就是给模型看的「使用说明书」写得越具体tool_call 越准。4. 验证一次完整调用链路配置写完别急着上生产先用一次最小链路确认 skill 注册与触发都生效。启动 openclaw 后看启动日志里有没有 skill 加载记录openclaw start --config ./config.toml --log-level debug正常会看到类似输出[skill] loaded paddleocr (schema ok, handler ok) [agent] defaults bound skills: paddleocr, websearch, filesystem [llm] tool_calling enabled, base_urlhttps://taotoken.net/api如果loaded那行没出现说明 manifest 或 schema 路径写错如果bound skills是空的回去检查agents.defaults.skills。然后用 curl 打一次对话接口模拟用户上传图片curl -X POST http://127.0.0.1:18789/chat \ -H Content-Type: application/json \ -d { message: 帮我识别这张图片里的文字, image_url: ./test/contract.png }在 debug 日志里你要盯的是这几行是否按顺序出现[llm] - tool_call: paddleocr {image_url: ./test/contract.png} [dispatcher] executing skill: paddleocr [skill] paddleocr result: {text: 合同编号 2024-001} [llm] - final answer generated只要tool_call和executing skill两行都出现说明 skill 注册、绑定、触发、执行整条链路是通的。如果只有tool_call没有executing skill是 Dispatcher 没匹配到 skill 名如果连tool_call都没有是模型侧没开 tool calling 或 schema 没注入。5. 本篇常见错排查skill 加载了但从不触发。先查agents.defaults.skills有没有写这个 skill 名。openclaw 不会自动把目录下所有 skill 绑给 agent必须显式列出来。这是最高频的坑。模型返回纯文本而不是 tool_call。检查tool_calling true是否生效以及当前 model 是否支持 Function Calling。部分基础模型不支持工具调用换支持 tool calling 的模型即可。schema 校验失败。parameters必须是标准 JSON Schematype写objectproperties里每个参数要有type和description。少一个type就可能导致注入失败。description 太笼统。写「OCR」「搜索」这种模型判断不出使用时机。把触发场景写进 description比如「当用户上传图片并要求提取文字时使用」。base_url 拼错。TaoToken 的 API 地址是https://taotoken.net/api不要再手动加/v1。路径重复会直接 404日志里表现为模型请求失败skill 自然不触发。同一问题有时触发有时不触发。这是正常的因为 skill 调用是模型决策不是确定性调用。生产环境如果要求稳定触发可以在 openclaw 前加一层规则判断命中规则就强制走 skill再让模型总结结果。6. 继续接入与验证把上面这份 config.toml 骨架跑通后skill 调用机制基本就清楚了注册靠 config.toml触发靠 schema description执行靠 handler稳定性靠规则兜底。接下来要做的两件事一是把 Key 和通道固定下来二是把模型对话链路单独验证一遍。统一 Key 和 API 通道在控制台的 API Keys 页面管理接入文档里有 OpenAI 兼容协议的完整字段说明配 openclaw 时对照着填就行https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你想先确认模型侧到底会不会返回 tool_call不写代码也能测直接在模型对话页面发一条带工具语义的请求看返回结构https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。长期跑编码类 Agent、需要稳定 tool calling 的场景用 Coding Plan 把额度和通道固定下来更省心https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。