1. 先搞清楚 ClawHub、Skills 和 CLI 到底谁管谁刚接触 OpenClaw 的朋友十有八九会被三个词绕晕ClawHub、Skills、CLI。我第一次看文档时也懵感觉它们互相引用像三个说方言的人开会。其实用一句话就能拆开ClawHub 是技能商店Skills 是货架上的商品CLI 是你手里的购物车加结账台。你逛商店、挑商品、把东西搬回家全靠 CLI 这条命令行通道完成。ClawHub 的定位是 OpenClaw 生态里的公共技能注册中心官方站点是 clawhub.ai。它做的事情和 npm registry 非常像开发者把自己写的 Skill 打包上传ClawHub 负责存储、解析元数据、分配版本号、建立索引然后让其他人能搜索到。你在终端敲clawhub search calendar背后就是 ClawHub 的索引在响应。它不执行任何技能只负责分发和版本管理这一点要记牢后面排障时能省很多时间。Skills 则是真正干活的模块。一个 Skill 本质上就是一个文件夹里面至少有一个SKILL.md描述文件说明这个技能叫什么、能做什么、需要哪些参数、依赖什么环境。除此之外可能还有脚本、配置模板、辅助代码。OpenClaw 的 Agent 运行时读取这些 Skill就相当于给 AI 装上了新的手脚能发邮件、能操作文件系统、能调第三方 API、能跑自动化流程。你可以把 OpenClaw 想成一台 AI 操作系统ClawHub 是它的应用商店Skills 就是一个个 App。CLI 是连接你和这两者的桥梁。安装、更新、删除、查看已装技能全部通过clawhub命令完成。它不负责技能逻辑只负责把 ClawHub 上的包拉到本地 OpenClaw 的技能目录并维护一份清单。理解了这个分工你再看配置文件就不会迷路CLI 的配置管的是去哪下载、用什么身份下载而 Agent 的配置管的是用哪个模型、走哪个 API 通道。这两套配置经常被新手混在一起导致后面请求一直报错。我实测下来最顺的学习路径是先跑通一次 CLI 搜索和安装确认 ClawHub 通道没问题再配置 Agent 的模型通道确认能发出请求最后把两者串起来让 Agent 调用刚装的 Skill。本文就按这个顺序走中间会给出可直接复制的settings.json和config.toml骨架以及一次真实的 CLI 验证动作。适合刚上手 OpenClaw、想快速跑通第一个 Agent 技能调用的开发者。2. 接入前的准备TaoToken 统一 Key 与 API 通道在配置 OpenClaw 之前得先解决模型通道的问题。OpenClaw 的 Agent 要调用大模型才能理解指令、规划步骤、决定调用哪个 Skill而模型调用需要一个稳定的 API 入口和一把 Key。很多新手卡在这一步要么每个模型单独申请 Key管理起来一团乱要么通道不稳定Agent 跑到一半请求就断了。我现在的做法是用 TaoToken 做统一通道。它的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的价值在于把多个模型的调用收敛到一个 Base URL 和一把 Key 上OpenClaw 的配置里只需要填一次后面换模型只改 Model ID不用动通道。对 Agent 这种需要频繁切换模型做不同任务的场景省事很多。具体要准备三样东西我把它叫做三件套第一是 Base URL。OpenClaw 走 OpenAI 兼容协议时填https://taotoken.net/api即可。注意这里不要加多余的路径后缀很多 404 就是因为手抖多写了/v1或者/chat。第二是 API Key。去控制台创建地址是 https://taotoken.net/console 。创建后立刻复制保存页面刷新后就看不到了。Key 的格式通常是一串以特定前缀开头的字符串粘贴时注意别带空格。第三是 Model ID。这个取决于你想让 Agent 用哪个模型。可以在模型对话页面先试一下地址是 https://taotoken.net/models 确认模型能正常响应再把对应的 Model ID 抄到配置里。常见的写法类似claude-sonnet-4-5这种具体以页面显示为准。如果你打算长期跑编码类或 Agent 类任务可以了解一下 Coding Plan地址是 https://taotoken.net/coding-plan 。它针对高频调用场景做了额度设计比按次计费更适合 Agent 这种会连续发很多请求的用法。我自己的 Agent 任务基本都走这个。准备阶段还有一件事确认本地 OpenClaw 版本。CLI 和 Agent 运行时的版本不匹配会导致 Skill 加载失败。在终端执行openclaw --version和clawhub --version记下两个版本号后面排障会用到。如果clawhub命令不存在说明 CLI 还没装需要先按官方文档安装 CLI 工具。3. 可复制配置settings.json 与 config.toml 骨架这一节是全文最核心的部分配置写对了后面基本一路顺。OpenClaw 生态里常见两套配置文件一套是 CLI 侧的settings.json管 ClawHub 的访问和技能安装另一套是 Agent 侧的config.toml管模型通道和运行时行为。我把两份骨架都列出来你按自己的路径替换即可。先看 CLI 侧的settings.json。它通常放在用户配置目录下Linux/macOS 一般是~/.config/clawhub/settings.jsonWindows 是%APPDATA%\clawhub\settings.json。内容如下{ registry: { url: https://clawhub.ai, timeout: 30 }, install: { targetDir: ~/.openclaw/skills, autoUpdate: false }, auth: { token: } }这里registry.url指向 ClawHub 官方注册中心install.targetDir是技能安装到本地的目录必须和 OpenClaw 运行时读取技能的目录一致否则会出现装了但 Agent 找不到的情况。auth.token留空即可浏览和安装公开技能不需要登录只有发布自己的 Skill 时才需要填。再看 Agent 侧的config.toml。它一般放在 OpenClaw 的工作目录或用户目录下比如~/.openclaw/config.toml。这份配置决定了 Agent 用哪个模型、走哪个通道[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 model_id claude-sonnet-4-5 timeout 120 max_retries 3 [agent] skills_dir ~/.openclaw/skills auto_load_skills true log_level info [agent.runtime] max_steps 20 tool_call_timeout 60几个关键点要强调。base_url必须是https://taotoken.net/api不要自作主张加/v1。api_key就是前面控制台创建的那把 Key。model_id填你在模型对话页面验证过的那个。skills_dir要和settings.json里的targetDir完全一致这是新手最容易踩的坑两个路径差一个字符Agent 就加载不到技能。如果你用的是 Codex 系的配置可能会遇到auth.json这种文件。它的结构和上面不同但三件套的逻辑一样Base URL 填https://taotoken.net/apiKey 填进去Model ID 填对应模型。Codex 的auth.json通常长这样{ openai: { base_url: https://taotoken.net/api, api_key: sk-你的Key粘贴在这里, model: claude-sonnet-4-5 } }不管哪套配置记住一个原则Base URL、Key、Model ID 这三样必须同时正确缺一个或者错一个请求都会失败。我见过太多人只改了 Key 忘了改 Base URL然后对着 401 报错查半天。配置写完后先别急着跑 Agent。用 CLI 做一次连通性检查确认 ClawHub 能访问、技能目录能写入。执行clawhub list看已安装技能列表如果返回空列表而不是报错说明 CLI 配置没问题。再执行clawhub search file搜一个技能能返回结果就说明 ClawHub 通道通了。这两步过了再进下一节做真正的请求验证。4. 验证请求一次 CLI 动作跑通首个技能调用配置写完不验证等于没配。这一节我带你走一次完整的验证流程从 CLI 安装技能到 Agent 实际调用每一步都有预期结果对不上就按第五节排查。第一步搜索并安装一个简单技能。选文件操作类的技能最稳妥因为它不依赖外部服务出错概率低。在终端执行clawhub search file预期返回一个技能列表每项包含名称、版本、简短描述。挑一个描述里带read file或list directory的记下它的名称比如file-tools。然后安装clawhub install file-tools安装成功的输出会显示下载进度和安装路径。如果卡在下载不动多半是网络或 registry 地址问题看第五节。安装完成后执行clawhub list应该能看到file-tools出现在列表里版本号和搜索结果一致。第二步确认技能目录结构。进入~/.openclaw/skills应该能看到file-tools文件夹里面至少有SKILL.md。打开SKILL.md扫一眼确认它声明的能力和你预期一致。这一步很重要因为 ClawHub 上的技能是社区上传的安装前看源码是基本习惯。重点看有没有执行不明 shell 命令、有没有访问敏感路径。第三步启动 OpenClaw Agent 并发一条指令。在终端执行openclaw run --config ~/.openclaw/config.tomlAgent 启动后会进入交互模式。输入一条简单指令比如列出当前目录下的文件。预期行为是Agent 先调用模型理解意图模型返回一个工具调用请求Agent 加载file-tools技能并执行最后把文件列表返回给你。如果一切正常你会看到类似这样的输出[agent] loading skills from ~/.openclaw/skills [agent] loaded 1 skill: file-tools [agent] model request - claude-sonnet-4-5 [agent] tool call: file-tools.list_directory [agent] result: [./README.md, ./config.toml, ./skills]看到tool call那一行就说明整条链路通了CLI 从 ClawHub 装好了技能Agent 通过 TaoToken 通道调用了模型模型决定使用技能技能执行并返回结果。这是第一个 Agent 技能调用的完整闭环。第四步做一次带参数的调用。输入读取 README.md 的前 10 行。Agent 应该调用file-tools.read_file传入路径和行数参数。这一步验证的是技能参数传递是否正常。如果返回内容正确说明技能不仅能被调用还能正确接收参数。第五步检查日志。Agent 运行时会在~/.openclaw/logs下写日志。打开最新的日志文件搜索model request和tool call确认每次请求的 Base URL 是https://taotoken.net/apiModel ID 是你配置的那个。这一步是排障的基础出问题时第一时间看日志比瞎猜快得多。整个验证流程走完大概五分钟。如果你卡在某一步别急着重装先看下一节的常见错误对照表大部分问题都能对上号。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节是我踩过的坑的汇总按报错信息分类每条给出原因和修法。你遇到问题时直接搜报错关键词即可。401 Unauthorized。这是最常见的错误原因有三个Key 没填、Key 填错、Key 过期。先检查config.toml里的api_key字段确认没有多余空格和换行。然后去控制台 https://taotoken.net/console 确认 Key 还在有效期内。如果 Key 是对的检查base_url是不是写成了https://taotoken.net/api/带了尾部斜杠某些客户端对尾部斜杠敏感去掉试试。还有一种情况是 Key 复制时漏了前缀仔细核对一遍。local proxy failed。这个报错通常出现在 Agent 启动阶段意思是本地代理连接失败。先确认config.toml里的base_url是https://taotoken.net/api没有写成localhost或127.0.0.1。如果你本地跑过其他代理工具检查环境变量HTTP_PROXY、HTTPS_PROXY有没有被设置成失效的地址用echo $HTTPS_PROXY看一下有的话清掉。另外确认网络能正常访问taotoken.net用curl -I https://taotoken.net/api测一下返回 200 或 401 都说明网络通返回超时就检查网络配置。reading choices 相关报错。完整报错通常是error reading choices或cannot read property choices of undefined。这说明请求发出去了但返回的响应结构不符合预期。原因一般是 Model ID 填错了或者 Base URL 指向了一个不兼容 OpenAI 协议的端点。检查model_id是否和模型对话页面显示的一致检查base_url是否是https://taotoken.net/api。还有一种可能是模型名称大小写问题某些客户端对大小写敏感按页面显示的原文抄。OAuth 相关报错。如果你在配置 Codex 或 Claude Code 时遇到 OAuth 报错比如OAuth token expired或OAuth flow failed说明客户端在尝试走 OAuth 认证而不是 API Key 认证。这时候要检查配置文件里是不是同时存在 OAuth 配置和 API Key 配置两者冲突。解决办法是删掉 OAuth 相关字段只保留base_url、api_key、model三件套。Codex 的auth.json里如果有多余的oauth节点一并删掉。技能装了但 Agent 找不到。这个不报错但行为异常。原因是settings.json的install.targetDir和config.toml的skills_dir不一致。用clawhub list --verbose看技能实际安装路径再和config.toml里的路径对比改成一致即可。另外确认auto_load_skills是true否则 Agent 不会自动加载。请求超时。Agent 跑长任务时容易遇到。先看config.toml里的timeout和tool_call_timeout默认值可能偏小。把timeout调到 120tool_call_timeout调到 60。如果还是超时检查是不是某个 Skill 卡住了看日志里最后一个tool call是哪个技能单独测一下那个技能。排查的核心思路是先看日志确认请求发到了哪里再看响应确认返回了什么最后对照配置找差异。大部分问题都是三件套里某一个填错了逐项核对基本能解决。6. 把 ClawHub 用顺手的几个实操建议跑通第一个技能调用之后接下来就是把它用顺。我分享几个实测下来有用的习惯。技能安装前先看SKILL.md和源码这是底线。ClawHub 是社区驱动的注册中心技能本质是可执行代码包不是安全沙盒插件。安装前至少确认三件事作者是谁、有没有 GitHub 仓库、脚本里有没有可疑的网络请求或文件删除操作。遇到自动赚钱加密货币这类技能直接跳过不要装。技能目录定期清理。clawhub list看已装技能不用的用clawhub remove 技能名删掉。技能多了会拖慢 Agent 启动时的加载速度而且每个技能都是一份潜在风险留着不用不如删掉。配置备份。settings.json和config.toml改好之后复制一份到安全位置。OpenClaw 升级时偶尔会覆盖配置有备份能快速恢复。特别是api_key丢了要重新去控制台创建。模型通道按任务切换。日常对话用轻量模型编码和 Agent 任务用能力强的模型。切换时只改config.toml里的model_idBase URL 和 Key 不动。这就是统一通道的好处换模型不用重新配通道。长期跑 Agent 任务的话Coding Plan 比按次计费划算地址是 https://taotoken.net/coding-plan 。我自己的 Agent 任务基本都走这个额度够用不用每次担心请求数。最后遇到问题先看日志再对照第五节的报错表。大部分问题都能自己解决实在搞不定再去社区搜报错关键词通常已经有人踩过同样的坑。
ClawHub 是什么？OpenClaw AI Agent 的 Skills 与 CLI 配置 TaoToken 实战
1. 先搞清楚 ClawHub、Skills 和 CLI 到底谁管谁刚接触 OpenClaw 的朋友十有八九会被三个词绕晕ClawHub、Skills、CLI。我第一次看文档时也懵感觉它们互相引用像三个说方言的人开会。其实用一句话就能拆开ClawHub 是技能商店Skills 是货架上的商品CLI 是你手里的购物车加结账台。你逛商店、挑商品、把东西搬回家全靠 CLI 这条命令行通道完成。ClawHub 的定位是 OpenClaw 生态里的公共技能注册中心官方站点是 clawhub.ai。它做的事情和 npm registry 非常像开发者把自己写的 Skill 打包上传ClawHub 负责存储、解析元数据、分配版本号、建立索引然后让其他人能搜索到。你在终端敲clawhub search calendar背后就是 ClawHub 的索引在响应。它不执行任何技能只负责分发和版本管理这一点要记牢后面排障时能省很多时间。Skills 则是真正干活的模块。一个 Skill 本质上就是一个文件夹里面至少有一个SKILL.md描述文件说明这个技能叫什么、能做什么、需要哪些参数、依赖什么环境。除此之外可能还有脚本、配置模板、辅助代码。OpenClaw 的 Agent 运行时读取这些 Skill就相当于给 AI 装上了新的手脚能发邮件、能操作文件系统、能调第三方 API、能跑自动化流程。你可以把 OpenClaw 想成一台 AI 操作系统ClawHub 是它的应用商店Skills 就是一个个 App。CLI 是连接你和这两者的桥梁。安装、更新、删除、查看已装技能全部通过clawhub命令完成。它不负责技能逻辑只负责把 ClawHub 上的包拉到本地 OpenClaw 的技能目录并维护一份清单。理解了这个分工你再看配置文件就不会迷路CLI 的配置管的是去哪下载、用什么身份下载而 Agent 的配置管的是用哪个模型、走哪个 API 通道。这两套配置经常被新手混在一起导致后面请求一直报错。我实测下来最顺的学习路径是先跑通一次 CLI 搜索和安装确认 ClawHub 通道没问题再配置 Agent 的模型通道确认能发出请求最后把两者串起来让 Agent 调用刚装的 Skill。本文就按这个顺序走中间会给出可直接复制的settings.json和config.toml骨架以及一次真实的 CLI 验证动作。适合刚上手 OpenClaw、想快速跑通第一个 Agent 技能调用的开发者。2. 接入前的准备TaoToken 统一 Key 与 API 通道在配置 OpenClaw 之前得先解决模型通道的问题。OpenClaw 的 Agent 要调用大模型才能理解指令、规划步骤、决定调用哪个 Skill而模型调用需要一个稳定的 API 入口和一把 Key。很多新手卡在这一步要么每个模型单独申请 Key管理起来一团乱要么通道不稳定Agent 跑到一半请求就断了。我现在的做法是用 TaoToken 做统一通道。它的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的价值在于把多个模型的调用收敛到一个 Base URL 和一把 Key 上OpenClaw 的配置里只需要填一次后面换模型只改 Model ID不用动通道。对 Agent 这种需要频繁切换模型做不同任务的场景省事很多。具体要准备三样东西我把它叫做三件套第一是 Base URL。OpenClaw 走 OpenAI 兼容协议时填https://taotoken.net/api即可。注意这里不要加多余的路径后缀很多 404 就是因为手抖多写了/v1或者/chat。第二是 API Key。去控制台创建地址是 https://taotoken.net/console 。创建后立刻复制保存页面刷新后就看不到了。Key 的格式通常是一串以特定前缀开头的字符串粘贴时注意别带空格。第三是 Model ID。这个取决于你想让 Agent 用哪个模型。可以在模型对话页面先试一下地址是 https://taotoken.net/models 确认模型能正常响应再把对应的 Model ID 抄到配置里。常见的写法类似claude-sonnet-4-5这种具体以页面显示为准。如果你打算长期跑编码类或 Agent 类任务可以了解一下 Coding Plan地址是 https://taotoken.net/coding-plan 。它针对高频调用场景做了额度设计比按次计费更适合 Agent 这种会连续发很多请求的用法。我自己的 Agent 任务基本都走这个。准备阶段还有一件事确认本地 OpenClaw 版本。CLI 和 Agent 运行时的版本不匹配会导致 Skill 加载失败。在终端执行openclaw --version和clawhub --version记下两个版本号后面排障会用到。如果clawhub命令不存在说明 CLI 还没装需要先按官方文档安装 CLI 工具。3. 可复制配置settings.json 与 config.toml 骨架这一节是全文最核心的部分配置写对了后面基本一路顺。OpenClaw 生态里常见两套配置文件一套是 CLI 侧的settings.json管 ClawHub 的访问和技能安装另一套是 Agent 侧的config.toml管模型通道和运行时行为。我把两份骨架都列出来你按自己的路径替换即可。先看 CLI 侧的settings.json。它通常放在用户配置目录下Linux/macOS 一般是~/.config/clawhub/settings.jsonWindows 是%APPDATA%\clawhub\settings.json。内容如下{ registry: { url: https://clawhub.ai, timeout: 30 }, install: { targetDir: ~/.openclaw/skills, autoUpdate: false }, auth: { token: } }这里registry.url指向 ClawHub 官方注册中心install.targetDir是技能安装到本地的目录必须和 OpenClaw 运行时读取技能的目录一致否则会出现装了但 Agent 找不到的情况。auth.token留空即可浏览和安装公开技能不需要登录只有发布自己的 Skill 时才需要填。再看 Agent 侧的config.toml。它一般放在 OpenClaw 的工作目录或用户目录下比如~/.openclaw/config.toml。这份配置决定了 Agent 用哪个模型、走哪个通道[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 model_id claude-sonnet-4-5 timeout 120 max_retries 3 [agent] skills_dir ~/.openclaw/skills auto_load_skills true log_level info [agent.runtime] max_steps 20 tool_call_timeout 60几个关键点要强调。base_url必须是https://taotoken.net/api不要自作主张加/v1。api_key就是前面控制台创建的那把 Key。model_id填你在模型对话页面验证过的那个。skills_dir要和settings.json里的targetDir完全一致这是新手最容易踩的坑两个路径差一个字符Agent 就加载不到技能。如果你用的是 Codex 系的配置可能会遇到auth.json这种文件。它的结构和上面不同但三件套的逻辑一样Base URL 填https://taotoken.net/apiKey 填进去Model ID 填对应模型。Codex 的auth.json通常长这样{ openai: { base_url: https://taotoken.net/api, api_key: sk-你的Key粘贴在这里, model: claude-sonnet-4-5 } }不管哪套配置记住一个原则Base URL、Key、Model ID 这三样必须同时正确缺一个或者错一个请求都会失败。我见过太多人只改了 Key 忘了改 Base URL然后对着 401 报错查半天。配置写完后先别急着跑 Agent。用 CLI 做一次连通性检查确认 ClawHub 能访问、技能目录能写入。执行clawhub list看已安装技能列表如果返回空列表而不是报错说明 CLI 配置没问题。再执行clawhub search file搜一个技能能返回结果就说明 ClawHub 通道通了。这两步过了再进下一节做真正的请求验证。4. 验证请求一次 CLI 动作跑通首个技能调用配置写完不验证等于没配。这一节我带你走一次完整的验证流程从 CLI 安装技能到 Agent 实际调用每一步都有预期结果对不上就按第五节排查。第一步搜索并安装一个简单技能。选文件操作类的技能最稳妥因为它不依赖外部服务出错概率低。在终端执行clawhub search file预期返回一个技能列表每项包含名称、版本、简短描述。挑一个描述里带read file或list directory的记下它的名称比如file-tools。然后安装clawhub install file-tools安装成功的输出会显示下载进度和安装路径。如果卡在下载不动多半是网络或 registry 地址问题看第五节。安装完成后执行clawhub list应该能看到file-tools出现在列表里版本号和搜索结果一致。第二步确认技能目录结构。进入~/.openclaw/skills应该能看到file-tools文件夹里面至少有SKILL.md。打开SKILL.md扫一眼确认它声明的能力和你预期一致。这一步很重要因为 ClawHub 上的技能是社区上传的安装前看源码是基本习惯。重点看有没有执行不明 shell 命令、有没有访问敏感路径。第三步启动 OpenClaw Agent 并发一条指令。在终端执行openclaw run --config ~/.openclaw/config.tomlAgent 启动后会进入交互模式。输入一条简单指令比如列出当前目录下的文件。预期行为是Agent 先调用模型理解意图模型返回一个工具调用请求Agent 加载file-tools技能并执行最后把文件列表返回给你。如果一切正常你会看到类似这样的输出[agent] loading skills from ~/.openclaw/skills [agent] loaded 1 skill: file-tools [agent] model request - claude-sonnet-4-5 [agent] tool call: file-tools.list_directory [agent] result: [./README.md, ./config.toml, ./skills]看到tool call那一行就说明整条链路通了CLI 从 ClawHub 装好了技能Agent 通过 TaoToken 通道调用了模型模型决定使用技能技能执行并返回结果。这是第一个 Agent 技能调用的完整闭环。第四步做一次带参数的调用。输入读取 README.md 的前 10 行。Agent 应该调用file-tools.read_file传入路径和行数参数。这一步验证的是技能参数传递是否正常。如果返回内容正确说明技能不仅能被调用还能正确接收参数。第五步检查日志。Agent 运行时会在~/.openclaw/logs下写日志。打开最新的日志文件搜索model request和tool call确认每次请求的 Base URL 是https://taotoken.net/apiModel ID 是你配置的那个。这一步是排障的基础出问题时第一时间看日志比瞎猜快得多。整个验证流程走完大概五分钟。如果你卡在某一步别急着重装先看下一节的常见错误对照表大部分问题都能对上号。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节是我踩过的坑的汇总按报错信息分类每条给出原因和修法。你遇到问题时直接搜报错关键词即可。401 Unauthorized。这是最常见的错误原因有三个Key 没填、Key 填错、Key 过期。先检查config.toml里的api_key字段确认没有多余空格和换行。然后去控制台 https://taotoken.net/console 确认 Key 还在有效期内。如果 Key 是对的检查base_url是不是写成了https://taotoken.net/api/带了尾部斜杠某些客户端对尾部斜杠敏感去掉试试。还有一种情况是 Key 复制时漏了前缀仔细核对一遍。local proxy failed。这个报错通常出现在 Agent 启动阶段意思是本地代理连接失败。先确认config.toml里的base_url是https://taotoken.net/api没有写成localhost或127.0.0.1。如果你本地跑过其他代理工具检查环境变量HTTP_PROXY、HTTPS_PROXY有没有被设置成失效的地址用echo $HTTPS_PROXY看一下有的话清掉。另外确认网络能正常访问taotoken.net用curl -I https://taotoken.net/api测一下返回 200 或 401 都说明网络通返回超时就检查网络配置。reading choices 相关报错。完整报错通常是error reading choices或cannot read property choices of undefined。这说明请求发出去了但返回的响应结构不符合预期。原因一般是 Model ID 填错了或者 Base URL 指向了一个不兼容 OpenAI 协议的端点。检查model_id是否和模型对话页面显示的一致检查base_url是否是https://taotoken.net/api。还有一种可能是模型名称大小写问题某些客户端对大小写敏感按页面显示的原文抄。OAuth 相关报错。如果你在配置 Codex 或 Claude Code 时遇到 OAuth 报错比如OAuth token expired或OAuth flow failed说明客户端在尝试走 OAuth 认证而不是 API Key 认证。这时候要检查配置文件里是不是同时存在 OAuth 配置和 API Key 配置两者冲突。解决办法是删掉 OAuth 相关字段只保留base_url、api_key、model三件套。Codex 的auth.json里如果有多余的oauth节点一并删掉。技能装了但 Agent 找不到。这个不报错但行为异常。原因是settings.json的install.targetDir和config.toml的skills_dir不一致。用clawhub list --verbose看技能实际安装路径再和config.toml里的路径对比改成一致即可。另外确认auto_load_skills是true否则 Agent 不会自动加载。请求超时。Agent 跑长任务时容易遇到。先看config.toml里的timeout和tool_call_timeout默认值可能偏小。把timeout调到 120tool_call_timeout调到 60。如果还是超时检查是不是某个 Skill 卡住了看日志里最后一个tool call是哪个技能单独测一下那个技能。排查的核心思路是先看日志确认请求发到了哪里再看响应确认返回了什么最后对照配置找差异。大部分问题都是三件套里某一个填错了逐项核对基本能解决。6. 把 ClawHub 用顺手的几个实操建议跑通第一个技能调用之后接下来就是把它用顺。我分享几个实测下来有用的习惯。技能安装前先看SKILL.md和源码这是底线。ClawHub 是社区驱动的注册中心技能本质是可执行代码包不是安全沙盒插件。安装前至少确认三件事作者是谁、有没有 GitHub 仓库、脚本里有没有可疑的网络请求或文件删除操作。遇到自动赚钱加密货币这类技能直接跳过不要装。技能目录定期清理。clawhub list看已装技能不用的用clawhub remove 技能名删掉。技能多了会拖慢 Agent 启动时的加载速度而且每个技能都是一份潜在风险留着不用不如删掉。配置备份。settings.json和config.toml改好之后复制一份到安全位置。OpenClaw 升级时偶尔会覆盖配置有备份能快速恢复。特别是api_key丢了要重新去控制台创建。模型通道按任务切换。日常对话用轻量模型编码和 Agent 任务用能力强的模型。切换时只改config.toml里的model_idBase URL 和 Key 不动。这就是统一通道的好处换模型不用重新配通道。长期跑 Agent 任务的话Coding Plan 比按次计费划算地址是 https://taotoken.net/coding-plan 。我自己的 Agent 任务基本都走这个额度够用不用每次担心请求数。最后遇到问题先看日志再对照第五节的报错表。大部分问题都能自己解决实在搞不定再去社区搜报错关键词通常已经有人踩过同样的坑。