docs: add Azure AI Foundry provider guide#68502
docs: add Azure AI Foundry provider guide#68502monasprox wants to merge 4 commits intoopenclaw:mainfrom
Conversation
Covers both Anthropic Claude and OpenAI GPT models via Azure AI Foundry. Includes adapter comparison, auth setup, troubleshooting, and env vars.
|
You have reached your Codex rate limits. Please try again later. |
Greptile SummaryThis PR adds a new Confidence Score: 4/5Safe to merge after adding the provider index entry; the missing link makes the page entirely undiscoverable. One P1 finding: the page is not linked from docs/providers/index.md (needs an Azure AI Foundry entry added alphabetically) Prompt To Fix All With AIThis is a comment left during a code review.
Path: docs/providers/azure-ai-foundry.md
Line: 1-8
Comment:
**New page not linked from the provider directory index**
`docs/providers/index.md` lists all providers alphabetically and is the primary discovery path for users. Azure AI Foundry is not listed there, so users browsing the provider directory will never find this page. It should be added alphabetically between the Arcee AI and BytePlus entries:
```suggestion
- [Azure AI Foundry (Claude & GPT)](/providers/azure-ai-foundry)
```
(The suggestion line belongs in `docs/providers/index.md`, not in this file — adding it here just shows the intended change.)
How can I resolve this? If you propose a fix, please make it concise.
---
This is a comment left during a code review.
Path: docs/providers/azure-ai-foundry.md
Line: 31-32
Comment:
**Endpoint URL format inconsistent between prerequisites and examples**
The Prerequisites section shows `https://<resource>-<region>.services.ai.azure.com` (with a `-<region>` segment), but every subsequent code example uses `https://<resource>.services.ai.azure.com` without the region. Users following the steps will copy the example URL format, so the prerequisites description should match it — or both forms should be shown to cover the two naming patterns Azure uses.
```suggestion
2. Your resource endpoint URL (e.g. `https://<resource>.services.ai.azure.com` or `https://<resource>-<region>.services.ai.azure.com`).
```
How can I resolve this? If you propose a fix, please make it concise.Reviews (1): Last reviewed commit: "docs: add Azure AI Foundry provider guid..." | Re-trigger Greptile |
| 2. Your resource endpoint URL (e.g. `https://<resource>-<region>.services.ai.azure.com`). | ||
| 3. An API key from the Foundry portal (**Keys and Endpoint** section). |
There was a problem hiding this comment.
The Prerequisites section shows https://<resource>-<region>.services.ai.azure.com (with a -<region> segment), but every subsequent code example uses https://<resource>.services.ai.azure.com without the region. Users following the steps will copy the example URL format, so the prerequisites description should match it — or both forms should be shown to cover the two naming patterns Azure uses.
| 2. Your resource endpoint URL (e.g. `https://<resource>-<region>.services.ai.azure.com`). | |
| 3. An API key from the Foundry portal (**Keys and Endpoint** section). | |
| 2. Your resource endpoint URL (e.g. `https://<resource>.services.ai.azure.com` or `https://<resource>-<region>.services.ai.azure.com`). |
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/providers/azure-ai-foundry.md
Line: 31-32
Comment:
**Endpoint URL format inconsistent between prerequisites and examples**
The Prerequisites section shows `https://<resource>-<region>.services.ai.azure.com` (with a `-<region>` segment), but every subsequent code example uses `https://<resource>.services.ai.azure.com` without the region. Users following the steps will copy the example URL format, so the prerequisites description should match it — or both forms should be shown to cover the two naming patterns Azure uses.
```suggestion
2. Your resource endpoint URL (e.g. `https://<resource>.services.ai.azure.com` or `https://<resource>-<region>.services.ai.azure.com`).
```
How can I resolve this? If you propose a fix, please make it concise.- Add Azure AI Foundry to docs/providers/index.md (P1: discoverability) - Show both URL formats in prerequisites (P2: consistency)
|
Thanks for the provider guide. Closing this because new provider docs need an owner-backed docs gap or plugin/ClawHub path; please resubmit a narrow current-main guide if this is still a supported core provider target. |
Summary
Adds documentation for using Azure AI Foundry models with OpenClaw, covering both Anthropic (Claude) and OpenAI (GPT) model families.
What's included
docs/providers/azure-ai-foundry.md— full provider guide following existing doc conventionsContent covers:
anthropic-messagesfor Claude,azure-openai-responsesfor GPTauth-profiles.jsonsetup (type"token", not"api-key")/anthropic/must NOT include/v1(adapter auto-appends)Motivation
Azure AI Foundry is increasingly popular for enterprise deployments. The existing docs cover direct API providers (Anthropic, OpenAI, Bedrock) but not Azure AI Foundry as an intermediary host. This guide fills that gap based on hands-on production experience.
Testing
Verified working with:
claude-sonnet-4-6viaanthropic-messagesadapter on Azure AI Foundryauth-profiles.jsonwithtype: "token"storageChecklist