Gareth Jones 8db61b8548 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>

2026-01-25 08:27:10 -08:00

2.2 KiB

Raw Blame History

summary

read_when

Use Poe API to access Claude, GPT, Gemini, Llama, and hundreds of bots

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

Get an API key from poe.com/api_key
Enable the plugin and authenticate:

clawdbot plugins enable poe
clawdbot models auth login --provider poe

Enter your API key when prompted and select a default model.

CLI setup

clawdbot onboard --auth-choice apiKey --token-provider poe --token "$POE_API_KEY"

Config snippet

{
  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.

Model not found: Verify the bot name is correct and available on your Poe account. Bot names are case-sensitive.

2.2 KiB Raw Blame History

Poe