Use Poolside models in OpenClaw

​

Watch the setup video

​

Prerequisites

• You have OpenClaw installed. For installation options, see the OpenClaw documentation.
• You have one of the following:
  • A Poolside Platform API key. To create one, go to platform.poolside.ai.
  • An API key for your organization’s Poolside deployment.

​

Steps

1. Install the Poolside provider plugin from ClawHub.
   openclaw plugins install clawhub:@poolside/openclaw-provider
   
2. Authenticate with Poolside.
   • Poolside Platform
   • Poolside deployment

   openclaw onboard --classic
   

   Review and accept the security disclaimer, select the default quick-start setup mode, then select Poolside when prompted for your primary authentication and model provider. Paste your Poolside API key when prompted.

   If you run Poolside on your own infrastructure, set the base URL to your deployment’s OpenAI-compatible endpoint instead. Replace <api-domain> with your deployment’s host. The path is /openai/v1.

   • Add your deployment API key to ~/.openclaw/.env on the Gateway host:
     POOLSIDE_API_KEY=<api-key>
     
   • Set the provider’s base URL to your deployment’s OpenAI-compatible endpoint:
     openclaw config set models.providers.poolside.baseUrl "https://<api-domain>/openai/v1"
     
   • Restart the Gateway to load the API key and base URL:
     openclaw gateway restart
     
3. Set a default model.
   openclaw models set <poolside-model-id>
   
   The plugin registers the available Poolside models. To find model IDs for your access method, see List available models. To switch models for one chat without changing the default, use the /model command in the chat.
4. Send your first prompt. Start an agent session or send a message on a connected channel. Use a prompt that is specific and has a clear expected result, such as one of these examples:
   Every morning at 08:00, check the 10 trending papers on Hugging Face (sorted by upvotes).
   - For each paper, show: title, upvotes, GitHub repo (if any), and a 1-line AI summary.
   - Notify me when you notice a spike in upvotes for a given paper.
   
   Ask me five questions to get to know how I work, then update your USER file with what you learn.
   
   Confirm OpenClaw responds using the selected Poolside model. To check the primary model and provider authentication directly, run openclaw models status.

​

Related resources

• Coding agents
• Poolside API
• Supported models
• OpenClaw documentation