clawdbot无痛升级openclaw，飞书变个人AI助理保姆级教程：TaoToken统一Key接入与config.toml配置实战

1. 从 clawdbot 到 openclaw飞书助理升级到底卡在哪clawdbot 改名 openclaw 之后旧版本已经不再维护很多人卡在“想升级又怕把原来能跑的飞书机器人搞挂”这一步。openclaw 能做什么简单说它把原来 clawdbot 的飞书接入能力保留下来同时补上了 WebUI 可视化配置、插件化技能apple-notes、apple-reminders、github、camsnap、imsg、clawhub 等并且把模型通道抽象成 provider 配置。适合谁已经在本机或小主机上跑过 clawdbot、想让飞书变成 24 小时个人 AI 助理的开发者尤其是希望用统一 Key 管理多家模型、不想在多个配置文件里来回改 baseUrl 的人。升级真正的痛点不在安装而在三件事旧进程没停干净导致端口占用旧插件目录和新版内置插件冲突配置里的路径占位符没替换成真实用户名导致EACCES: permission denied。这篇就按“先停旧、再装新、再统一 Key、最后验证飞书回调”的顺序走一遍配置骨架可以直接复制把里面的凭证换成你自己的即可。全程围绕 openclaw 的config.toml/openclaw.json、飞书 websocket 长连接、WebUI 和 TaoToken 统一 Key 展开跟着做就能让升级后的助理正常响应。2. 前置准备TaoToken 统一 Key 与 openclaw 环境在动配置之前先把“大脑”的入口准备好。openclaw 支持多种 provider我建议用 TaoToken 作为统一 API 通道好处是一个 Key 就能覆盖对话、编码、Agent 等场景后面换模型只改 model id不用动 baseUrl 和鉴权逻辑。你需要先去控制台拿一个 API Key再确认要用的模型名。拿 Key 的路径进入控制台后创建 API Key复制保存。注意 Key 只在创建时完整显示一次丢了就重新建一个。接入文档里有各语言的最小请求示例配置前扫一眼能少踩很多坑。控制台创建/管理 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishuAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishuAPI 基地址不加 UTMhttps://taotoken.net/api环境侧确认两件事Node 版本要 22否则 openclaw 安装脚本里的依赖会报错飞书那边要有一个自建应用拿到 App ID 和 App Secret并开启机器人能力。飞书应用的事件订阅方式选长连接websocket这样本机不用暴露公网端口回调验证也简单。项目建议值说明Node22 LTS 及以上低于此版本安装脚本可能失败飞书连接模式websocket本机无需公网回调地址模型通道TaoToken 统一 Key一个 Key 覆盖多模型网关端口18789默认值冲突可改工作目录/Users/$(whoami)/clawd用命令自动填真实用户名3. 可复制配置停旧、装新、写 Key、配飞书3.1 停掉并卸载旧 clawdbot升级第一步永远是让旧服务“下班”否则进程占用会让你怀疑人生。先停网关再全局卸载旧包。clawdbot gateway stop npm uninstall -g clawdbot如果clawdbot gateway stop提示命令不存在说明旧服务可能已经没在跑直接执行卸载即可。卸载完可以用which clawdbot确认一下没有输出就干净了。3.2 安装 openclaw 并确认版本官方提供一键脚本会自动处理 Node 依赖。装完立刻验版本确认不是残留的旧二进制。curl -fsSL https://openclaw.ai/install.sh | bash openclaw --version看到类似2026.2.9的输出就说明基础环境就绪。如果版本号明显偏旧检查一下 PATH 里是不是还有旧的全局 bin 目录排在前面。3.3 写入配置骨架把 TaoToken Key 填进去这一步是核心。openclaw 的配置里provider 的baseUrl指向 TaoToken 的 API 地址apiKey填你刚创建的 Keyapi字段用openai-completions兼容模式。下面这段可以直接复制注意把占位符换成真实值。cat EOF ~/.openclaw/openclaw.json { meta: { lastTouchedVersion: 2026.2.9 }, auth: { profiles: { taotoken:default: { provider: taotoken, mode: api_key } } }, models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoTokenAPIKEY, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5 } ] } } }, agents: { defaults: { model: { primary: taotoken/claude-sonnet-4-5 }, workspace: /Users/$(whoami)/clawd, compaction: { mode: safeguard }, maxConcurrent: 4 } }, channels: { feishu: { enabled: true, appId: 你的飞书AppID, appSecret: 你的飞书Secret, connectionMode: websocket, groupPolicy: open } }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: admin123 } }, plugins: { entries: {} } } EOF几个关键点单独说清楚。workspace里的/Users/$(whoami)/clawd会在执行时自动展开成真实用户名千万别手写成中文“你的用户名”否则系统真的会去/Users/下创建一个叫“你的用户名”的目录然后因为权限不足直接崩。gateway.auth.token是本地 WebUI 的登录令牌默认admin123建议改掉。groupPolicy: open表示群聊里也响应只想私聊可以改成closed。注意apiKey、appId、appSecret三处必须替换成真实凭证其余保持原样即可。模型 id 按你实际要用的填TaoToken 侧支持的模型名以接入文档为准。3.4 清理旧飞书插件并启用内置插件新版 openclaw 已经内置飞书插件旧的插件文件夹必须删干净否则会报插件冲突或重复注册。rm -rf ~/.openclaw/extensions/feishu openclaw plugins enable feishu删完再启用顺序不要反。如果先启用再删可能把新插件的注册信息一起删掉又得重来一遍。3.5 挂载系统服务并重启网关这一步是很多人翻车的地方。配置改完后不要直接openclaw gateway start那样会提示Gateway service not loaded。正确姿势是先install做系统登记再restart。openclaw gateway install openclaw gateway restart openclaw status --allstatus --all里如果能看到Feishu | ON | OK | configured这一行说明 openclaw 的“耳朵”已经张开飞书长连接建立成功。4. 验证请求从 WebUI 到飞书回调配置写完不算完得实际验证链路通不通。分两层验证先验模型通道再验飞书回调。4.1 验证 TaoToken 模型通道先用最小请求确认 Key 和 baseUrl 没问题。openclaw 本身有对话入口也可以直接用 curl 打 TaoToken 的兼容接口。curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoTokenAPIKEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字通了}] }返回里有正常的choices内容说明 Key、baseUrl、模型名三者匹配。如果返回 401检查 Key 是否复制完整返回 404检查 baseUrl 是不是写成了带多余路径的地址。4.2 验证 WebUI 与网关浏览器打开http://127.0.0.1:18789用配置里的gateway.auth.token登录。WebUI 能正常加载、能看到 agent 和 channel 状态说明网关本身没问题。这一步能快速把“网关问题”和“飞书问题”分开。4.3 验证飞书回调在飞书里给机器人发一条消息比如“帮我记个笔记”。同时开一个终端跟日志openclaw logs --follow正常情况你会看到消息进入、模型调用、回复发出的完整链路。飞书侧收到回复日志里没有EACCES或Dispatch报错就说明升级完成。如果飞书没反应但日志显示消息已收到多半是模型通道或 agent 配置的问题回到 4.1 再验一次。5. 本篇常见错排查5.1 Gateway service not loaded现象执行openclaw gateway start提示服务未加载。原因是没做系统登记就直接启动。解决先openclaw gateway install再openclaw gateway restart。这个顺序不能省否则网关不会带着新配置跑起来飞书那边永远是断联状态。5.2 EACCES: permission denied, mkdir /Users/你的用户名这是升级里最典型的硬伤。现象是日志反复报权限错误飞书消息到了本机但机器人处理不了。原因是配置里直接写了中文占位符系统真的尝试在/Users/下创建这个目录。解决确保配置里的 workspace 写成/Users/$(whoami)/clawd让 shell 自动展开成真实用户名。已经写错的重新执行 3.3 的写入命令覆盖即可。5.3 飞书插件冲突或重复响应现象是机器人回复两次或者启动时报插件已存在。原因是旧插件目录没删干净。解决rm -rf ~/.openclaw/extensions/feishu后重新openclaw plugins enable feishu再重启网关。5.4 模型返回 401 / 404401 一般是 Key 不对或没带Bearer前缀404 多半是 baseUrl 写错注意 TaoToken 的 API 基地址是https://taotoken.net/api兼容接口路径由 openclaw 按openai-completions模式拼接不要手动在 baseUrl 里再加/v1。模型名要和 TaoToken 侧实际支持的 id 一致写错会返回模型不存在。5.5 端口 18789 被占用现象是网关起不来日志提示 address already in use。先确认旧 clawdbot 进程是否真的停了lsof -i :18789看一下占用进程。确认无用后 kill 掉或者把配置里的gateway.port改成其他值再重启。6. 升级完成后把 Key 和通道固定下来走到这里clawdbot 到 openclaw 的迁移基本收尾旧服务停干净、新版本装好、TaoToken 统一 Key 写进 provider、飞书长连接建立、WebUI 能登录、日志能看到完整消息链路。后面要做的就是把这套配置固定成习惯——模型换的时候只改models.providers.taotoken.models里的 idKey 轮换时只改apiKey一处飞书凭证变动只动channels.feishu。这样升级不再是“重装一遍”而是改几行配置的事。如果你还想继续扩展可以在 WebUI 里勾选 apple-notes、apple-reminders、github、camsnap、imsg 这些技能让飞书助理从“能聊天”变成“能干活”。长期跑编码或 Agent 任务的话用 Coding Plan 会比按次调用更省心只是想先验证模型效果直接进模型对话页试几句最快。模型对话验证模型效果https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishuCoding Plan长期编码/Agenthttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishuAPI Keys排障/接入https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu最后留一个我踩过的坑改完配置一定要openclaw gateway restart只改文件不重启网关还是跑旧配置你会以为飞书坏了其实只是没生效。