OpenClaw技能扩展安装：第三方平台对接配置实战指南

OpenClaw的技能扩展机制并不依赖“装插件”式的操作，而是通过配置文件、加载路径与技能目录结构三者协同完成。要实现第三方平台对接，核心思路是将外部服务——例如Claude、Kimi、火山方舟等——注册为系统可识别的Provider，再让具体技能正确引用该Provider。下面分步骤拆解。

一、确认技能是否依赖第三方模型

先不要急于配置API，并非所有技能都需要外部模型支持。判断当前技能的类型：

• 依赖大模型生成内容的技能（如 summarize、code-review、image-lab）——通常需要指定provider
• 调用搜索、文档或数据库的技能（如 browser、pdf-reader）——可能需要配置search或storage provider
• 纯本地工具类技能（如 shell-exec、file-list）——无需API，依托系统环境即可运行

如果技能描述中注明“需要Gemini / Claude / Qwen 支持”，说明它依赖外部模型，provider不配置就无法使用。

二、添加自定义Provider（对接第三方平台）

这是最常见、最直接的对接方式，适用于支持OpenAI兼容协议的平台——包括快手万擎、火山方舟Coding Plan、Moonshot Kimi、Anthropic官方API等。操作分三步：

• 执行 openclaw gateway --show-config-path 查看配置文件路径
• 打开 ~/.openclaw/openclaw.json（Windows下路径为 C:\Users\<用户名>\.openclaw\openclaw.json）
• 在 "providers" 数组中新增一项，格式如下：

注意三个要点：base_url 与 model 必须严格遵循平台文档；type 填写 openai（兼容OpenAI）、anthropic（适配Claude）或 mcp（用于MCPorter中间件）。

三、让技能使用指定的Provider

Provider注册完成后并不会自动生效，需要显式绑定到技能：

• 在 openclaw.json 的 "skills" → "entries" 下，找到对应技能名称（例如 "summarize"）
• 添加 "provider": "kimi" 字段，强制该技能调用kimi提供的模型
• 如果不指定，技能会使用全局默认provider——即配置中第一个，或标记了 "default": true 的那个

示例配置：

四、验证与调试技巧

配置完成后不要直接调用技能，先做两步快速验证：

• 重启网关：执行 openclaw gateway stop && openclaw gateway start，确保新配置加载生效
• 检查模型挂载：运行 openclaw models list，应能看到 kimi/moonshot-v1-8k 出现在列表中
• 手动测试调用：使用 openclaw chat --model kimi/moonshot-v1-8k "你好" 直接发起请求，排除技能层干扰

若返回正常响应，说明Provider对接成功；若报错401或404，请逐一核对API Key、base_url路径（例如是否遗漏 /v1）、模型名拼写。问题通常集中在这几个环节。