1. 为什么我把 exec、browser、message 拆开又合起来用
如果你正在搭 AI 工作流，大概率会遇到一个很具体的麻烦：模型能聊天，但干不了活。让它查个网页，它给你一段“你可以打开浏览器访问……”；让它跑个脚本，它回你一段伪代码；让它发通知，它说“请手动复制到群里”。exec、browser、message 这三类核心工具，就是用来把“能说”变成“能做”的。
exec 负责在本机执行 Shell 命令，跑脚本、处理文件、调 Git、起服务都靠它；browser 负责控制浏览器，打开页面、点击按钮、填表单、抓内容；message 负责把结果送到飞书、Discord、Slack、钉钉、Telegram 这些地方。三者串起来，就是一条“采集 → 处理 → 通知”的自动化链路。
适合谁看？如果你写过一点 Python 或 Shell，想让 AI 帮你把重复操作接起来，这篇就是给你准备的。我试过把日报流程从手动 30 分钟压到一条指令触发，中间踩的坑基本都在下面。
真正麻烦的不是单个工具怎么调，而是调用入口太散：exec 用一套 Key，browser 又配一套，message 再配一套，换模型还得改一遍。所以这篇除了讲三个工具本身，还会讲怎么用 TaoToken 统一 Key/API 通道把入口收拢，配置片段可以直接复制。
2. TaoToken 统一调用入口：一个 Key 管住 exec/browser/message 的模型调用
先说清楚 TaoToken 在这里的角色。它不是替代 exec、browser、message 这些工具本身，而是统一这些工具背后“要调模型”的那一层。exec 要判断命令怎么写、browser 要决定点哪个元素、message 要组织卡片内容，这些都需要模型推理；如果每个工具各配一个供应商、各存一个 Key，维护成本会很高。
TaoToken 提供的是统一的 API 通道，官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api 。你只需要在配置里写一次 Base URL 和 Key，exec、browser、message 三条链路都走同一个入口。这样换模型、加额度、排查问题都只在一个地方动。
具体操作上，先去控制台建 Key。打开 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，在 API Keys 页面创建一个新 Key，复制出来。这个 Key 就是后面所有配置里填的那一个。如果你还没决定用哪个模型，可以先去模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 试一下响应速度和风格，确认合适再写进配置。
这里有个关键点：Base URL 要写成 https://taotoken.net/api ，不要带多余的路径后缀。很多 401 报错就是因为把 Base URL 写成了带 /v1 或带具体端点的形式。Key 用刚才复制的那串，Model ID 填你在模型对话里验证过的那个名称，三者必须成套出现，缺一个都会连不上。
对于长期跑编码或 Agent 任务的场景，可以考虑 Coding Plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。它的意义是把额度管理和调用入口进一步收拢，适合 exec 频繁起进程、browser 反复抓页面的高频工作流。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到参数不确定时以文档为准。
把入口统一之后，exec、browser、message 的配置里就只出现一个 Base URL 和一个 Key。下面进入具体配置。
3. 可复制配置：exec、browser、message 三件套怎么写
这一节给的是能直接抄的片段。核心原则是：Base URL、Key、Model ID 三件套在每一处都写全，不要靠“继承”或“默认值”猜。
先看环境变量文件.env，放在项目根目录：
# TaoToken 统一入口 TAOTOKEN_BASE_URL=https://taotoken.net/api TAOTOKEN_API_KEY=sk-你的Key TAOTOKEN_MODEL_ID=你的模型ID # exec 相关 EXEC_DEFAULT_TIMEOUT=30000 EXEC_WORKDIR=/path/to/project # browser 相关 BROWSER_HEADLESS=true BROWSER_PATH=/usr/bin/chromium # message 相关 FEISHU_APP_ID=cli_xxx FEISHU_APP_SECRET=xxx然后是工具集的 JSON 配置，文件名用tools.config.json：
{ "provider": { "baseUrl": "https://taotoken.net/api", "apiKey": "${TAOTOKEN_API_KEY}", "modelId": "${TAOTOKEN_MODEL_ID}" }, "tools": { "exec": { "enabled": true, "timeout": 30000, "workdir": "/path/to/project", "security": "allowlist" }, "browser": { "enabled": true, "headless": true, "browserPath": "/usr/bin/chromium" }, "message": { "enabled": true, "channels": { "feishu": { "appId": "${FEISHU_APP_ID}", "appSecret": "${FEISHU_APP_SECRET}" } } } } }如果你用的是 TOML 风格配置，等价写法如下：
[provider] base_url = "https://taotoken.net/api" api_key = "${TAOTOKEN_API_KEY}" model_id = "${TAOTOKEN_MODEL_ID}" [tools.exec] enabled = true timeout = 30000 workdir = "/path/to/project" security = "allowlist" [tools.browser] enabled = true headless = true browser_path = "/usr/bin/chromium" [tools.message] enabled = true注意security = "allowlist"这个值。它表示 exec 只执行白名单里的命令，白名单写在AGENTS.md里。这是防止误删文件的第一道闸。白名单片段：
## Command Allowlist ### Safe Commands - git status, git log, git diff - ls, pwd, cat, grep, find - python, pip install ### Elevated Commands - apt-get, docker ### Blocked Commands - rm -rf / - dd, mkfs配置写完后，检查三件事：Base URL 是不是https://taotoken.net/api，Key 是不是从控制台复制的那串，Model ID 是不是在模型对话里验证过的。三件套齐了再往下走。
4. 端到端验证：一条命令跑通采集→处理→通知
配置对不对，跑一次就知道。下面这条链路是：browser 打开一个页面抓数据，exec 跑脚本处理，message 把结果发到飞书。每一步都给可复制的调用。
第一步，browser 打开页面并抓内容：
// 打开目标页面 browser(action="navigate", url="https://example.com/list") // 等待页面加载 browser(action="act", selector="body", kind="wait", timeMs=2000) // 抓取列表项 browser(action="act", kind="evaluate", fn="() => { const items = document.querySelectorAll('.item'); return Array.from(items).map(i => ({ title: i.querySelector('.title').textContent, value: i.querySelector('.value').textContent })); }")第二步，把抓到的数据交给 exec 处理。先把上一步返回的 JSON 存成文件，再跑脚本：
# 保存抓取结果 echo '[{"title":"A","value":"1"},{"title":"B","value":"2"}]' > raw.json # 用 exec 跑处理脚本 exec(command="python process.py --input raw.json --output report.csv", workdir="/path/to/project", timeout=60000)process.py里做的是清洗和汇总，输出report.csv。这一步验证的是 exec 能不能正确读到文件、能不能在指定 workdir 下执行。
第三步，message 把结果发出去：
message(action="send", channel="feishu", target="oc_xxxxxxxx", message="日报已生成", filePath="/path/to/project/report.csv")如果三步都返回成功，说明 exec、browser、message 三条链路都通了，而且它们背后走的是同一个 TaoToken 入口。验证成功的标志是：飞书群里收到带附件的消息，附件内容和你本地report.csv一致。
想单独验证模型通道是否正常，可以去模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 发一条消息，能正常回复就说明 Key 和 Base URL 没问题。如果那边正常、这边报错，问题就在工具配置而不是通道。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
这一节按真实报错来对。遇到问题先看报错原文，再对号入座。
401 Unauthorized。最常见的原因是 Key 写错或 Base URL 写错。检查.env里的TAOTOKEN_API_KEY是不是从控制台复制的完整串，TAOTOKEN_BASE_URL是不是https://taotoken.net/api。如果 Key 没问题，去控制台 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 确认这个 Key 还在、额度没用完。三件套里 Model ID 填错有时也会表现成 401，一并检查。
local proxy failed。这个报错通常出现在 browser 或 exec 起子进程时，环境变量没传进去。解决方法是确认.env在项目根目录，且工具启动时加载了它。如果用的是 TOML 配置，检查api_key = "${TAOTOKEN_API_KEY}"这种引用有没有被正确展开。手动在终端export TAOTOKEN_API_KEY=...再跑一次，能通就说明是加载顺序问题。
reading choices 相关报错。这类报错一般是模型返回结构不符合预期，常见于 Model ID 填了一个不支持当前调用方式的模型。回到模型对话页面确认这个 Model ID 能正常对话，再写进配置。如果 exec 和 browser 用的是同一个 Model ID，但只有其中一个报错，检查那个工具的请求参数里有没有多余的字段。
OAuth 相关报错。如果你在接 Claude Code 或类似工具时看到 OAuth 字样，说明认证方式选错了。这类场景应该用 API Key 方式，Base URL 填https://taotoken.net/api，Key 填控制台创建的 Key，不要走 OAuth 流程。接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 里有对应的配置示例。
还有一个容易忽略的：exec 报“文件不存在”但文件确实在。这基本是 workdir 没指定对。在 exec 调用里显式写workdir="/path/to/project"，不要依赖默认目录。
排查顺序建议：先确认三件套（Base URL + Key + Model ID），再确认工具自身配置，最后看网络和权限。大部分问题在前两步就能定位。
6. 把入口收拢之后，工作流才真正可维护
exec、browser、message 这三个工具单独用都不难，难的是它们背后的模型调用入口散落在各处。今天换个模型要改三个地方，明天加个额度要登三个后台，这种工作流跑不长。用 TaoToken 把 Base URL 和 Key 统一之后，配置里只出现一次入口，换模型、查额度、排故障都只在一个地方动。
如果你还在选模型阶段，先去模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 试几条真实任务，确认响应和风格合适再写进配置。如果准备长期跑编码或 Agent 任务，Coding Plan 入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，适合高频调用场景。Key 在控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 创建，接入细节以文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 为准。
最后给一个实用技巧：把.env和tools.config.json一起纳入版本管理时，Key 用环境变量引用，不要写死。这样换 Key 只改.env一处，配置片段可以原样复用。
