1. 零基础搭建 OpenClaw 与飞书机器人从环境准备到消息收发跑通OpenClaw 是一个开源的 AI 助手框架支持飞书、钉钉、企业微信等多个平台接入。你可以把它理解成一个“消息中枢”飞书里发来的消息经过 OpenClaw 的 Gateway 转发给大模型模型生成回复后再原路返回飞书。适合想给自己或团队做一个私有 AI 助手的开发者也适合零基础但愿意跟着命令一步步操作的新手。我这次的目标很明确在 Windows 11 上装好 OpenClaw接上飞书自建应用把模型请求统一改到 TaoToken 的兼容接口最后在飞书里发一条消息确认机器人能正常回复。整个过程大约 30 分钟不含飞书审核等待时间。下面每一步都给出可复制的命令和配置片段你照着做就能跑通。2. TaoToken 前置准备统一 Key 与 Base URL 怎么拿在改 settings 之前先把模型侧的“通行证”准备好。OpenClaw 默认走的是各家模型厂商的原生接口但我们可以把 provider 的 baseUrl 指向 TaoToken 的兼容端点这样一套 Key 就能调用多个模型省去反复切换配置的麻烦。第一步打开 TaoToken 官网注册并登录https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。登录后进入控制台找到 API Keys 页面创建一个新的 Key。这个 Key 就是后面配置里要填的 apiKey格式通常以 sk- 开头创建后只显示一次务必先复制保存。第二步确认 Base URL。TaoToken 的 API 端点是 https://taotoken.net/api 在 OpenClaw 的 provider 配置里baseUrl 要写成 https://taotoken.net/api/v1 因为 OpenClaw 走的是 OpenAI 兼容协议需要带 /v1 路径。这一点很容易踩坑只写 https://taotoken.net/api 会返回 404加上 /v1 才能正确命中 completions 接口。第三步选一个 Model ID。TaoToken 控制台的模型列表里可以看到当前可用的模型标识比如 claude-sonnet-4-20250514、gpt-4o 这类。记下你要用的那个 ID后面填到 agents.defaults.model.primary 里。如果你不确定选哪个先用一个通用对话模型跑通链路再按需换代码专用模型。注意API Key 不要写进任何会提交到 Git 的文件里。OpenClaw 的配置文件在用户目录下不在项目仓库中相对安全但仍建议定期轮换。到这里你手里应该有三样东西一个 sk- 开头的 Key、Base URL https://taotoken.net/api/v1 、一个 Model ID。接下来进入 OpenClaw 的安装和配置。3. 可复制配置settings 改到 TaoToken 的完整片段先装 OpenClaw。用 npm 全局安装PowerShell 必须以管理员模式运行npm i -g openclaw openclaw --version安装完成后执行守护进程安装和初始化openclaw onboard --install-daemon向导里选择 QuickStart模型选择那一步可以直接跳过IM 通道也先跳过后面手动配。交互方式选 Web 即可。启用飞书插件并添加频道openclaw plugins enable feishu openclaw channels add频道类型选 Feishu/Lark填入飞书应用的 App ID 和 App Secret。这两个值需要先去飞书开放平台创建“企业自建应用”获取。创建应用后在「凭证与基础信息」页面能看到 App ID 和 App Secret。App Secret 只显示一次妥善保管。拿到凭证填回 OpenClaw 后需要重启 Gateway 让配置生效。接下来是核心步骤修改配置文件把模型 provider 指向 TaoToken。配置文件位于C:\Users\用户名\.openclaw\openclaw.json。用编辑器打开找到 models.providers 部分替换成下面的结构{ models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的TaoToken密钥, api: openai-completions } } }, agents: { defaults: { model: { primary: taotoken/claude-sonnet-4-20250514 } } }, channels: { feishu: { enabled: true, appId: cli_你的AppID, appSecret: 你的AppSecret, connectionMode: websocket } }, gateway: { port: 18652, mode: local, bind: loopback, auth: { mode: token, token: 你的GatewayToken } }, plugins: { entries: { feishu: { enabled: true } } } }这里有三处必须替换apiKey 换成你刚创建的 TaoToken KeyappId 和 appSecret 换成飞书应用的凭证primary 里的模型 ID 换成你在 TaoToken 控制台看到的实际模型标识。provider 的 key 名我用了 taotoken所以 primary 写成 taotoken/模型ID斜杠前面必须和 provider 名一致否则会报模型找不到。改完保存重启 Gatewayopenclaw gateway restart openclaw gateway status状态显示 Running 就说明配置加载成功。如果报 JSON 解析错误检查是不是多了逗号或少了引号。4. 验证请求飞书侧发消息确认机器人回复配置生效后先确认 Gateway 在跑。浏览器访问 http://127.0.0.1:18652 能看到 Gateway 状态页。也可以用命令查openclaw gateway status openclaw logs -f日志里如果出现 feishu channel connected 和 provider taotoken ready说明链路已经通了。接下来去飞书开放平台完成剩余配置。在「应用能力」里添加「机器人」能力。然后在「权限管理」中批量导入权限至少需要消息收发相关权限比如 im:message、im:message:send_as_bot、im:chat:readonly。权限少了机器人不会回复这是最常见的坑。在「事件配置」里添加消息接收事件使用长连接方式不需要公网 IP很适合本地测试。需要订阅的事件包括接收消息、机器人进群、机器人被移除群、消息已读。添加后点击「发布」等待审核通过。审核通过后在飞书客户端搜索你的机器人名字发一条消息试试。比如发“你好”如果机器人能回复说明整条链路跑通了。第一次发消息可能会触发配对请求用下面的命令查看并批准openclaw pairing list feishu openclaw pairing approve feishu CODE把换成实际的配对码。批准后再发一条消息应该就能正常收到回复了。如果机器人没反应先看日志openclaw logs -f日志里会明确告诉你卡在哪一步是权限不足、事件没订阅还是 provider 请求失败。5. 本篇常见错排查401、local proxy failed 与 reading choices跑不通的时候报错信息其实很直白关键是知道去哪找。下面是我实际遇到过的几类问题。401 Unauthorized出现在日志里 provider 请求返回 401。原因通常是 apiKey 填错、Key 已失效或者 baseUrl 少了 /v1。检查 openclaw.json 里 taotoken 的 apiKey 是否和 TaoToken 控制台一致baseUrl 是否为 https://taotoken.net/api/v1 。改完记得 openclaw gateway restart。local proxy failedGateway 启动时报这个一般是端口 18652 被占用或者没有以管理员权限运行。用 netstat 查端口netstat -ano | findstr 18652如果被占用要么杀掉占用进程要么在配置里把 gateway.port 改成其他值比如 18653然后重启。reading choices 报错日志里出现 cannot read property choices of undefined说明模型接口返回的结构不符合预期。常见原因是 baseUrl 写成了 https://taotoken.net/api 而漏了 /v1请求打到了错误路径。补上 /v1 即可。另一个可能是 Model ID 写错provider 找不到对应模型返回了错误体。核对 primary 里的模型标识和控制台是否一致。OAuth 相关报错如果日志里出现 OAuth token 或 refresh 字样说明配置里混入了其他 provider 的认证方式。OpenClaw 走的是 API Key 模式不需要 OAuth。检查 models.providers 下是否只保留了 taotoken 一个 provider把多余的删掉。机器人不回复但日志无报错大概率是飞书权限没配全或应用没发布。回到飞书开放平台确认「权限管理」里消息相关权限都已添加「事件配置」里消息接收事件已订阅「版本管理与发布」里应用已发布且审核通过。三者缺一不可。排查时养成先看日志的习惯openclaw logs -f 会实时输出请求和响应比猜快得多。6. 接入文档与后续操作入口链路跑通之后你可以按需扩展。想验证模型对话效果可以直接在 TaoToken 的模型对话页面测试不同模型的回复质量https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果打算长期用 OpenClaw 做编码或 Agent 任务可以了解 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要管理 Key 或查看用量进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。API Keys 页面可以创建和吊销 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。完整的接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用的是 Claude Code 做开发想把它也接到同一套 Key 上参考 Anthropic 兼容配置https://taotoken.net/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。这样飞书机器人和本地编码工具共用一套凭证管理起来更省心。最后提醒一句飞书应用的 App Secret 和 TaoToken 的 API Key 都属于敏感信息不要截图发到公开群也不要在配置文件里留明文备份。跑通之后先把配置里的示例值全部替换掉再重启一次 Gateway 确认无误。