1. 为什么要在 Windows 上用 WSL Docker 跑 OpenClaw 并接入飞书OpenClaw 是一个可以自托管的 AI 助手网关社区里叫它“小龙虾”。它能做的事情很直接把大模型能力接到你日常用的聊天工具里比如飞书、Telegram、Discord让机器人在群里或私聊里回答问题、执行任务。适合谁适合想在 Windows 上折腾一套私有 AI 助手、又不想把数据交给第三方托管平台的开发者和小团队。但 Windows 原生跑 OpenClaw 会遇到几个现实问题Node 版本冲突、路径分隔符差异、Docker Desktop 与 WSL 的端口映射偶尔抽风。所以更稳的路线是WSL2 提供 Linux 运行环境Docker 负责容器编排OpenClaw 跑在容器里飞书通过长连接回调进来。真正让人头疼的不是安装本身而是鉴权分散。OpenClaw 要调模型需要模型厂商的 Key飞书机器人要回调需要 App ID 和 Secret网关本身还有 token。三套凭证散落在不同配置文件里改一个忘一个排查起来很痛苦。这篇的做法是把模型调用统一走 TaoToken 的 API 通道用一个 Key 覆盖多个模型飞书侧只保留机器人自身的凭证职责清晰。下面从 WSL 环境准备开始一路到飞书消息回执验证每一步都给可复制的配置。2. TaoToken 前置准备统一 Key 与 API 通道在动手改 OpenClaw 配置之前先把模型侧的凭证准备好。TaoToken 的作用是提供一个统一的 API 入口你拿一个 Key就能在 OpenClaw 里调用不同厂商的模型不用为每个模型单独申请和轮换密钥。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。操作路径很清晰登录后进入控制台在 API Keys 页面创建一个新 Key。创建时建议给 Key 起一个能识别的名字比如openclaw-wsl方便以后在多个项目之间区分。创建完成后立刻复制保存页面刷新后就不再完整显示。拿到 Key 之后你需要确认两件事Base URL 和 Model ID。Base URL 用https://taotoken.net/api注意不要带末尾斜杠。Model ID 取决于你想用哪个模型在控制台的模型列表里能看到可用模型及其对应的 ID 字符串。OpenClaw 的模型配置里baseUrl填 TaoToken 的 API 地址apiKey填你刚创建的 Keyapi字段保持openai-completions因为 TaoToken 提供的是 OpenAI 兼容接口。这里有个容易踩的坑有人把 Base URL 写成https://taotoken.net/api/v1结果请求 404。正确做法是只写到/apiOpenClaw 或 OpenAI SDK 会自动拼接/v1/chat/completions。如果你在 curl 里手动测试才需要写完整的/api/v1/chat/completions。另外TaoToken 的 Key 是敏感信息不要直接提交到 Git 仓库。在 WSL 里可以用环境变量管理后面 docker-compose 部分会给出具体写法。如果你需要长期跑编码类 Agent 任务可以了解 Coding Plan 方案如果只是想先验证模型通不通用模型对话页面发一条测试消息最快。3. WSL Docker 环境与 OpenClaw 可复制配置这一节是全文的核心操作区。先确认 WSL2 已经装好在 PowerShell 里执行wsl --list --verbose看到 VERSION 为 2 即可。如果还是 1用wsl --set-version 发行版名 2升级。Docker Desktop 安装后在设置里勾选“Use WSL 2 based engine”并把你的 WSL 发行版加入集成列表。接下来拉取 OpenClaw 的 Docker 编排仓库。在 WSL 终端里找一个工作目录执行git clone https://github.com/ozbillwang/openclaw-in-docker.git cd openclaw-in-docker export OPENCLAW_IMAGEalpine/openclaw:2026.3.8 docker pull alpine/openclaw:2026.3.8版本选 2026.3.8 是因为实测下来这个 tag 的网关稳定性最好新版本偶尔会出现容器反复重启。拉取完成后运行./docker-setup.sh进入交互式安装界面。用方向键选择回车确认。如果方向键没反应说明 Git 版本太旧先执行git update-git-for-windows更新。安装向导里几个关键选择Quickstart 选 yes模型配置先 skip for now后面手动改 JSON 更可控通信软件也先 skip飞书单独配技能配置选 no。勾选完确认容器就起来了。现在处理网关配置。找到 Windows 用户目录下的.openclaw文件夹路径通常是C:\Users\你的用户名\.openclaw打开openclaw.json。在网关配置里加入允许来源controlUi: { allowedOrigins: [*] }保存后重启容器。这时访问http://127.0.0.1:18789应该能看到控制台。首次访问需要 tokentoken 在配置文件里拼成http://127.0.0.1:18789/?token你的token打开。设备配对在容器内执行node dist/index.js devices list --token 你的token --url ws://127.0.0.1:18789拿到 requestId 后执行 approvenode dist/index.js devices approve 你的requestId --token 你的token模型配置是重点。在openclaw.json的models.providers下加入 TaoToken 通道models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的TaoTokenKey, api: openai-completions, models: [ { id: 你的模型ID, name: TaoToken Unified Model, maxTokens: 8192 } ] } } }如果你用 docker-compose 管理环境变量可以在docker-compose.yml的openclaw-gateway和openclaw-cli服务下加environment: - TAOTOKEN_API_KEY${TAOTOKEN_API_KEY}然后在同目录建.env文件写TAOTOKEN_API_KEY你的Key。这样 Key 不进 JSON也不进 Git。飞书接入部分先在飞书开放平台创建企业自建应用添加机器人记录 App ID 和 App Secret。回到容器执行openclaw config依次选 local、channels、Config/link、FeiShu首次会提示下载插件。输入 Secret 和 ID连接方式选 WebSocket区域选 Feishu-China最后 Finished。配对方式选 pairing。权限导入用这段 JSON{ scopes: { tenant: [ im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:send_as_bot, im:resource, contact:user.base:readonly ], user: [] } }事件订阅里添加im.message.receive_v1和im.chat.member.bot.added_v1用长连接方式保存。创建版本并发布后在开发者小助手里找到机器人测试。4. 验证请求与飞书消息回执检查配置写完必须验证不然你不知道是模型通道断了还是飞书回调没通。先用 curl 直接打 TaoToken 的 API确认 Key 和模型 ID 有效curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 回复ok}], max_tokens: 16 }返回里如果choices[0].message.content有内容说明模型通道正常。如果返回 401检查 Key 是否复制完整如果返回 model not found检查模型 ID 是否和控制台一致。接着验证 OpenClaw 网关。在浏览器打开带 token 的控制台地址在聊天框发一条消息。如果模型配置正确几秒内会返回回复。如果一直转圈去容器日志里看docker logs -f openclaw-gateway日志里出现reading choices相关报错通常是返回结构解析问题检查api字段是否为openai-completions。出现local proxy failed检查 Base URL 是否写成了带/v1的地址。飞书侧验证在飞书里给机器人发私聊消息观察是否回复。如果没回复先看飞书开放平台的事件订阅日志确认im.message.receive_v1有没有推送到。如果推送成功但机器人不回去容器日志看飞书插件是否报 OAuth 或 token 过期。飞书机器人的 tenant_access_token 是自动刷新的但如果 App Secret 填错会一直报 401。消息回执检查有个技巧在飞书开放平台的“事件与回调”页面能看到每条事件的推送状态和响应时间。如果显示推送成功但响应超时说明 OpenClaw 处理太慢可能是模型调用卡住了。这时候回到 curl 测试确认模型通道的响应时间。5. 本篇常见错误排查401 Unauthorized出现在 curl 或容器日志里。先确认 TaoToken Key 没有多余空格再确认请求头是Authorization: Bearer Key。如果 Key 没问题检查是不是把 Base URL 写成了https://taotoken.net/api/带末尾斜杠某些 HTTP 客户端会把双斜杠当成路径错误。local proxy failedOpenClaw 网关报这个通常是baseUrl配置不对。正确值是https://taotoken.net/api不要加/v1。如果你在 docker-compose 里用环境变量注入确认.env文件里的变量名和openclaw.json里引用的名字一致。reading choices 报错模型返回了非预期结构。检查api字段是否为openai-completions以及模型 ID 是否真实存在。有些模型 ID 带日期后缀复制时容易漏掉。OAuth 相关报错飞书插件报 OAuth 失败检查 App ID 和 App Secret 是否匹配以及应用是否已发布版本。未发布的应用只有开发者自己能触发。容器反复重启多半是openclaw.json格式错误。用 JSON 校验工具检查括号和逗号。另外确认controlUi.allowedOrigins已添加否则网关启动时会因为来源限制退出。飞书消息重复回复飞书账号如果在多个设备登录开发者小助手里可能出现重复的机器人实例。确认你测试的是正确的那个应用必要时在开放平台重新发布版本。WSL 端口访问不了Docker Desktop 的端口映射有时需要重启 WSL。在 PowerShell 执行wsl --shutdown等几秒再打开 WSL重新启动容器。6. 统一 Key 之后的维护与扩展把模型调用统一走 TaoToken 之后日常维护成本明显下降。以前每加一个模型要改一次 Key现在只需要在 TaoToken 控制台确认模型可用然后在openclaw.json的models数组里加一条记录。飞书侧的凭证和模型侧的凭证彻底解耦排查问题时边界清晰飞书不回消息先看事件订阅模型不回复先 curl 测 API。如果你想让 OpenClaw 操作 Windows 文件在docker-compose.yml的两个服务下加卷映射volumes: - C:\:/host/c:rw - E:\:/host/e:rw - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace改完执行docker compose down再docker compose up -d。容器内就能通过/host/c访问 C 盘。最后提醒一点TaoToken 的 Key 建议定期轮换在控制台删旧建新然后更新.env文件并重启容器。飞书机器人的权限按最小必要原则给上面那段 JSON 已经够日常对话用不需要额外开通讯录或群管理权限。