核心用法
Azure Foundry Image Generation Skill 是 OpenClaw 生态中的官方图像生成插件，直接调用 Azure AI Foundry（原 Cognitive Services）的 REST API，支持 FLUX-1.1-pro、DALL-E 3 等主流文生图模型部署。用户仅需配置三个环境变量（FOUNDRY_ENDPOINT、FOUNDRY_API_KEY、FOUNDRY_DEPLOYMENT）即可通过标准 HTTP 请求生成图像，结果以 base64 编码返回并自动解码保存为 PNG 文件。
技术实现亮点：采用 jq --arg 安全构造 JSON 负载，避免 shell 注入风险；通过管道流式处理 base64 数据，防止大文件内存驻留；内置 URL 格式校验正则，拦截明显不安全的端点配置。默认 API 版本为 2025-04-01-preview，兼容 Azure OpenAI 最新功能。
显著优点
1. 企业级后端：依托 Azure SLA 保障，支持全球多区域部署，适合高可用生产环境
2. 模型灵活性：可无缝切换不同 Foundry 部署（FLUX、DALL-E、Stable Diffusion 等），无需修改代码
3. 安全设计：API Key 声明为主凭证（secret），支持注册表预扫描敏感信息；请求构造采用防御性编程
4. 轻量依赖：仅需 curl/jq/base64 三个标准工具，兼容绝大多数 Linux/macOS 环境
潜在局限
- 云厂商锁定：深度绑定 Azure Foundry 生态，迁移至 AWS Bedrock 或自建 SD 需重写适配层
- 无内置重试：网络抖动或限流时需外部编排工具（如 OpenClaw workflow）实现退避策略
- 功能裁剪：当前版本仅支持同步单图生成，未实现批量生成、图像编辑（inpainting）、风格迁移等高级特性
- 调试依赖文件：中间结果
generation_result.json需手动清理，长期运行可能积累临时文件
适合人群
- 已采购 Azure OpenAI/Foundry 服务的企业开发者
- 需要 SLA 保障的生产级 AI 图像工作流（营销素材、电商主图、设计原型）
- 偏好 REST API 而非 Python SDK 的 DevOps/SRE 团队
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | `FOUNDRY_API_KEY` 以明文环境变量传递 | 使用 OpenClaw Secret Store 或 Azure Key Vault 注入 |
| 成本失控 | 高端模型（FLUX-pro）单张图片成本可达 $0.04-$0.08 | 配置预算告警，workflow 层添加生图次数限制 |
| 内容安全 | 可能生成违反 Azure AUP 的内容导致账号封禁 | 启用 Azure Content Safety 前置审核 |
| 端点劫持 | 恶意篡改 `FOUNDRY_ENDPOINT` 导致数据发送至第三方 | 网络层限制出站仅允许 `*.cognitiveservices.azure.com` |
综合评估
该技能定位清晰，是 Azure 原生图像生成的最小可行封装，适合追求稳定性与合规性的企业场景。建议后续迭代增加异步轮询、批量生成及成本估算功能。