Agent Skills
返回列表
OpenClaw Azure OpenAI 代理

OpenClaw Azure OpenAI 代理

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/azure-proxy。

技能介绍

背景:OpenClaw 与 Azure OpenAI 的 URL 不兼容

OpenClaw 会按自己的规则拼接请求路径;而 Azure OpenAI 要求把 api-version 放在查询串里,且路径形态与 OpenAI 公有云并不一致。常见做法是:在 Provider 的 baseUrl 里已经带上 api-version,此时 OpenClaw 再追加 /chat/completions 等路径,会把查询参数搅乱或指向错误资源,表现为 404 Resource not found 或莫名其妙的鉴权失败。

这个技能做什么

azure-proxy 是一个轻量 Node.js 本地代理,挡在 OpenClaw 与 Azure 之间做 URL 重写与转发:

  • OpenClaw 仍按原有 Provider 配置发请求到本机端口(默认 18790)。
  • 代理读取 AZURE_OPENAI_ENDPOINT、AZURE_OPENAI_DEPLOYMENT、AZURE_OPENAI_API_VERSION 等环境变量,把请求转成 Azure 认可的 REST 形态。
  • 在 OpenClaw 侧需将 authHeader: false,因为 Azure 走 api-key 头,而不是 Bearer Token。

可选地,可把子 Agent / 自动化任务流量经代理打到 Azure,用企业配额替代公有云 Key。

边界与排错

  • 404:核对 Portal 里的 endpoint 主机名与 deployment 名称是否与配置一致。
  • 401:检查 API Key 是否过期或填错。
  • 内容审核:Azure 内容过滤比 OpenAI 更严,同一 prompt 可能在 Azure 侧被拦截。

使用场景

  • 公司统一采购 Azure OpenAI,要在 OpenClaw 里接同一套 deployment 跑对话 Agent
  • baseUrl 已写 api-version 后,OpenClaw 请求一直 404,需要本地转发层改写成 Azure REST
  • 想把定时子 Agent 任务走 Azure 配额,而不是直连 OpenAI 公有云计费
  • 本机只开放 127.0.0.1 代理端口,多份 OpenClaw 配置共用同一 Azure 资源

适合人员

  • 维护 ~/.openclaw/openclaw.json、要接企业 Azure Key 的 OpenClaw 日常使用者
  • 负责内网 AI 网关,需要把 OpenClaw 流量收敛到合规 Azure 区域的运维工程师
  • 用 OpenClaw 编排多子 Agent、希望自动化任务扣 Azure 额度而非个人 OpenAI 的研发
  • 在 Azure Portal 对照 endpoint/deployment 排查 404、401 的后端集成工程师