📦 1. Installing OpenClaw — Smooth and Simple
OpenClaw has been everywhere lately, so I finally decided to give it a shot. The installation was surprisingly painless:
The script handled all dependencies automatically, and the interactive wizard walked me through the basic setup. Within ten minutes, that little lobster icon was up and running in my terminal. I thought, "This is way easier than I expected."
🔌 2. Connecting Models: OpenRouter Works, But…
With the lobster installed, it was time to give it a brain. My first stop was OpenRouter—an old friend at this point.
OpenRouter has a massive model catalog, over 300 of them. All my daily drivers—GPT, Claude, Gemini,are right there. I followed their docs, plugged in my API key, and formatted the model references as openrouter//. Tested it, and it worked. The integration itself wasn't the issue.
The friction came every time I wanted to add a new model.
I'd have to go back to OpenRouter's docs, look up the exact model identifier, confirm the contextWindow, check if it supported multimodal inputs, note the pricing, and then manually add another entry to my models.json. After adding a few models, my config file became bloated and hard to manage.
I kept thinking: Is there a platform that can just handle this configuration for me?
If you know any tools or tricks that make this easier, please drop them in the comments. I genuinely need them 🙏
🔍 3. Stumbling Upon BasicRouter.ai
While searching for a more hands-off solution, I happened to land on BasicRouter.ai.
At first glance, the model count is noticeably smaller than OpenRouter's—around 50 versus 300+. But as I scanned the list, I realized nearly every model I actually use day-to-day was there: GPT-4o, Claude Sonnet 4.6, Gemini, Kimi, Qwen. Scrolling further, I also spotted image generation (Kling-image, Qwen-image) and video generation (Kling, Seedence, Wan). More than enough for my needs.
📄 4. The Pleasant Surprise: A Dedicated OpenClaw Integration Guide
What really made me decide to try BasicRouter was a specific article in their documentation:
"How to Integrate BasicRouter Platform API into OpenClaw"
This wasn't the typical "We're OpenAI-compatible, figure it out yourself" note. It clearly explained the role of OpenClaw's three key configuration files:
| File | Purpose |
|------|---------|
| models.json | Defines providers, baseUrl, and model parameters |
| openclaw.json | Registers authentication profiles and sets default models |
| auth-profiles.json | Stores API keys separately (secure and easy to rotate) |
Even better, every step came with complete, copy-paste ready JSON blocks. I didn't have to guess contextWindow or maxTokens values—they were already filled in with sensible defaults. I just needed to swap in the model IDs I wanted.
Here's a snippet of how I configured BasicRouter in models.json:
And the API key stored separately in auth-profiles.json:
The whole setup took less than ten minutes—way faster than digging through individual provider docs.
✅ 5. It Just Worked
After updating the configs and restarting OpenClaw, I ran a few quick tests:
| Task | Model | Result |
|------|-------|--------|
| Text summarization | Claude 4.6 | ✅ Instant response |
| Image generation | Qwen-image | ✅ Image ready in seconds |
| Video generation | Kling | ✅ Clip done in under a minute |
Switching between models was seamless—just change basicrouter/ in the prompt.
Also worth mentioning: BasicRouter gave me $5 in free credits just for signing up. After all those tests—text, images, video—I'd used less than $2.
🏁 Final Thoughts
OpenClaw itself is easy to set up. The real time sink is finding and configuring the "food" to feed it. OpenRouter solved the availability problem—I could access almost any model I wanted. But BasicRouter solved the friction problem, especially with that dedicated OpenClaw integration guide. For a lazy developer like me, that kind of hand-holding is a lifesaver.
How are you all handling model integration with OpenClaw? Got any tips or tricks to make it even smoother? Let me know in the comments! 🦞
Top comments (0)