企业官网建设流程全解析

OpenClaw 的早报没发出来。它没有报错崩溃，cron 到点照样触发，脚本跑完安静退出，只有日志末尾留了一行401 invalid api key。我第一反应是把 Base URL 补成带/v1的完整路径，结果 401 变成了 404，问题从「钥匙不对」升级成「门牌号不对」。这篇记录的就是把 OpenClaw 的模型通道换到 TaoToken 的完整过程：Key 从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建，Base URL 写 https://taotoken.net/api 并且末尾不带/v1、不带 UTM 参数。把这两件事做对，401 和 404 会同时消失，而 Exa 检索、Milvus 复盘、Skill 规则这些原有环节一行都不用动。

1. OpenClaw 早报静默失败：日志里先冒出来的是 401

1.1 一次典型的排障现场

那天早上七点半没收到早报，我先去看logs/agent.log，最后二十行是这样的：

[07:30:01] morning_brief start [07:30:01] exa search ok, 12 items [07:30:02] skill rules loaded [07:30:03] llm request failed: 401 invalid api key [07:30:03] morning_brief aborted

注意中间两行：Exa 检索是成功的，Skill 规则也加载完了。真正断掉的只有调模型那一步。这个顺序很关键，它说明问题被精准地框在「provider 配置」这个小范围里，而不是整个 agent 挂了。很多人一看到早报没出来就去重装依赖、升级框架版本、检查 cron 表达式，方向全错。日志里工具调用成功、模型调用失败，等于已经把病灶指给你了。

1.2 401 和多余的 /v1 经常一起出现

我见过两种改坏的方式。第一种是 Key 本身失效或者复制时带上了引号、空格、换行，服务端解析不出来，返回 401。第二种更隐蔽：Base URL 原本写的是不带/v1的根地址，SDK 自己会在后面拼/v1/chat/completions；有人手动把/v1补进 Base URL，结果请求路径变成/api/v1/v1/chat/completions，服务端找不到这个路由，回 404。

更麻烦的是这两件事会互相掩盖。你以为是 Key 的问题，换了一把又一把，其实地址早就拼错了；你以为是地址的问题，改了半天路径，Key 里那个多余的换行还在。所以排障一定要分两步走，先确认地址形态，再确认 Key 有效性，别混在一起试。

2. 拆开盯盘 agent 的请求链：哪些环节根本不用改

2.1 Exa 检索走 Exa 自己的 Key

盯盘 agent 每天要做的事可以拆成几块：拉取外部信息、召回历史复盘、套用规则、让模型组织语言。第一块靠的是 Exa，它有自己的 API Key 和自己的 endpoint，跟模型通道完全是两条线。你把模型 Base URL 换成 https://taotoken.net/api 之后，Exa 那边不需要做任何改动，它的 Key 该放哪还放哪。

这一点想清楚能省很多时间。我最初把 401 归咎于「配置整体乱了」，甚至去检查 Exa 的额度，纯属浪费。日志里exa search ok那行已经明确告诉你它是好的。

2.2 Milvus 复盘与 Skill 规则也不碰模型地址

Milvus 负责把历史复盘向量存下来、按相似度召回。它连的是自己的向量库地址，用的是自己的连接参数。Skill 规则更简单，多数情况下就是一堆本地 YAML 或者 Markdown 文件，读进来拼进 prompt 而已。这两块和模型 provider 没有耦合。

所以本章的结论其实很短：盯盘 agent 里真正需要改的，只有「向模型发起请求」那一段配置。它通常躺在两个地方之一——项目根目录的.env，或者config/agent.yaml里的 provider 段。改之前先确认你的版本读的是哪一个，别只改了一处就急着跑。

3. 把模型通道换成 TaoToken：Key、Base URL、模型 ID 三件套

3.1 在官网创建 Key 并把模型 ID 抄下来

先打开 TaoToken，注册登录后进控制台创建一把 API Key。创建完立刻复制，整串粘进配置文件，不要手动敲，也不要在前后留空格和引号。同一把 Key 可以同时给对话测试和 OpenClaw 用，方便对照。

接着去模型广场看当前可用的模型 ID。这里有个坑：模型列表会变，别人三个月前博客里写的 ID 未必还在。所以配置里我统一写YOUR_MODEL_ID，你实际填的时候，把模型广场上那个 ID 原样复制过来，注意大小写和连字符。以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场当时列表为准，比抄任何教程都可靠。

3.2 agent.yaml 里改 provider 段

OpenClaw 的模型通道一般写在config/agent.yaml的 provider 段。不同小版本的字段名可能略有差异，但核心就三样：地址、Key、模型。改完大致长这样：

# config/agent.yaml provider: name: taotoken base_url: https://taotoken.net/api api_key: YOUR_API_KEY model: YOUR_MODEL_ID timeout: 60 agents: morning_brief: model: YOUR_MODEL_ID tools: [exa_search, milvus_recall, skill_rules] intraday_alert: model: YOUR_MODEL_ID tools: [exa_search, skill_rules]

注意base_url那一行：写到https://taotoken.net/api就停，末尾既不要补/v1，也不要带任何查询参数。SDK 会自己把/v1/chat/completions拼上去。你多写一段，它就多拼一段。

3.3 .env 版本的位置同步

如果你用的版本是从环境变量读配置，那就改项目根目录的.env：

# .env OPENCLAW_PROVIDER=taotoken OPENAI_API_KEY=YOUR_API_KEY OPENAI_BASE_URL=https://taotoken.net/api OPENCLAW_MODEL=YOUR_MODEL_ID

两个地方同时存在的项目不少，尤其是从旧版本升级上来的。判断办法很简单：把.env里的 Key 临时改成明显错误的字符串，跑一次任务，如果报错内容变了，说明它读的是.env；如果毫无变化，说明读的是agent.yaml。改对之后别忘了把 Key 换回来。

3.4 Base URL 为什么只能写到 /api

很多工具会把 Base URL 当成「父路径」来处理，请求时自己补具体路由。你写https://taotoken.net/api，它补成https://taotoken.net/api/v1/chat/completions；你写https://taotoken.net/api/v1，它补成https://taotoken.net/api/v1/v1/chat/completions。后者就是那个 404 的来源。

还有一点容易忽略：不要往 Base URL 上挂 UTM 参数。UTM 是给页面统计用的，挂在接口地址上会被当成路径的一部分，轻则参数被忽略，重则路由匹配失败。官网落地页该带 UTM 就带，接口地址保持干净。

4. 改完先别急着开盯盘：三步验证

4.1 一条最小请求把通道验通

先别跑完整 agent，用一条最小请求确认通道。下面这条 curl 是手写完整路径，所以这里出现/v1是正常的，跟「Base URL 不要带 /v1」不矛盾：

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "YOUR_MODEL_ID", "messages": [{"role": "user", "content": "ping"}] }'

返回里带正常的choices结构，说明 Key 和模型 ID 都对。如果这里就 401，别往下走，先回 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 重新生成一把 Key，整串复制，再试一次。

4.2 手跑一次 morning_brief

通道通了，再手动触发一次早报任务：

python -m openclaw.run --task morning_brief --no-schedule

看日志的三行：exa search ok应该还在，skill rules loaded应该还在，llm request failed那一行应该消失，换成模型返回的内容。如果 Exa 那行反而没了，说明你误改了别的配置块，把它改回去。

4.3 回控制台核对调用记录

早报发出来之后，回 TaoToken 控制台看一眼调用记录，确认这次请求记上了账。这一步常被跳过，但它的价值在于：日志里说成功了，控制台里也有记录，两边对得上，才算真的通了。如果控制台里没有，那说明请求其实没走这条路，可能还有一份旧配置在生效。

5. 401 反复出现时的对照排查

5.1 报错与成因对照表

这张表基本覆盖了 OpenClaw 模型配置里九成的报错。注意第一行和第三行的区别：401 是身份问题，模型 ID 错了通常不会给你 401，而是明确告诉你模型不存在。分清楚这一点，改起来就不会乱。

5.2 改完不生效的几种情况

第一，进程没重启。OpenClaw 如果是常驻进程，配置文件改了它也读不到，得重启服务或者新开一个终端再跑。第二，虚拟环境装了两份，你改的是 A 目录的.env，实际跑的是 B 目录的代码。用pwd和which python确认一下当前工作目录。第三，有系统级环境变量覆盖了项目配置，echo $OPENAI_BASE_URL看一眼，不是空的就先清掉再试。

还有一种情况是 Key 本身没问题、地址也没问题，但账户侧额度用尽了，这时候报错往往不是 401 而是别的状态码。遇到不认识的返回，先去控制台看用量，比在本地反复改配置快得多。

6. 盯盘 agent 继续跑，下一步去哪里

早报和盘中警报恢复正常之后，建议立刻做一件事：用同一把 Key 在 TaoToken 模型对话 里发一条消息，确认模型 ID 和地址都写对了，再把这条记录跟 OpenClaw 日志里的时间点对一下。两边时间对得上，以后排查就有参照物。

如果盯盘 agent 是每天定时跑、早报盘中复盘都覆盖，额度消耗会比偶尔试一次高不少，可以去 Coding Plan 看看套餐是否够用。需要新增或轮换 Key，直接在 控制台 API Keys 里操作。想把这套配置沉淀成模板，Claude Code 接入文档 里的环境变量写法也能当参考，省的字段名下次再记一遍。