必须绕过quickstart模式手动配置:以管理员身份运行powershell,确保node.js≥22.16.0,设置npm镜像源,安装启用skills-core及file-system、terminal-exec技能;飞书需注入app id/secret/verificationtoken并重启gateway;univibe需配置baseurl/apikey或动态注册并测试模型;whatsapp需配置phone number id/access token/verify token,并验证webhook。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Windows上为OpenClaw扩展技能并对接第三方平台(如飞书、UniVibe、WhatsApp等),必须绕过默认的QuickStart模式,手动编辑配置文件并启用对应通道与技能模块。直接运行openclaw onboard会跳过关键参数,导致后续技能无法加载或通道认证失败。
确认基础环境与权限
以管理员身份启动PowerShell:右键“开始”→选择“Windows PowerShell(管理员)”,否则后续写入$env:USERPROFILE\.openclaw\目录时会因权限不足静默失败。
执行node -v,确保输出≥22.16.0;若低于该版本,OpenClaw v2026.6.1将拒绝加载Skills插件——这是硬性门槛,【低于Node.js 22.16.0会导致技能模块完全不可见】。
运行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会自动在.openclaw\channels\lark\下生成Webhook密钥文件,【该文件首次生成后不可重置,丢失需重新创建飞书应用】。
第四步:重启Gateway服务:openclaw gateway restart。仅重启Dashboard无效,通道注册发生在Gateway层。
接入UniVibe模型服务(技能调用前提)
方法一:通过配置文件硬编码(推荐用于生产环境)
用记事本打开$env:USERPROFILE\.openclaw\openclaw.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。
第二步:执行配置命令链:
① 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订阅。










