1. OpenClaw 是什么从安装到 Telegram 对话的完整链路拆解OpenClaw 是一个可以把大模型能力接到即时通讯工具里的开源机器人框架你可以把它理解成一个「中间人」一边连着模型 API一边连着 Telegram、Notion 这类你日常在用的工具。你在 Telegram 里发一句话它调用模型生成回复再回到 Telegram 里显示给你。整个过程跑在你自己的机器上配置和数据都归你管。它适合谁如果你满足下面任意一条这篇内容就对你有用想让 AI 帮你在 Telegram 里回答问题、整理资料但不想依赖某个封闭平台手里有多个模型服务商的 Key想统一管理不想每换一个模型就改一遍配置想把 Notion 当知识库让机器人帮你读写文档对 Node.js 有一点了解能照着命令敲但不想从源码开始啃。我实测下来OpenClaw 的安装本身不复杂真正容易卡住的地方有三个Node.js 版本不对导致 npm 装不上、Telegram Bot Token 填错位置、模型 API Key 的 Base URL 没配对。这篇会把这三处都拆开讲清楚并且用 TaoToken 的统一 Key 来管理模型调用凭证省去你到处找各家 Key 的麻烦。先说清楚整体链路你心里有个地图准备 Node.js 环境版本要够新拿到模型调用的凭证这里用 TaoToken 统一 Key在 Telegram 找 BotFather 创建机器人拿到 Bot Token安装 OpenClaw 并跑配置向导启动服务在 Telegram 里发消息完成配对验证模型回复正常再按需接入 Notion。每一步我都会给出可复制的命令和配置片段。你不需要一次性全做完可以先把「安装 Telegram 对话」这条最短路径跑通再回头加 Notion 这类扩展。关于模型凭证传统做法是去 OpenAI、Anthropic、Google 各家分别注册、分别拿 Key、分别填配置。模型一多配置文件里一堆不同格式的 Key换环境时特别容易漏。TaoToken 的思路是提供一个统一的 API 通道你只维护一个 Key 和一个 Base URL模型 ID 在请求里指定就行。对 OpenClaw 这种需要频繁切换模型的场景能省不少事。下面第二节会具体讲怎么拿这个 Key。2. TaoToken 前置准备统一 Key 与 API 通道怎么配这一节解决「模型调用凭证从哪来」的问题。OpenClaw 支持多种模型服务商但如果你每个都单独配配置文件会变得很长而且不同服务商的接口格式、鉴权方式不完全一样。用 TaoToken 的统一通道你只需要记住两个东西一个 Base URL一个 API Key。先拿 Key。打开 TaoToken 的控制台进入 API Keys 页面创建一个新的 Key。创建时给它起个能认出来的名字比如openclaw-test方便以后区分。创建完把 Key 复制下来格式通常是一串以特定前缀开头的字符串。这个 Key 只显示一次建议先存到密码管理器里。控制台地址在这里https://taotoken.net/console 。如果你还没账号先注册再进控制台。拿到 Key 之后你需要知道两件事Base URLhttps://taotoken.net/api注意这个地址不带任何查询参数配置里就填这个Model ID具体用哪个模型在请求里指定比如gpt-4o、claude-sonnet-4-20250514这类标识。OpenClaw 的配置向导里会让你选模型提供商。如果你走 TaoToken 统一通道本质上是用一个兼容 OpenAI 接口格式的端点所以提供商那一项可以选 OpenAI 兼容模式不同版本叫法可能略有差异认准「自定义 Base URL」或「OpenAI Compatible」这类选项。然后在 Base URL 处填https://taotoken.net/apiAPI Key 处填你刚创建的那个 Key。这里有个容易踩的坑Base URL 到底要不要带/v1。很多兼容接口的完整路径是https://xxx/v1/chat/completions但配置项里填的 Base URL 有时只需要到域名加/api具体拼路径由客户端负责。TaoToken 的 API 地址是https://taotoken.net/api你在 OpenClaw 里就填这个不要自己再加/v1否则可能拼成/api/v1/v1/...导致 404。如果填完报 404第一件事就是检查这里有没有多写。为了让你有个直观对照我把关键配置项列成表格配置项填写内容说明ProviderOpenAI Compatible / 自定义认准兼容模式Base URLhttps://taotoken.net/api不要额外加/v1API Key控制台创建的 Key只显示一次注意保存Model ID如gpt-4o按需选择请求时指定如果你更习惯用配置文件而不是交互向导OpenClaw 一般会在用户目录下生成一个配置文件常见是~/.openclaw/config.json或类似路径具体以你安装的版本为准。你可以直接编辑它把模型相关的字段改成上面这套。改完记得重启服务让配置生效。关于模型选择我的建议是先用一个你熟悉的、响应稳定的模型把链路跑通确认 Telegram 能收到回复之后再换其他模型做对比。不要一上来就配一堆模型出问题时你分不清是配置错了还是模型本身的问题。另外提醒一句API Key 属于敏感凭证不要提交到 Git 仓库也不要贴在公开的聊天记录里。如果你在多人共用的机器上配置注意文件权限别让其他用户能读到你的配置文件。3. 可复制配置Node.js 环境、OpenClaw 安装与 Telegram 接入这一节是动手部分从环境准备一路做到 Telegram 对话。命令都可以直接复制但请按顺序执行每一步确认结果再往下走。3.1 Node.js 与 npm 环境准备OpenClaw 要求 Node.js 版本在 v22.x 以上。先检查你当前的版本node -v npm -v如果node -v输出的是 v20 或更低需要升级。推荐用 nvm 管理 Node 版本这样不会污染系统自带的 Node# 安装 nvm如果还没装 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 重新加载 shell 配置 source ~/.bashrc # 安装并使用 Node 22 nvm install 22 nvm use 22 nvm alias default 22装完再跑一次node -v确认输出是 v22 开头。npm 会随 Node 一起装好不用单独处理。这里有个细节如果你用的是 macOS 且通过 Homebrew 装过 Node可能会有多个版本共存which node能告诉你当前用的是哪个。确保 nvm 管理的版本优先级更高否则你nvm use 22之后新开终端又变回旧版本。3.2 安装 OpenClaw环境确认没问题后全局安装 OpenClawsudo npm install -g openclawlatest如果你用 nvm 管理 Node通常不需要sudo直接npm install -g openclawlatest即可。加sudo反而可能因为权限问题把包装到系统目录导致后面命令找不到。装完验证一下openclaw --version能输出版本号就说明安装成功。如果提示command not found检查 npm 的全局 bin 目录有没有在 PATH 里可以用npm bin -g看路径。3.3 启动配置向导运行交互式配置openclaw onboard --install-daemon--install-daemon会把 OpenClaw 注册成后台服务开机自启。如果你只想临时跑一下可以去掉这个参数。进入向导后按提示一步步选。关键节点如下确认风险连接输入yes启动模式选QuickStart模型提供商选 OpenAI 兼容 / 自定义Base URL填https://taotoken.net/apiAPI Key填你在 TaoToken 控制台创建的 Key具体模型填你要用的 Model ID比如gpt-4o连接笔记可选直接回车跳过默认模型选Keep current选择频道选TelegramTelegram Token填你在 BotFather 拿到的 Token。3.4 Telegram Bot 创建在 Telegram 里搜索BotFather发送/newbot按提示给机器人起名。名字必须以bot结尾且不能和已有的重复。创建成功后BotFather 会返回一段 Token格式类似123456:ABC-DEF...。把这段 Token 复制下来填到上一步的向导里。3.5 配置文件片段参考如果你跳过向导直接改配置文件模型部分大致长这样字段名以你安装版本为准这里给的是结构参考{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, modelId: gpt-4o }, channels: { telegram: { enabled: true, botToken: 你的_Telegram_Bot_Token } } }注意baseUrl就是https://taotoken.net/api不要画蛇添足加/v1。apiKey和botToken是两个不同的东西别填反了前者是模型调用凭证后者是 Telegram 机器人身份。3.6 启动与配对配置完成后启动服务openclaw start然后去 Telegram 找到你创建的机器人随便发一句话。机器人会回复一个配对码。回到终端执行openclaw pairing approve telegram code把code换成机器人给你的那串码。配对成功后再在 Telegram 发消息就应该能收到模型生成的回复了。4. 验证请求确认 Telegram 对话与模型调用都通了配置跑完不代表真的通了得实际验证。这一节给你一套从简到繁的验证步骤每一步都有明确的预期结果出问题时也方便定位。第一步验证 OpenClaw 服务在跑。执行openclaw status正常会显示服务运行状态、当前使用的模型、已连接的频道。如果显示 stopped用openclaw start启动再看日志有没有报错。第二步验证模型通道。在 Telegram 里给机器人发一句简单的话比如「你好用一句话介绍你自己」。预期是几秒内收到回复。如果长时间没反应先看终端日志openclaw logs --follow日志里如果出现401说明 API Key 有问题回去检查 TaoToken 控制台里的 Key 是否复制完整、有没有多余空格。如果出现404大概率是 Base URL 拼错了确认是不是多写了/v1。如果出现reading choices之类的解析错误通常是返回格式和客户端预期不一致检查模型 ID 是否写对。第三步验证多轮对话。连续发几条消息看机器人能不能记住上下文。有些配置默认不保留历史如果你需要多轮记忆得在配置里开启会话保持。这一步能帮你确认不只是「单次请求能通」而是「对话状态正常」。第四步验证模型切换。如果你想确认 TaoToken 统一通道确实能换模型可以在配置里把 Model ID 从gpt-4o改成另一个重启服务再发消息。回复风格或内容有明显变化说明切换生效。这一步不是必须但能帮你建立对通道的信任。第五步可选验证 Notion。如果你配了 Notion让机器人试着创建一个文档比如「帮我在 Notion 里新建一页标题是测试」。然后去 Notion 对应页面看有没有生成。如果没生成八成是 Integration 权限没 Share 给目标页面回到 Notion 的页面设置里把 Integration 加进去。验证通过的标准很简单你在 Telegram 发消息机器人用你配置的模型回复内容合理多轮对话不串。到这一步最短链路就算跑通了。顺便说一个我踩过的坑有时候 Telegram 里机器人没反应但日志显示请求成功。这种情况多半是 Telegram 那边的 webhook 或长轮询没配好检查一下网络能不能正常访问 Telegram 的 API。如果你在受限网络环境里这一步可能会卡住需要先解决网络连通性。5. 常见报错排查401、404、local proxy failed 与 OAuth 问题这一节把最常见的几类报错集中处理。你遇到问题时先在这里对号入座能省不少搜索时间。401 Unauthorized。这是鉴权失败出现在模型调用或 Telegram 接入两个环节。如果是模型调用报 401检查 TaoToken 的 API Key有没有复制完整、有没有过期、有没有在控制台被禁用。如果是 Telegram 报 401检查 Bot Token 是否正确注意 Token 里有个冒号别漏了。还有一种情况是 Key 填对了但前面多了Bearer前缀有些客户端会自动加你手动再加就重复了。404 Not Found。最常见的原因是 Base URL 拼错。TaoToken 的地址是https://taotoken.net/api如果你写成https://taotoken.net/api/v1客户端可能再拼一次/v1变成/api/v1/v1/chat/completions自然 404。解决办法就是只填https://taotoken.net/api。另外确认一下 Model ID 是不是写错了不存在的模型也可能返回 404 或类似错误。local proxy failed。这个报错通常和网络代理配置有关。如果你本机设置了 HTTP_PROXY 或 HTTPS_PROXY 环境变量OpenClaw 可能会尝试走代理但代理不可用就会报这个。检查一下echo $HTTP_PROXY echo $HTTPS_PROXY如果有值且你不需要代理可以临时清掉unset HTTP_PROXY unset HTTPS_PROXY然后重启 OpenClaw。注意这里说的是本机环境变量层面的配置不是让你去搭什么通道只是排查环境变量干扰。OAuth 相关报错。如果你在配置向导里选了 OAuth 认证方式比如某些模型的 CLI OAuth但浏览器回调失败或 token 过期会报 OAuth 错误。最简单的办法是改用 API Key 方式也就是走 TaoToken 统一通道填 Base URL 和 Key绕开 OAuth 流程。OAuth 适合个人本地用但在服务器或无人值守环境里容易出问题。reading choices 解析错误。这个报错说明客户端拿到了响应但结构里没有它预期的choices字段。常见原因是模型返回了错误信息比如额度不足、模型不存在但客户端按成功响应去解析。解决办法是看完整日志里的原始响应体确认模型 ID 和账户状态。如果用的是兼容接口确认返回格式确实是 OpenAI 格式。Telegram 配对码无效。配对码有时效性过期了就得重新发消息获取。另外确认你执行openclaw pairing approve telegram code时code替换成了实际码尖括号不要带进去。排查的通用思路是先看日志再对号入座最后最小化验证。所谓最小化验证就是用最简单的请求确认单个环节。比如模型通道你可以直接用 curl 测一下curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer 你的_TaoToken_Key \ -H Content-Type: application/json \ -d {model:gpt-4o,messages:[{role:user,content:hi}]}如果这条能返回正常结果说明 Key 和 Base URL 没问题问题在 OpenClaw 配置如果这条也报错那就是凭证或地址本身的问题。这样能把问题范围缩小一半。6. 把 OpenClaw 用起来统一 Key 管理与后续扩展链路跑通之后你可以开始考虑怎么把它用得顺手。这一节聊几个实际使用中的经验以及后续可以扩展的方向。先说凭证管理。OpenClaw 支持多模型如果你每个模型都单独配 Key配置文件会越来越乱。用 TaoToken 统一通道的好处是你只需要维护一个 Key 和一个 Base URL换模型时只改 Model ID 这一处。这在多环境部署时尤其明显开发机、测试机、家里的机器配置结构完全一样只是 Key 可能不同。建议把配置里的敏感字段抽出来用环境变量注入而不是硬编码在文件里。比如export TAOTOKEN_API_KEY你的_Key然后在配置里引用这个变量。这样配置文件可以进版本控制Key 不会泄露。再说模型选择策略。不同模型适合不同任务有的擅长长文本理解有的响应快适合闲聊有的在代码任务上更强。你可以给 OpenClaw 配多个模型按场景切换。比如日常问答用一个响应快的整理文档时换成逻辑能力强的。切换方式就是改 Model ID不用动其他配置。关于 Notion 接入前面提过权限 Share 这个坑。再补充一点Notion Integration 的权限是页面级的你 Share 了哪个页面它就只能访问哪个页面。如果你希望机器人能读写多个页面得逐个 Share或者把目标页面放在一个父页面下Share 父页面。这个设计是为了安全但初次配置时容易忘。Telegram 这边你可以给机器人设置命令菜单让常用操作更顺手。在 BotFather 里用/setcommands配置比如加一个/new用来开新会话。这样在 Telegram 里输入斜杠就能看到提示不用记命令。后续扩展方向OpenClaw 的 Skills 机制可以让你接入更多工具。配置向导里问你要不要配 Skills 时如果你有需求可以选上。常见的扩展包括语音转文字、图片生成、定时任务等。定时任务特别实用比如让它每天早上把某类信息整理好发到 Telegram。配置方式一般是在 Skills 里定义触发条件和执行动作具体语法看对应 Skill 的文档。最后给一个实用建议先把最短链路用稳再逐步加功能。很多人一上来就想把所有扩展都配上结果某个环节出问题排查起来牵一发动全身。正确的节奏是Telegram 对话稳定运行几天确认没有偶发故障再加 NotionNotion 用顺了再加定时任务。每加一个功能都回到验证步骤确认一遍。如果你在配置过程中卡在某个报错优先看日志里的原始信息再对照第五节的排查清单。大部分问题都出在 Base URL 多写了路径、Key 复制不完整、Telegram Token 填错位置这三处。把这三处确认一遍能解决八成以上的问题。