企业官网建设流程全解析

1. OpenClaw 飞书 Bot 配置为什么总卡在 WebSocket 长连接

如果你正在折腾 OpenClaw 的飞书 Bot，大概率会遇到一个很典型的现象：飞书开放平台那边事件订阅已经选了「使用长连接接收事件」，OpenClaw 这边channels add也跑完了，但机器人就是不回消息。日志里要么是feishu ws connecting之后没有下文，要么直接抛websocket closed before handshake，再或者网关起来了、渠道也 enabled 了，可飞书后台一直提示「长连接未建立」。

这个场景的核心矛盾在于：飞书 Bot 的 WebSocket 长连接是「飞书服务端主动推事件」的通道，它和普通的 HTTP 回调不一样，不需要你暴露公网地址，但要求客户端在启动时用 App ID / App Secret 换取一个临时的长连接地址，然后保持心跳。OpenClaw 作为客户端，需要同时满足三件事——渠道配置正确、网关进程活着、鉴权通道能正常拿到模型响应。前两件是飞书侧的事，第三件就是 TaoToken 统一 Key 要解决的问题。

我试过把这三件事拆开单独调，结果发现大部分「长连接失败」其实不是飞书的问题，而是 OpenClaw 在收到事件后调用模型时鉴权失败，导致整个 provider 被标记为 not ready，长连接被连带断开。所以这篇补充内容会围绕「配置文件骨架 + TaoToken 统一 Key 接入 + WebSocket 连通性验证 + 报错对照」四块来讲，目标是让你照着复制就能跑通。

适合谁看：已经在 OpenClaw 里加过飞书渠道、但卡在长连接或模型鉴权环节的人；以及想用一套统一 Key 同时喂给 OpenClaw、CC Switch、Cline 的开发者。

2. TaoToken 前置：统一 Key 与 API 通道准备

OpenClaw 的飞书 Bot 在收到im.message.receive_v1事件后，会把消息内容交给配置好的模型 provider 去生成回复。如果你用的是多家模型、多个 Key，配置会散落在openclaw.json、环境变量、CC Switch、Cline 各处，排错时根本不知道是哪一层鉴权挂了。TaoToken 的作用就是把这些入口收敛成一个统一 Key 和一个 API 通道。

你需要先拿到两样东西：

第一是统一 Key。登录 TaoToken 控制台，在 API Keys 页面创建一个 Key，建议按用途命名，比如openclaw-feishu，方便后面在日志里区分。创建后立刻复制保存，页面刷新后不再完整显示。

第二是 API 通道地址。TaoToken 的 API 入口是https://taotoken.net/api，注意这个地址不带任何查询参数，直接作为 base URL 使用。OpenClaw 里配置 provider 时，base URL 填这个，Key 填上面创建的。

注意：不要把 Key 写进会提交到 Git 的配置文件里。OpenClaw 支持从环境变量读取，优先用环境变量方式。

如果你还想在浏览器里先验证模型通道是否通，可以直接用模型对话页面发一条测试消息，确认 Key 有额度、通道能返回。这一步能省掉后面很多「到底是飞书问题还是模型问题」的纠结。

对于长期跑编码和 Agent 任务的场景，Coding Plan 会比按量更划算，后面在 CC Switch 和 Cline 里也会用到同一个 Key，统一管理的好处在这里体现得最明显。

3. 可复制配置：config.toml / settings.json / CC Switch / Cline 骨架

OpenClaw 的配置分两层：一层是渠道层（飞书 App ID / Secret / 连接模式），一层是模型 provider 层（TaoToken 的 base URL 和 Key）。下面给出可直接复制的骨架，你只需要替换cli_xxx、xxx和 Key。

3.1 OpenClaw 渠道配置骨架

先看openclaw.json里飞书渠道的部分。关键字段是connectionMode必须是websocket，否则飞书后台的长连接不会生效：

{ "channels": { "feishu": { "enabled": true, "appId": "cli_xxx", "appSecret": "xxx", "connectionMode": "websocket", "allowFrom": [ "feishu:ou_xxx" ], "groupPolicy": "allowlist", "groupAllowFrom": [ "feishu:oc_xxx" ] } } }

如果你更习惯命令行，等价操作是：

openclaw config set channels.feishu.appId "cli_xxx" openclaw config set channels.feishu.appSecret "xxx" openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.connectionMode websocket

3.2 TaoToken provider 配置（config.toml 风格）

OpenClaw 的 provider 配置可以用 TOML 风格表达，核心是 base URL 指向 TaoToken 的 API 入口，Key 从环境变量注入：

[providers.taotoken] type = "openai-compatible" base_url = "https://taotoken.net/api" api_key_env = "TAOTOKEN_API_KEY" default_model = "claude-sonnet-4-5" timeout_seconds = 120

然后在启动网关前导出环境变量：

export TAOTOKEN_API_KEY="你的统一Key" openclaw gateway start

3.3 CC Switch 配置片段

CC Switch 用来在多个模型配置间切换，把 TaoToken 作为一个 profile 加进去：

{ "profiles": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "${TAOTOKEN_API_KEY}", "model": "claude-sonnet-4-5" } }, "active": "taotoken" }

3.4 Cline 配置片段

Cline 的settings.json里，把 provider 设为 OpenAI Compatible，base URL 填 TaoToken 的 API 入口：

{ "cline.apiProvider": "openai", "cline.openAiBaseUrl": "https://taotoken.net/api", "cline.openAiApiKey": "${TAOTOKEN_API_KEY}", "cline.openAiModelId": "claude-sonnet-4-5" }

这样 OpenClaw、CC Switch、Cline 三处共用同一个 Key 和同一个通道，排错时只需要验证一次通道是否通。

4. 验证请求与成功结果：WebSocket 连通性怎么确认

配置写完不代表长连接就通了。飞书的长连接建立过程分三步：OpenClaw 用 App ID / Secret 向飞书换取长连接地址、建立 WebSocket、发送心跳并等待事件。任何一步失败，日志都会给出不同关键词。

4.1 启动网关并跟踪日志

openclaw gateway start openclaw logs --follow

成功时你会看到类似这样的连续输出：

feishu ws connecting feishu ws connected feishu provider ready

这三行缺一不可。如果只有第一行，说明换取长连接地址失败，通常是 App ID / Secret 错误或权限没加。如果前两行都有、第三行没有，说明长连接建立了但 provider 没就绪，八成是模型鉴权通道的问题，回到第 3.2 节检查 TaoToken Key。

4.2 用飞书发消息做端到端验证

在飞书里找到你的机器人，发一条「你好」。第一次会返回一个带 Pairing code 的消息，这是正常的配对流程：

openclaw pairing approve feishu XXX

把XXX换成实际 code。配对通过后再发一条消息，如果机器人正常回复，说明「飞书长连接 → OpenClaw → TaoToken 通道 → 模型 → 回复」整条链路通了。

4.3 单独验证 TaoToken 通道

如果机器人不回消息，先别怀疑飞书，直接验证模型通道：

curl -X POST "https://taotoken.net/api/v1/chat/completions" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "messages": [{"role": "user", "content": "ping"}] }'

返回里有choices字段就说明通道正常。这一步能把「飞书问题」和「模型鉴权问题」彻底分开。

5. 本篇常见错排查：WebSocket 报错对照表

下面这张表是我在实际配置里遇到过的报错，按日志关键词对照处理。建议排错时先看日志最后一行，再回表定位。

几个容易忽略的点：飞书开放平台改完权限后必须重新创建版本并发布，否则权限不生效；connectionMode如果写成webhook，长连接根本不会建立；TaoToken 的 base URL 末尾不要多加/v1，OpenClaw 和 Cline 会自己拼路径。

如果排障过程中需要确认 Key 状态或重新生成，去 API Keys 页面操作；接入细节和参数说明可以对照接入文档；想先在浏览器里验证模型是否可用，用模型对话最直接。

6. 把统一 Key 用在长期编码与 Agent 场景

飞书 Bot 跑通之后，你大概率会想把它扩展到更多场景：比如让机器人在群里做代码审查、接 Cline 做本地补全、或者用 CC Switch 在不同模型间切换。这时候统一 Key 的价值就出来了——你不需要为每个工具单独申请和轮换 Key，改一处即可全局生效。

对于长期跑编码和 Agent 任务的场景，Coding Plan 的额度模型比按量更适合，尤其是 OpenClaw 这种会持续接收飞书事件、频繁调用模型的用法。把 OpenClaw、CC Switch、Cline 都指向同一个 TaoToken 通道后，排错路径也收敛成一条：先 curl 验证通道，再看 OpenClaw 日志，最后查飞书权限。这套顺序能帮你把大部分「长连接失败」在五分钟内定位到具体层。