feat(providers): add Poe API provider plugin

Add Poe (api.poe.com) as a provider plugin with OpenAI-compatible API.

- Create extensions/poe with plugin implementation
- Add API key validation via /v1/models endpoint
- Include 8 popular models: Claude, GPT-4o, Gemini, Llama
- Add unit tests (6 tests)
- Add documentation at docs/providers/poe.md
- Update provider index and docs navigation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/docs.json

@@ -101,6 +101,10 @@
       "source": "/openrouter/",
       "destination": "/providers/openrouter"
     },
+    {
+      "source": "/poe",
+      "destination": "/providers/poe"
+    },
     {
       "source": "/opencode",
       "destination": "/providers/opencode"
@@ -984,6 +988,7 @@
           "providers/moonshot",
           "providers/minimax",
           "providers/openrouter",
+          "providers/poe",
           "providers/synthetic",
           "providers/opencode",
           "providers/glm",

docs/providers/index.md

@@ -37,6 +37,7 @@ See [Venice AI](/providers/venice).
 - [Anthropic (API + Claude Code CLI)](/providers/anthropic)
 - [Qwen (OAuth)](/providers/qwen)
 - [OpenRouter](/providers/openrouter)
+- [Poe (Claude, GPT, Gemini, Llama)](/providers/poe)
 - [Vercel AI Gateway](/providers/vercel-ai-gateway)
 - [Moonshot AI (Kimi + Kimi Code)](/providers/moonshot)
 - [OpenCode Zen](/providers/opencode)

docs/providers/poe.md

@@ -0,0 +1,73 @@
+---
+summary: "Use Poe API to access Claude, GPT, Gemini, Llama, and hundreds of bots"
+read_when:
+  - You want to use Poe API in Clawdbot
+  - You need access to multiple models with one API key
+---
+# Poe
+
+Poe provides an API at `api.poe.com` that gives access to Claude, GPT, Gemini, Llama, and hundreds of community bots through a single API key.
+
+## Quick start
+
+1. Get an API key from [poe.com/api_key](https://poe.com/api_key)
+2. Enable the plugin and authenticate:
+
+```bash
+clawdbot plugins enable poe
+clawdbot models auth login --provider poe
+```
+
+3. Enter your API key when prompted and select a default model.
+
+## CLI setup
+
+```bash
+clawdbot onboard --auth-choice apiKey --token-provider poe --token "$POE_API_KEY"
+```
+
+## Config snippet
+
+```json5
+{
+  env: { POE_API_KEY: "..." },
+  agents: {
+    defaults: {
+      model: { primary: "poe/claude-sonnet-4.5" }
+    }
+  }
+}
+```
+
+## Available models
+
+| Model ID | Name | Reasoning | Vision | Context |
+|----------|------|-----------|--------|---------|
+| claude-opus-4.5 | Claude Opus 4.5 | No | Yes | 200K |
+| claude-sonnet-4.5 | Claude Sonnet 4.5 | No | Yes | 200K |
+| claude-haiku-4.5 | Claude Haiku 4.5 | No | Yes | 200K |
+| claude-code | Claude Code | No | Yes | 200K |
+| gpt-5.2-codex | GPT-5.2 Codex | No | Yes | 128K |
+| gpt-5.1-codex | GPT-5.1 Codex | No | Yes | 128K |
+| gpt-5.1-codex-mini | GPT-5.1 Codex Mini | No | Yes | 128K |
+| gpt-5.1-codex-max | GPT-5.1 Codex Max | No | Yes | 128K |
+| o3-pro | o3 Pro | Yes | Yes | 128K |
+| gemini-3-pro | Gemini 3 Pro | No | Yes | 128K |
+| gemini-3-flash | Gemini 3 Flash | No | Yes | 128K |
+| grok-4 | Grok 4 | No | Yes | 128K |
+| deepseek-r1 | DeepSeek R1 | Yes | No | 128K |
+| deepseek-v3.2 | DeepSeek V3.2 | No | No | 128K |
+
+Model IDs match the Poe API. Access additional bots by adding them to `models.providers.poe.models`.
+
+## Notes
+
+- Rate limit: 500 requests per minute
+- Bot names are case-sensitive (use exact names from poe.com)
+- Pricing varies by bot; check poe.com for current rates
+
+## Troubleshooting
+
+**401 Unauthorized**: Your API key may be invalid or expired. Get a new key from [poe.com/api_key](https://poe.com/api_key).
+
+**Model not found**: Verify the bot name is correct and available on your Poe account. Bot names are case-sensitive.