OpenClaw Azure OpenAI 代理
将以下提示词粘贴到你的 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 的后端集成工程师