10分钟快速搭建OpenClaw(基于Windows+飞书)：把settings改到TaoToken

1. Windows 下 OpenClaw 接入飞书时settings 里的 endpoint 到底该改哪一行很多人第一次在 Windows 上装 OpenClaw卡住的地方不是 Node.js 装不上也不是飞书机器人建不出来而是最后一步settings 里那一串 endpoint 和鉴权字段到底该填什么、改哪一行、改完为什么还是 401。我自己在 Windows 11 上从零跑通 OpenClaw 飞书这条链路时前后重装了三次前两次都死在「模型能回、飞书不回」这个状态上。先把结论说清楚OpenClaw 本身是一个本地运行的 AI 智能体网关它负责把你的对话请求转发给大模型同时把飞书、企业微信、钉钉这些渠道的消息接进来。它默认会引导你选一个模型服务商比如 Kimi、OpenAI 之类然后让你粘贴对应的 Key。问题在于如果你手上有多个模型来源、或者想统一走一个通道管理 Key 和计费就需要把 settings 里的 endpoint 从默认服务商地址改成你自己的统一入口。这一步在 Windows 上尤其容易出错因为配置文件路径、PowerShell 执行策略、npm 全局目录这三件事会互相干扰。这篇内容面向的是已经在 Windows 上装好 Node.js 22想用 npm 从零搭 OpenClaw并且希望把 settings 中的 endpoint 与鉴权配置改到 TaoToken 统一通道的人。你会拿到可复制的 settings 配置片段、npm 依赖清单、飞书回调地址填写步骤以及启动后消息收发的验证动作。整个流程按 10 分钟节奏排但第一次做建议留 20 分钟因为飞书开放平台那边有版本发布和权限开通的等待。核心检索词先给出来OpenClaw Windows 飞书接入、settings endpoint 修改、TaoToken 统一通道配置。这三个词基本覆盖了你会搜到的所有报错场景。下面按「原问题 → 前置 → 配置 → 验证 → 排障 → 入口」六段走每段都能直接跟做。2. TaoToken 前置准备Key、Base URL 与 npm 依赖清单在动 settings 之前先把三样东西准备好TaoToken 的 API Key、Base URL以及 OpenClaw 需要的 npm 依赖。这三样缺一个后面配置就会卡在鉴权或模块找不到上。先说 TaoToken 这边。你需要拿到一个 API Key这个 Key 是后面填进 settings 的鉴权字段。获取入口在 API Keys 页面登录后创建一个新 Key复制出来先存到记事本。注意 Key 只显示一次关掉页面就看不到了。Base URL 统一用https://taotoken.net/api这个地址不加任何查询参数直接作为 endpoint 的基础路径。然后是 npm 依赖。OpenClaw 的飞书渠道插件是通过 npm 分发的包名是openclaw/feishu。在配置过程中OpenClaw 会问你是从 npm 下载还是本地安装选 npm 下载即可。但在这之前建议先确认你的 npm 全局目录可写否则插件装不进去。Windows 上可以用这条命令看全局目录npm config get prefix如果输出的是C:\Program Files\nodejs这类需要管理员权限的路径建议改成用户目录下的路径避免每次装插件都要提权npm config set prefix $env:APPDATA\npm改完之后把$env:APPDATA\npm加到 PATH 里重开一个 PowerShell 窗口生效。这一步不做后面openclaw/feishu安装时可能报 EPERM 或 EACCES。Node.js 版本要求是 22 及以上。如果你用 nvm 管理版本直接nvm install 22 nvm use 22 node -v确认输出 v22.x 即可。Git 也建议装上因为部分插件安装会走 git 协议拉取。装完 Git 后git --version能输出版本号就行。PowerShell 执行策略这块要提前处理。OpenClaw 的安装脚本是.ps1文件默认策略可能禁止运行。执行这条命令把当前用户的策略设为 RemoteSignedSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser这条命令的作用是允许本地脚本运行同时限制未签名的远程脚本。设完之后再跑安装脚本就不会被拦。依赖清单整理成表格方便你对照检查依赖项版本/包名用途检查命令Node.jsv22运行时node -vnpm随 Node 附带包管理npm -vGit最新版插件拉取git --versionOpenClaw官方安装脚本主程序openclaw -v飞书渠道插件openclaw/feishu渠道接入配置时自动装TaoToken Key控制台创建鉴权手动保存TaoToken 的 Key 和 Base URL 准备好后先不要急着填。下一步是装 OpenClaw 主程序装完再统一改 settings。这样顺序不乱出问题也好定位。3. 可复制配置settings 中 endpoint 与鉴权字段的完整片段这一节是整篇的核心。OpenClaw 的 settings 文件在 Windows 上的默认位置是用户目录下的.openclaw文件夹具体路径是C:\Users\你的用户名\.openclaw\settings.json。如果你在安装时选了 QuickStart它会自动生成一份基础配置里面已经带了模型服务商和 Key 的占位。你要做的是把模型部分的 endpoint 和鉴权改成 TaoToken 的通道。先看安装流程。在 PowerShell 里执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex安装过程中会依次问你几个问题是否接受风险选 Yes启动模式保持 QuickStart模型服务商这里先随便选一个比如 Kimi认证方法选.cn粘贴一个临时 Key模型保持默认通讯工具选跳过skills 选跳过其他密钥选 NoHooks 选跳过。这些先跳过没关系因为后面我们要手动改 settings 把模型通道换成 TaoToken。安装完成后先别启动网关。直接打开 settings 文件notepad $env:USERPROFILE\.openclaw\settings.json找到models或providers这一段。不同版本的字段名可能略有差异但结构类似。你要改的是三处baseUrl、apiKey、model。下面给一份可复制的 JSON 片段路径和字段名按 OpenClaw 当前版本的结构来{ models: { default: taotoken-channel, providers: { taotoken-channel: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, headers: { Authorization: Bearer sk-你的TaoToken密钥 } } } }, channels: { feishu: { enabled: true, appId: cli_你的飞书AppID, appSecret: 你的飞书AppSecret, connectionMode: websocket, domain: feishu.cn, groupChatPolicy: open, dmPolicy: open } } }几个关键点说明。baseUrl填https://taotoken.net/api不要带尾部斜杠也不要加任何查询参数。apiKey和headers.Authorization两处都要填同一个 Key有些版本只读其中一处两处都填最稳。model字段填你要用的模型 ID这个 ID 要和你 TaoToken 通道里支持的模型一致填错会报 model not found。如果你更习惯用 TOML 格式OpenClaw 也支持settings.toml等价片段如下[models] default taotoken-channel [models.providers.taotoken-channel] type openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 model claude-sonnet-4-20250514 [models.providers.taotoken-channel.headers] Authorization Bearer sk-你的TaoToken密钥 [channels.feishu] enabled true appId cli_你的飞书AppID appSecret 你的飞书AppSecret connectionMode websocket domain feishu.cn groupChatPolicy open dmPolicy open飞书那段的 appId 和 appSecret 来自飞书开放平台后面第五节会讲怎么拿。connectionMode 选 websocket 是长连接模式不需要公网回调地址本地开发最省事。domain 填feishu.cn国内飞书用这个。groupChatPolicy 和 dmPolicy 测试阶段都填 open正式环境建议 dmPolicy 改成 pairing。改完 settings 后回到 PowerShell 跑一次配置命令确认openclaw config它会读取你改过的 settings如果 JSON 格式有误会直接报解析错误。确认无误后启动网关openclaw gateway网关窗口不要关它是消息转发的核心进程。看到监听 18789 端口的日志就说明起来了。4. 验证请求从本地 Web UI 到飞书消息收发的完整动作配置改完不等于通了必须做两步验证先验证本地到 TaoToken 的模型请求再验证飞书到 OpenClaw 的消息链路。这两步分开做出问题才知道是哪一段断的。第一步本地模型请求验证。网关启动后浏览器打开http://127.0.0.1:18789/chat?sessionmain这是 OpenClaw 的 Web UI。在输入框发一句「你好介绍下你自己」。如果 settings 里的 endpoint 和 Key 填对了你会看到模型正常回复。如果这里就报错说明问题在模型通道跟飞书无关。常见报错是 401代表 Key 无效或 Authorization 头没带上也可能是 model not found代表 model 字段填的 ID 不在 TaoToken 通道支持列表里。第二步飞书消息验证。这一步的前提是飞书机器人已经建好、权限已开通、版本已发布、事件回调已配置。这些动作在飞书开放平台完成顺序不能乱。先在开放平台创建企业自建应用添加机器人能力然后在权限管理里搜索im:全选开通。接着创建版本并发布因为权限修改必须发布后才生效。事件回调这块在应用的「事件与回调」里配置长连接接收事件添加「接收消息」事件。同时到权限管理里搜索「通讯录」勾选获取通讯录基本信息再次发布版本。这两次发布都不能省少一次就会出现消息发出去但机器人收不到的情况。回到 OpenClaw 这边跑一次渠道配置命令openclaw config依次选 Local、Channels、Configure/link、飞书然后选 Download from npm 安装openclaw/feishu插件。接着输入飞书的 App Secret 和 App ID连接模式选 WebSocketdomain 选 feishu.cn群聊策略选 Open私聊策略测试阶段选 Open。最后选 Finished 和 Continue 完成。配置完成后重启网关openclaw gateway现在用手机打开飞书找到开发者小助手里的自建应用点「打开应用」给机器人发一条消息。正常情况下机器人会先在你的消息上回一个表情几秒后去掉表情并给出正式回复。这个「先表情后回复」是 OpenClaw 处理任务时的标准动作说明消息链路完全通了。验证成功的标志有三个Web UI 里模型能回、飞书里机器人能回、网关窗口有对应的请求日志。三个都满足说明从本地到 TaoToken 再到飞书的整条链路跑通了。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth这一节按真实报错来。下面这几个是我在 Windows 上实际遇到过的每个都给出定位方法和修复动作。401 Unauthorized。这个报错出现在 Web UI 发消息时说明 TaoToken 通道的鉴权没过。检查三处settings 里apiKey和headers.Authorization是否都填了同一个 KeyKey 是否复制完整没有多余空格Base URL 是否是https://taotoken.net/api而不是别的路径。如果三处都对还是 401去 TaoToken 控制台确认这个 Key 是否被禁用或额度耗尽。local proxy failed。这个报错通常出现在网关启动阶段意思是本地代理端口被占用或无法绑定。OpenClaw 默认用 18789 端口如果这个端口被别的程序占了就会报这个错。用这条命令查占用netstat -ano | findstr 18789找到 PID 后在任务管理器里结束对应进程或者改 OpenClaw 的监听端口。改端口在 settings 里加gateway.port字段即可。reading choices 报错。这个一般出现在模型返回格式不符合预期时OpenClaw 解析响应体里的choices字段失败。原因多半是 model 字段填的 ID 和 TaoToken 通道实际支持的模型不匹配导致返回了错误结构。解决办法是确认 model ID 拼写正确并且这个模型在 TaoToken 通道里可用。如果用的是 Claude 系列注意 ID 里的日期后缀要完整。OAuth 相关报错。如果你在配置过程中选了需要 OAuth 的认证方式但没走完授权流程就会卡在 OAuth 回调上。OpenClaw 的模型通道如果走 API Key 模式不需要 OAuth。检查 settings 里type字段是否是openai-compatible如果是别的类型且涉及 OAuth改成 API Key 模式重新填。飞书消息发出去没反应。这个不是报错但比报错更常见。排查顺序飞书应用版本是否已发布、事件回调是否配置了「接收消息」、权限里im:是否全选、通讯录权限是否开通。这四项缺任何一项消息都到不了 OpenClaw。另外确认网关窗口是开着的关掉网关消息就断了。插件安装失败 EPERM。这是 npm 全局目录权限问题回到第二节把 prefix 改到用户目录即可。改完重开 PowerShell 再装。把这几类错对照着排查基本能覆盖 90% 的卡点。剩下的多半是配置字段拼写问题用openclaw config跑一遍就能暴露 JSON 解析错误。6. 语义一致 CTAKey、文档与 Coding Plan 的对应入口链路跑通之后如果你打算长期用 OpenClaw 做编码或 Agent 任务建议把 Key 管理和通道配置固定下来避免每次换模型都重改 settings。TaoToken 这边几个入口按用途分需要创建或轮换 API Key去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows_feishu需要查接入参数和字段说明看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows_feishu想先在网页里验证模型是否可用用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows_feishu长期跑编码和 Agent 任务看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows_feishu需要管理多个 Key 和用量进控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows_feishu如果你用的是 Claude Code 这类工具Anthropic 兼容接入的说明在这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_windows_feishu最后给一个实用技巧settings 改完后先备份一份到settings.json.bak下次换模型或换通道时直接对比字段差异比重新走一遍安装流程快得多。网关窗口建议用 Windows Terminal 单独开一个标签页跑日志滚动看得清楚出问题第一时间能看到是哪一段报的错。