在 Windows 环境下为 OpenClaw 扩展技能并集成第三方平台时，直接运行 openclaw onboard 虽然便捷，但会漏掉大量关键参数——飞书通道认证失败、技能模块无法加载、WhatsApp Webhook 无响应等，这些问题通常都源于 QuickStart 模式默认配置不够完整。要确保飞书、UniVibe、WhatsApp 等通道都能稳定运行，必须绕过 QuickStart，手动编辑配置文件并正确启用对应通道与技能模块。
确认基础环境与系统权限
第一步，请以管理员身份启动 PowerShell：右键单击“开始”菜单 → 选择“Windows PowerShell（管理员）”。这一步不可省略，否则后续写入 $env:USERPROFILE.openclaw 目录时，权限不足会静默失败，且难以排查。
接着检查 Node.js 版本，执行 node -v，输出结果必须 ≥22.16.0。OpenClaw v2026.6.1 对 Node 版本有硬性要求，低于 22.16.0 时技能模块将完全不可见，插件也无法加载。
国内网络环境下，建议先配置 npm 镜像源：npm config set registry https://registry.npmmirror.com。若不设置镜像源，openclaw skill install 会在 fetch 阶段持续超时，且不显示任何错误提示，极易导致误判。
安装并启用核心技能包
先查看当前已注册的技能：openclaw skill list。若列表为空，说明技能系统尚未初始化。
安装最新维护的通用技能集：openclaw skill install @openclaw/skills-core@latest。此步骤不可跳过——即使飞书、WhatsApp 等通道配置正确，也需要技能包来触发消息路由逻辑，否则消息进入后无响应。
接着启用文件操作与终端执行技能：openclaw skill enable file-system terminal-exec。注意操作顺序：必须先 install 再 enable，若颠倒顺序会报“skill not found”，虽然进程不终止，但极易让人误以为成功，实际并未生效。
对接飞书平台（含令牌配置详解）
访问飞书开放平台，创建企业自建应用，获取 App ID 和 App Secret。在 PowerShell 中执行以下命令注入配置：
openclaw config set channels.lark.appId YOUR_APP_ID
openclaw config set channels.lark.appSecret YOUR_APP_SECRET
openclaw config set channels.lark.verificationToken YOUR_VERIFICATION_TOKEN
启用飞书通道：openclaw channel enable lark。此时 OpenClaw 会自动在 .openclawchannelslark 目录下生成 Webhook 密钥文件。该文件首次生成后不可重置，一旦丢失只能重新创建飞书应用，请务必妥善备份。
最后重启 Gateway 服务：openclaw gateway restart。注意仅重启 Dashboard 无效，通道注册发生在 Gateway 层。
接入 UniVibe 模型服务（技能调用的前提）
UniVibe 的配置有两种方式，生产环境推荐使用配置文件硬编码。
方案一：配置文件硬编码
用记事本打开 $env:USERPROFILE.openclawopenclaw.json，在 models.providers 节点下插入以下内容：
"univibe": { "baseUrl": "https://api.univibe.cc/v1", "apiKey": "sk-xxx", "api": "openai-completions", "models": [{ "id": "qwen3.5-9b", "name": "UniVibe-Qwen3.5", "contextWindow": 128000 }]}
方案二：命令行动态注册（适合调试阶段）
openclaw config set models.providers.univibe.baseUrl https://api.univibe.cc/v1
openclaw config set models.providers.univibe.apiKey sk-xxx
openclaw config set models.defaultProvider univibe
配置完成后，验证模型可用性：openclaw model test --provider univibe --model qwen3.5-9b。返回 status: ok 才表示技能可以调用该模型，否则后续技能执行将 fallback 到本地 Qwen 模型，并报 token 超限错误。
WhatsApp 通道配置（需 Meta Business Suite）
登录 Meta Business Suite，添加 WhatsApp 业务账号，获取 Phone Number ID 和 Access Token。接着在 PowerShell 中执行配置命令链：
① openclaw config set channels.whatsapp.phoneNumberId YOUR_PHONE_NUMBER_ID
② openclaw config set channels.whatsapp.accessToken YOUR_ACCESS_TOKEN
③ openclaw config set channels.whatsapp.verifyToken YOUR_VERIFY_TOKEN（该 token 需与 Meta 后台填写的完全一致，大小写敏感）。
启用通道并验证 Webhook：openclaw channel enable whatsapp → openclaw channel verify whatsapp。后者会向 Meta 发起回调测试。若失败返回 HTTP 400 错误码，常见原因要么是 verifyToken 不匹配，要么是 Meta 后台未启用 Webhook 订阅。