1. openclaw 报「没有相关工具」到底卡在哪你敲下让 openclaw 创建文件的指令终端却回你一句「没有相关工具」文件纹丝不动。这个报错第一次见确实容易懵因为它听起来像是 openclaw 本身缺了某个插件但实际排查下来十有八九是两件事之一要么是工具档位tools.profile没开到位要么是底层模型通道没接对导致 openclaw 拿不到可用的工具调用能力。先把概念捋清楚。openclaw 是一个把大模型能力接到本地工作流的命令行工具它能「创建文件」「读写目录」「跑命令」靠的不是自己内置一堆硬编码逻辑而是通过模型返回的 tool call工具调用来驱动。也就是说模型得先有能力「声明我要调用 write_file 这个工具」openclaw 才能执行。如果模型通道返回的内容里根本没有工具调用结构openclaw 就会认为「没有相关工具可用」于是报错。这就解释了为什么很多人换了模型、换了 Key 之后突然就不能创建文件了。你之前用得好好的是因为那条通道支持工具调用现在换了一条不支持 tool call 的通道或者 profile 被重置成了 chat 模式工具声明就丢了。所以排查方向很明确第一确认 tools.profile 是不是 coding第二确认你接的 API 通道是否真的支持工具调用Base URL、Key、Model ID 三件套是否匹配。这篇就围绕这两条线给你一份可以直接抄的 config.toml 骨架再配上逐步验证动作让你能自己判断到底是工具缺失还是通道配置问题。适合谁看正在用 openclaw 做本地自动化、被这个报错卡住、又不想盲目重装的人。下面所有命令和配置我都实测过你照着改就行。2. TaoToken 统一 Key 通道的前置准备在动 config.toml 之前得先把「通道」这件事说清楚。openclaw 本身不生产模型能力它是个调度层真正干活的是背后的模型 API。你如果每条模型都单独配一个 Key、一个 Base URL配置会越来越乱而且一旦某条通道不支持工具调用排查起来就是灾难。TaoToken 在这里扮演的角色是统一 Key 通道你用一把 Key通过一个统一的 API 入口去访问不同的模型Base URL 固定Model ID 按需切换。对 openclaw 这种需要稳定工具调用能力的工具来说通道统一之后你只需要保证「这一把 Key 这个 Base URL 这个 Model ID」这组三件套是支持 tool call 的问题范围立刻缩小。具体要准备的东西一把 TaoToken 的 API Key在控制台的 API Keys 页面创建地址是 https://taotoken.net/api-keys 。创建后复制保存后面 config.toml 里要用。确认 Base URL 用 https://taotoken.net/api 注意这个地址不带任何查询参数直接填进配置。选一个明确支持工具调用的 Model ID。工具调用能力跟模型强相关选模型时优先挑面向 coding / agent 场景的别随手挑一个纯聊天模型否则你 profile 开成 coding 也没用模型那边不返回 tool callopenclaw 照样报「没有相关工具」。这里有个我踩过的坑一开始我以为只要 profile 设成 coding 就万事大吉结果通道那头接的是个不支持工具调用的模型openclaw 依旧报错而且报错信息一模一样完全看不出是模型的问题。后来把 Model ID 换成支持 tool call 的立刻就通了。所以「工具缺失」和「通道配置问题」这两件事表象是一样的必须靠后面的验证动作区分。如果你还没建 Key先去控制台建一个如果已经有了直接进下一步。记住三件套Base URL https://taotoken.net/api Key 你控制台里那串Model ID 支持工具调用的那个。这三个值在下面 config.toml 里会各出现一次缺一不可。3. 可复制的 config.toml 骨架与工具声明openclaw 的配置核心就是 config.toml。下面这份骨架你可以直接抄把三件套替换成自己的值即可。我把它拆成「模型通道」和「工具档位」两块方便你对照排查。# ~/.openclaw/config.toml # 模型通道统一走 TaoTokenBase URL 固定Model ID 按需换 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的支持工具调用的ModelID # 工具档位必须显式声明 coding否则创建文件类工具不会挂载 [tools] profile coding # 工具声明片段显式列出文件操作相关工具避免被默认裁剪 [tools.enabled] file_write true file_read true directory_list true shell_exec true几个关键点解释一下。provider用openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 的调用格式openclaw 走这个 provider 就能正常发请求。base_url一定填https://taotoken.net/api不要自作主张加/v1之类的后缀加了反而可能 404。model填你选定的、支持工具调用的 Model ID。[tools]这一节是重点。profile coding决定了 openclaw 挂载哪一套工具集chat 档位下文件写入类工具是不挂的这就是「没有相关工具」最常见的直接原因。[tools.enabled]是显式声明把文件读写、目录列举、命令执行这几个打开双保险。如果你更习惯用命令行改等价操作是openclaw config set tools.profile coding openclaw config set model.base_url https://taotoken.net/api openclaw config set model.api_key sk-你的TaoToken密钥 openclaw config set model.model 你的支持工具调用的ModelID改完配置必须重启 gateway否则不生效openclaw gateway restart重启后确认 profile 真的写进去了openclaw config get tools.profile输出应该是coding。如果输出是chat或者空说明你的 set 没生效检查一下是不是改错了配置文件路径或者有环境变量覆盖了它。这里再强调一次三件套的完整性Base URL、Key、Model ID 三个值必须同时正确。只改 profile 不改通道或者只换 Key 不换 Model ID都可能继续报「没有相关工具」。配置这东西缺一个都跑不起来。4. 验证请求与成功结果配置改完、gateway 重启之后别急着上复杂任务先用最小动作验证通道和工具是否都通了。第一步验证模型通道本身能通。用 curl 直接打一次 TaoToken 的接口确认 Key 和 Base URL 没问题curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的支持工具调用的ModelID, messages: [{role: user, content: 回复 ok}] }如果返回里有正常的choices内容说明通道是通的。如果这里就报 401那是 Key 的问题如果报模型不存在那是 Model ID 写错了。这一步能把「通道配置问题」单独拎出来验证。第二步验证工具调用能力。让模型尝试返回一个工具调用结构看它认不认curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的支持工具调用的ModelID, messages: [{role: user, content: 创建一个名为 test.txt 的文件}], tools: [{ type: function, function: { name: file_write, description: 写入文件, parameters: { type: object, properties: { path: {type: string}, content: {type: string} }, required: [path, content] } } }] }如果返回的choices[0].message里出现了tool_calls字段说明这条通道和这个模型确实支持工具调用openclaw 报「没有相关工具」就不是通道的锅而是 profile 或工具声明的问题。如果返回里只有普通文本、没有tool_calls那问题就锁定在模型或通道上了换一个支持工具调用的 Model ID 再试。第三步回到 openclaw 里做端到端验证。直接让它创建一个文件openclaw run 在当前目录创建一个 hello.txt内容写 hello taotoken成功的话你会看到 openclaw 打印出工具调用过程最后当前目录下真的多出一个 hello.txt。用cat hello.txt确认内容。到这一步创建文件的能力就完全恢复了。实测下来只要三件套对、profile 是 coding这个流程基本一次过。如果第三步还是报「没有相关工具」但第二步明明返回了 tool_calls那问题就在 openclaw 的 profile 或工具声明上回到第 3 节检查 config.toml。5. 本篇常见错误排查排查这类问题最有效的方式是对着真实报错逐条排除。下面这几个是我和身边人实际遇到过的按报错信息分类。报错一401 Unauthorized。这是 Key 的问题跟工具无关。检查 config.toml 里的api_key是不是复制全了有没有多余空格是不是用了已经删除的 Key。去控制台 https://taotoken.net/api-keys 重新生成一个换上。注意 Key 只在创建时显示一次没存下来就只能重建。报错二local proxy failed / connection refused。这种通常是 Base URL 写错或者本地网络到不了。确认base_url是https://taotoken.net/api没有多余路径。如果你本地配了什么转发设置先关掉再试openclaw 直连即可。报错三reading choices 相关解析错误。这类报错说明请求发出去了但返回结构 openclaw 解析不了。常见原因是 Model ID 填了一个不兼容 OpenAI 格式的模型或者通道返回了非标准结构。换成标准 chat completions 格式的 Model ID并确认 provider 是openai-compatible。报错四OAuth / 认证流程相关。如果你之前配过别的认证方式config.toml 里可能残留了 OAuth 字段跟 api_key 冲突。把[model]节里除 provider、base_url、api_key、model 之外的认证字段清掉只保留 Key 方式。报错五依旧「没有相关工具」。如果通道验证第 4 节第二步明明返回了 tool_calls但 openclaw 还是报这个那就是 profile 没生效。执行openclaw config get tools.profile确认输出是 coding如果不对重新 set 并openclaw gateway restart。还要检查有没有多个配置文件openclaw 可能读的是另一个路径下的 config.toml。关于 CC Switch / Cline MCP / Codex auth.json 这类工具如果你同时用它们接 TaoToken记住三件套要写全Base URL 填https://taotoken.net/apiKey 填你的 TaoToken 密钥Model ID 填支持工具调用的那个。任何一处缺失都会表现为「工具不可用」或「没有相关工具」本质是一样的。排查顺序建议固定成先 curl 验通道 → 再 curl 验工具调用 → 最后 openclaw 端到端。这样能快速定位是通道问题还是工具配置问题不用瞎猜。6. 把通道和工具一次配对回到最初那个报错「没有相关工具」从来不是单一原因它是「模型通道」和「工具档位」两条线任意一条断了的结果。你现在手里有了完整的排查链路config.toml 骨架保证三件套齐全profile 设成 coding 保证工具挂载curl 两步验证把通道问题和工具问题分开最后端到端跑一次确认。如果你还在选通道阶段建议直接用 TaoToken 的统一 Key 方式Base URL 固定https://taotoken.net/api一把 Key 管所有模型省得每条通道单独排查。需要建 Key 就去 https://taotoken.net/api-keys 接入细节看文档 https://taotoken.net/doc 。长期跑 coding 和 agent 任务的话Coding Plan 会更省心地址是 https://taotoken.net/coding-plan 。想先试试模型对话效果可以直接开 https://taotoken.net/chat 。配置这东西配对了一次后面就是复制粘贴。把这份 config.toml 存好下次换模型只改 Model ID 那一行其余不动报错自然就少了。
1. openclaw 报「没有相关工具」到底卡在哪你敲下让 openclaw 创建文件的指令终端却回你一句「没有相关工具」文件纹丝不动。这个报错第一次见确实容易懵因为它听起来像是 openclaw 本身缺了某个插件但实际排查下来十有八九是两件事之一要么是工具档位tools.profile没开到位要么是底层模型通道没接对导致 openclaw 拿不到可用的工具调用能力。先把概念捋清楚。openclaw 是一个把大模型能力接到本地工作流的命令行工具它能「创建文件」「读写目录」「跑命令」靠的不是自己内置一堆硬编码逻辑而是通过模型返回的 tool call工具调用来驱动。也就是说模型得先有能力「声明我要调用 write_file 这个工具」openclaw 才能执行。如果模型通道返回的内容里根本没有工具调用结构openclaw 就会认为「没有相关工具可用」于是报错。这就解释了为什么很多人换了模型、换了 Key 之后突然就不能创建文件了。你之前用得好好的是因为那条通道支持工具调用现在换了一条不支持 tool call 的通道或者 profile 被重置成了 chat 模式工具声明就丢了。所以排查方向很明确第一确认 tools.profile 是不是 coding第二确认你接的 API 通道是否真的支持工具调用Base URL、Key、Model ID 三件套是否匹配。这篇就围绕这两条线给你一份可以直接抄的 config.toml 骨架再配上逐步验证动作让你能自己判断到底是工具缺失还是通道配置问题。适合谁看正在用 openclaw 做本地自动化、被这个报错卡住、又不想盲目重装的人。下面所有命令和配置我都实测过你照着改就行。2. TaoToken 统一 Key 通道的前置准备在动 config.toml 之前得先把「通道」这件事说清楚。openclaw 本身不生产模型能力它是个调度层真正干活的是背后的模型 API。你如果每条模型都单独配一个 Key、一个 Base URL配置会越来越乱而且一旦某条通道不支持工具调用排查起来就是灾难。TaoToken 在这里扮演的角色是统一 Key 通道你用一把 Key通过一个统一的 API 入口去访问不同的模型Base URL 固定Model ID 按需切换。对 openclaw 这种需要稳定工具调用能力的工具来说通道统一之后你只需要保证「这一把 Key 这个 Base URL 这个 Model ID」这组三件套是支持 tool call 的问题范围立刻缩小。具体要准备的东西一把 TaoToken 的 API Key在控制台的 API Keys 页面创建地址是 https://taotoken.net/api-keys 。创建后复制保存后面 config.toml 里要用。确认 Base URL 用 https://taotoken.net/api 注意这个地址不带任何查询参数直接填进配置。选一个明确支持工具调用的 Model ID。工具调用能力跟模型强相关选模型时优先挑面向 coding / agent 场景的别随手挑一个纯聊天模型否则你 profile 开成 coding 也没用模型那边不返回 tool callopenclaw 照样报「没有相关工具」。这里有个我踩过的坑一开始我以为只要 profile 设成 coding 就万事大吉结果通道那头接的是个不支持工具调用的模型openclaw 依旧报错而且报错信息一模一样完全看不出是模型的问题。后来把 Model ID 换成支持 tool call 的立刻就通了。所以「工具缺失」和「通道配置问题」这两件事表象是一样的必须靠后面的验证动作区分。如果你还没建 Key先去控制台建一个如果已经有了直接进下一步。记住三件套Base URL https://taotoken.net/api Key 你控制台里那串Model ID 支持工具调用的那个。这三个值在下面 config.toml 里会各出现一次缺一不可。3. 可复制的 config.toml 骨架与工具声明openclaw 的配置核心就是 config.toml。下面这份骨架你可以直接抄把三件套替换成自己的值即可。我把它拆成「模型通道」和「工具档位」两块方便你对照排查。# ~/.openclaw/config.toml # 模型通道统一走 TaoTokenBase URL 固定Model ID 按需换 [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的支持工具调用的ModelID # 工具档位必须显式声明 coding否则创建文件类工具不会挂载 [tools] profile coding # 工具声明片段显式列出文件操作相关工具避免被默认裁剪 [tools.enabled] file_write true file_read true directory_list true shell_exec true几个关键点解释一下。provider用openai-compatible是因为 TaoToken 的 API 兼容 OpenAI 的调用格式openclaw 走这个 provider 就能正常发请求。base_url一定填https://taotoken.net/api不要自作主张加/v1之类的后缀加了反而可能 404。model填你选定的、支持工具调用的 Model ID。[tools]这一节是重点。profile coding决定了 openclaw 挂载哪一套工具集chat 档位下文件写入类工具是不挂的这就是「没有相关工具」最常见的直接原因。[tools.enabled]是显式声明把文件读写、目录列举、命令执行这几个打开双保险。如果你更习惯用命令行改等价操作是openclaw config set tools.profile coding openclaw config set model.base_url https://taotoken.net/api openclaw config set model.api_key sk-你的TaoToken密钥 openclaw config set model.model 你的支持工具调用的ModelID改完配置必须重启 gateway否则不生效openclaw gateway restart重启后确认 profile 真的写进去了openclaw config get tools.profile输出应该是coding。如果输出是chat或者空说明你的 set 没生效检查一下是不是改错了配置文件路径或者有环境变量覆盖了它。这里再强调一次三件套的完整性Base URL、Key、Model ID 三个值必须同时正确。只改 profile 不改通道或者只换 Key 不换 Model ID都可能继续报「没有相关工具」。配置这东西缺一个都跑不起来。4. 验证请求与成功结果配置改完、gateway 重启之后别急着上复杂任务先用最小动作验证通道和工具是否都通了。第一步验证模型通道本身能通。用 curl 直接打一次 TaoToken 的接口确认 Key 和 Base URL 没问题curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的支持工具调用的ModelID, messages: [{role: user, content: 回复 ok}] }如果返回里有正常的choices内容说明通道是通的。如果这里就报 401那是 Key 的问题如果报模型不存在那是 Model ID 写错了。这一步能把「通道配置问题」单独拎出来验证。第二步验证工具调用能力。让模型尝试返回一个工具调用结构看它认不认curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的支持工具调用的ModelID, messages: [{role: user, content: 创建一个名为 test.txt 的文件}], tools: [{ type: function, function: { name: file_write, description: 写入文件, parameters: { type: object, properties: { path: {type: string}, content: {type: string} }, required: [path, content] } } }] }如果返回的choices[0].message里出现了tool_calls字段说明这条通道和这个模型确实支持工具调用openclaw 报「没有相关工具」就不是通道的锅而是 profile 或工具声明的问题。如果返回里只有普通文本、没有tool_calls那问题就锁定在模型或通道上了换一个支持工具调用的 Model ID 再试。第三步回到 openclaw 里做端到端验证。直接让它创建一个文件openclaw run 在当前目录创建一个 hello.txt内容写 hello taotoken成功的话你会看到 openclaw 打印出工具调用过程最后当前目录下真的多出一个 hello.txt。用cat hello.txt确认内容。到这一步创建文件的能力就完全恢复了。实测下来只要三件套对、profile 是 coding这个流程基本一次过。如果第三步还是报「没有相关工具」但第二步明明返回了 tool_calls那问题就在 openclaw 的 profile 或工具声明上回到第 3 节检查 config.toml。5. 本篇常见错误排查排查这类问题最有效的方式是对着真实报错逐条排除。下面这几个是我和身边人实际遇到过的按报错信息分类。报错一401 Unauthorized。这是 Key 的问题跟工具无关。检查 config.toml 里的api_key是不是复制全了有没有多余空格是不是用了已经删除的 Key。去控制台 https://taotoken.net/api-keys 重新生成一个换上。注意 Key 只在创建时显示一次没存下来就只能重建。报错二local proxy failed / connection refused。这种通常是 Base URL 写错或者本地网络到不了。确认base_url是https://taotoken.net/api没有多余路径。如果你本地配了什么转发设置先关掉再试openclaw 直连即可。报错三reading choices 相关解析错误。这类报错说明请求发出去了但返回结构 openclaw 解析不了。常见原因是 Model ID 填了一个不兼容 OpenAI 格式的模型或者通道返回了非标准结构。换成标准 chat completions 格式的 Model ID并确认 provider 是openai-compatible。报错四OAuth / 认证流程相关。如果你之前配过别的认证方式config.toml 里可能残留了 OAuth 字段跟 api_key 冲突。把[model]节里除 provider、base_url、api_key、model 之外的认证字段清掉只保留 Key 方式。报错五依旧「没有相关工具」。如果通道验证第 4 节第二步明明返回了 tool_calls但 openclaw 还是报这个那就是 profile 没生效。执行openclaw config get tools.profile确认输出是 coding如果不对重新 set 并openclaw gateway restart。还要检查有没有多个配置文件openclaw 可能读的是另一个路径下的 config.toml。关于 CC Switch / Cline MCP / Codex auth.json 这类工具如果你同时用它们接 TaoToken记住三件套要写全Base URL 填https://taotoken.net/apiKey 填你的 TaoToken 密钥Model ID 填支持工具调用的那个。任何一处缺失都会表现为「工具不可用」或「没有相关工具」本质是一样的。排查顺序建议固定成先 curl 验通道 → 再 curl 验工具调用 → 最后 openclaw 端到端。这样能快速定位是通道问题还是工具配置问题不用瞎猜。6. 把通道和工具一次配对回到最初那个报错「没有相关工具」从来不是单一原因它是「模型通道」和「工具档位」两条线任意一条断了的结果。你现在手里有了完整的排查链路config.toml 骨架保证三件套齐全profile 设成 coding 保证工具挂载curl 两步验证把通道问题和工具问题分开最后端到端跑一次确认。如果你还在选通道阶段建议直接用 TaoToken 的统一 Key 方式Base URL 固定https://taotoken.net/api一把 Key 管所有模型省得每条通道单独排查。需要建 Key 就去 https://taotoken.net/api-keys 接入细节看文档 https://taotoken.net/doc 。长期跑 coding 和 agent 任务的话Coding Plan 会更省心地址是 https://taotoken.net/coding-plan 。想先试试模型对话效果可以直接开 https://taotoken.net/chat 。配置这东西配对了一次后面就是复制粘贴。把这份 config.toml 存好下次换模型只改 Model ID 那一行其余不动报错自然就少了。
