1. 为什么要在 WSL 里跑 OpenClaw 并接飞书OpenClaw曾用名 Clawdbot、MoltBot是一个可以部署在自己电脑上的开源个人 AI 助手平台它能通过飞书、Telegram 等聊天工具跟你交互帮你处理邮件、整理文件、写代码。很多人第一次接触它卡住的地方不是安装本身而是两件事一是 Windows 上直接跑不太顺二是模型 API Key 分散在 Anthropic、OpenAI、Google 各家配置起来东一个西一个。这篇教程聚焦 Windows WSL 环境下 OpenClaw 的安装与飞书接入全流程重点解决多工具 API Key 分散管理的问题。我会给出可复制的 config.toml 骨架和 TaoToken 统一 Key 配置片段再配上飞书机器人回调验证、WSL 内服务连通性检查的具体命令。适合谁看手上有 Windows 电脑、想搭一个飞书里能直接对话的私人 AI 助手、又不想被各家 Key 管理折腾的人。整套链路从 WSL2 装好到飞书里收到机器人回复一次跑通。先说清楚一个前提飞书机器人功能需要企业版账户个人账户无法创建自建应用。如果你只有个人飞书号这一步会卡住建议先确认账户类型。2. TaoToken 前置把分散的 Key 收拢成一个OpenClaw 支持 Claude、GPT、Gemini 等多种模型默认配置下你要分别填 Anthropic API Key、OpenAI API Key、Google AI API Key。三个平台三套计费、三套额度、三个后台用久了很容易乱。我试过把 Key 写进配置文件后忘了哪个对应哪个排查问题时特别费劲。TaoToken 的思路是提供一个统一的 API 入口你只需要一个 Key就能在 OpenClaw 里调用多家模型。它的 API 地址是https://taotoken.net/api兼容 OpenAI 风格的接口调用方式所以 OpenClaw 里凡是支持自定义 base URL 的模型提供商配置都能指向它。具体怎么接在 OpenClaw 的模型配置里把 provider 的 base URL 改成 TaoToken 的 API 地址然后把 apiKey 填成你在 TaoToken 控制台生成的 Key。这样 OpenClaw 发出的请求会先到 TaoToken再由它路由到对应的模型。你不需要在 OpenClaw 里存三家的 Key只存一个。生成 Key 的入口在控制台的 API Keys 页面登录后新建一个即可。建议给这个 Key 起个能认出来的名字比如openclaw-wsl方便以后区分用途。如果你还想先验证模型通不通可以到模型对话页面直接发一条消息测试确认 Key 有效再往 OpenClaw 里配。需要提醒的是TaoToken 是统一的 API 接入服务不是让你绕过任何东西它的定位就是帮你把多模型调用收敛到一个 Key 上减少配置和维护成本。3. 可复制配置WSL 安装 OpenClaw 飞书3.1 WSL2 与 Node.js 22 准备以管理员身份打开 PowerShell执行wsl --install装完重启电脑Ubuntu 会自动启动并要求设置用户名和密码。进入 Ubuntu 后先更新系统sudo apt update sudo apt upgrade -y接着装 Node.js 22用 nvm 管理版本更省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 node --version npm --versionnode --version应显示 v22.x.x。WSL2 里要跑后台服务还得开 systemd。编辑/etc/wsl.confsudo nano /etc/wsl.conf写入[boot] systemdtrue保存后在 PowerShell 里重启 WSLwsl --shutdown wsl3.2 安装 OpenClaw一键安装curl -fsSL https://openclaw.ai/install.sh | bash如果失败改用手动安装npm install -g openclawlatest遇到权限问题就配置 npm 全局目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc npm install -g openclawlatest验证openclaw --version3.3 初始配置与 TaoToken 统一 Key运行配置向导openclaw onboard --install-daemon向导里 Gateway 模式选 Local通信渠道先跳过飞书稍后配后台服务选 Yes 安装 systemd 服务。模型认证这一步是关键选择支持自定义 base URL 的提供商把 base URL 填成https://taotoken.net/apiapiKey 填 TaoToken 控制台生成的 Key。配置向导跑完后编辑~/.openclaw/openclaw.json确认模型部分指向 TaoToken。下面是一个 config.toml 骨架供你对照填写OpenClaw 同时支持 json 与 toml 配置按你实际使用的文件格式调整[agents.defaults.model] primary anthropic/claude-sonnet-4-0 [agents.defaults.model.providers.taotoken] baseUrl https://taotoken.net/api apiKey sk-你的TaoTokenKey如果你用的是 json 配置对应片段是{ agents: { defaults: { model: { primary: anthropic/claude-sonnet-4-0, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey } } } } } }这样 OpenClaw 调用模型时统一走 TaoToken不再需要分别维护 Anthropic、OpenAI、Google 的 Key。3.4 飞书应用创建与权限进入飞书开发者后台https://open.feishu.cn/app?langzh-CN创建企业自建应用名字随意比如「clawbot机器人」。创建后在「添加应用能力」里选「机器人」并添加。在「凭证与基础信息」页面记下 App ID格式cli_xxxxxxxxx和 App Secret。进入「权限管理」开启必需权限权限标识说明contact:user.base:readonly获取用户基本信息im:message发送和接收消息im:message.p2p_msg:readonly读取私聊消息im:message.group_at_msg:readonly接收群聊 机器人 消息im:message:send_as_bot以机器人身份发送消息im:resource上传和下载图片/文件进入「事件与回调」订阅方式选「长连接」不要选 Webhook添加事件im.message.receive_v1。长连接模式无需暴露端口或配 SSL 证书适合本地部署。最后到「版本管理与发布」创建版本并发布到测试版本。3.5 安装飞书插件并配置openclaw plugins install m1heng-clawd/feishu openclaw plugins list设置凭证并启用渠道openclaw config set channels.feishu.appId cli_xxxxxxxxx openclaw config set channels.feishu.appSecret your_app_secret openclaw config set channels.feishu.enabled true完整配置参考~/.openclaw/openclaw.json里的channels.feishu部分{ channels: { feishu: { enabled: true, appId: cli_xxxxxxxxx, appSecret: your_app_secret, domain: feishu, connectionMode: websocket, dmPolicy: pairing, groupPolicy: allowlist, requireMention: true, mediaMaxMb: 30, renderMode: auto } } }配置项说明配置项说明可选值domain服务区域feishu中国/ lark国际connectionMode连接模式websocket推荐/ webhookdmPolicy私聊策略pairing / open / allowlistgroupPolicy群聊策略open / allowlist / disabledrequireMention群聊是否需要 机器人true / falserenderMode回复渲染模式auto / raw / card改完重启 Gatewayopenclaw gateway restart4. 验证请求与成功结果4.1 WSL 内服务连通性检查先确认 Gateway 起来了openclaw health openclaw status openclaw doctor如果服务没自动启动openclaw gateway start想边跑边看日志用openclaw gateway --port 18789 --verbose访问http://127.0.0.1:18789/能打开 Web 控制台说明本地服务正常。4.2 验证 TaoToken Key 是否生效在 WSL 里直接测一下 API 连通性curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的TaoTokenKey能返回模型列表就说明 Key 有效。如果这一步报 401先回控制台确认 Key 没被删或没写错。4.3 飞书渠道状态与配对openclaw channels status openclaw channels status --probe在飞书里搜索你的机器人名称发一条「你好」。如果dmPolicy设的是pairing首次会收到配对码然后openclaw pairing list feishu openclaw pairing approve feishu code批准后再发消息机器人就会回复。群聊测试则把机器人拉进群它并发送消息。看到回复即整条链路跑通。5. 本篇常见错排查5.1 Gateway 无法启动lsof -i :18789 openclaw gateway --verbose openclaw doctor --fix端口被占用就换端口或杀掉占用进程。5.2 飞书消息无响应openclaw channels status --probe openclaw logs --follow | grep -i feishu openclaw pairing list feishu重点看事件订阅是不是选了长连接、im.message.receive_v1有没有加、应用版本有没有发布。5.3 API Key 配置问题openclaw configure openclaw config set agents.defaults.model.primary anthropic/claude-sonnet-4-0如果模型调用报错先确认 base URL 是https://taotoken.net/api再确认 Key 没写错。5.4 插件加载错误升级后出现Cannot find module clawdbot/plugin-sdkopenclaw plugins uninstall feishu openclaw plugins install m1heng-clawd/feishu5.5 WSL2 网络问题要从其他设备访问 WSL 里的服务在 PowerShell管理员里做端口转发$WslIp (wsl -- hostname -I).Trim().Split( )[0] netsh interface portproxy add v4tov4 listenport18789 listenaddress0.0.0.0 connectport18789 connectaddress$WslIp6. 接下来怎么走如果你卡在接入或排障环节先去 TaoToken 控制台确认 API Keys 状态再对照接入文档检查 base URL 和请求头格式这两处是最容易出问题的地方。想先验证模型通不通直接到模型对话页面发一条消息最快。如果你打算长期在 OpenClaw 里跑编码任务或 Agent 工作流Coding Plan 更适合额度和调用方式都按持续使用来设计。日常维护记住几条命令就够了openclaw status openclaw health openclaw logs --follow openclaw plugins update feishuWSL2 配了 systemd 后OpenClaw 服务会随 WSL 启动自动拉起用systemctl --user status openclaw-gateway确认即可。飞书云文档集成还需要额外加wiki:wiki:readonly和drive:drive:readonly权限并且要把机器人添加到知识库空间——光有 API 权限不够机器人没有自己的「我的空间」只能访问被分享给它的文件。