核心用法
Azure Proxy 是一个 Node.js 轻量级代理服务,专门用于桥接 OpenClaw 与 Azure OpenAI 之间的 API 不兼容问题。主要解决 OpenClaw 构建 URL 时直接拼接路径导致 Azure 必需的 api-version 查询参数丢失的问题。
部署流程:
1. 配置环境变量(Azure 端点、部署名、API 版本)
2. 运行 node scripts/server.js 启动代理
3. 在 OpenClaw 配置中添加自定义 provider,指向本地代理端口
4. 关键配置:authHeader: false(Azure 使用 api-key 头而非 Bearer Token)
进阶用法:可将 Azure 配置为 subagent 默认模型,利用 Visual Studio 订阅赠送的 Azure 额度自动化执行后台任务,节省 OpenAI 直调成本。
显著优点
- 精准解决痛点:针对性修复 URL 构造冲突,无需修改 OpenClaw 源码
- 成本优化:支持将 Azure 订阅额度(如 Visual Studio Benefit)用于 OpenClaw 工作流
- 部署灵活:支持 systemd 用户级服务,随系统自启
- 配置透明:环境变量驱动,多部署场景易于切换
潜在局限
- 单点依赖:本地代理故障会导致所有 Azure 路由中断
- 手动配置门槛:需正确理解 Azure Portal 中的 endpoint、deployment、api-version 三者关系
- Azure 内容过滤:部分在 OpenAI 直调中正常的 Prompt 可能被 Azure 内容安全策略拦截
- 网络隔离:默认绑定 127.0.0.1,多机协作需额外调整
适合人群
- 持有 Visual Studio Enterprise/Professional 订阅的开发人员(含月度 Azure 额度)
- 企业内已采购 Azure OpenAI 服务、希望复用现有配额的用户
- 需要对比 OpenAI 与 Azure 输出一致性或多供应商容灾的技术团队
常规风险
- 密钥泄露风险:API key 以明文形式存储在 OpenClaw JSON 配置和环境变量中
- 版本漂移:Azure API 版本更新后需手动同步
AZURE_OPENAI_API_VERSION - 无加密传输:本地 HTTP 代理若暴露至公网存在中间人攻击面
- 服务可用性:非官方集成,Azure 策略变更可能导致方案失效