OpenAI-compatible (OpenRouter, Groq and other API keys)
An engine that talks straight to OpenRouter, Groq and other services with an OpenAI-style API, using just a key. Hosted and local models use your bot's tools.
When to use it
- You have an OpenRouter or Groq key and nothing else installed.
- You want a particular model from one of those services, with tools, and no program to install.
- You want to try a model quickly before giving it to a bot on another engine.
If the bot needs the built-in browser, or a model from a local server with tools, use Fuigo with the same key instead. Fuigo can use every key you save.
Set it up
Step 1
Open the Models settings
Open SettingsModels & engines.
You're done when: you see the Model connections form.
Step 2
Add your key
Choose Add connection and paste a key. OpenAI-style services Murage knows are OpenAI, OpenRouter, DeepSeek, Mistral, Groq and xAI.
Keys are stored in your computer's secure storage and never shown again.
You're done when: Murage checks the key and loads the provider's model list.
Step 3
Choose the engine for a bot
Open a bot, go to Bot settingsModel, set the Engine to OpenAI-compatible (OpenRouter / Groq) and pick a model from that connection.
You're done when: the bot shows the engine and a model from your connection.
Tools
Connect any OpenAI-compatible engine and your bots use their tools there too. A bot on this engine can:
- hand work to other bots and ask them questions;
- use connected apps through Flux Router;
- use your own MCP servers;
- use a computer, including this computer, a Local VM or a cloud computer;
- use the phone tools on a paired phone;
- search and save memory.
Every action goes through the same approval cards and the same Stop as on every other engine. Set the bot's level in Bot settingsPermissions the same way.
Two things stay the same as before. The built-in browser is not mounted on this engine, so a bot that needs to browse belongs on Fuigo. Local models picked here use tools too. If a particular model or service ignores the tools it is given, switch the bot to Fuigo with the same key.
What works
- Chat and writing with any chat model your keys give you, including models that stream long answers.
- Model picking: models from each OpenAI-style connection in SettingsModels & engines, grouped by connection. Flux Router's models appear here too if Flux Router is connected.
- Local servers: once a local model server is running, its models can be picked here and use your bot's tools. A model whose server won't take tools still chats, and Murage remembers it as text only.
- Memory: anything Murage recalls for the conversation is included with each message.
Known limits
- No built-in browser. A bot that needs to browse belongs on Fuigo.
- No pictures. Attaching an image isn't offered on this engine.
- Tools depend on the model. A service or model that takes no tools gives the bot a plain chat turn. Fuigo with the same key is the reliable route.
- No program to point at. There's no Set CLI… for this engine, because there's no program to point at.
- Subscriptions don't work here. A Claude or ChatGPT subscription doesn't work here. You need an API key from the service.
Advanced: a custom address
Older setups pointed this engine at one address with environment variables: OPENAI_COMPAT_URL for the address (it defaults to OpenRouter), OPENAI_COMPAT_API_KEY for the key and OPENAI_COMPAT_MODEL for the model. Saved connections in SettingsModels & engines are the simpler way now.
Troubleshooting
You see
This engine has no API key yet. Add one in App Settings > Models.Do this
Add a connection in SettingsModels & engines and pick one of its models.
You see
The saved key does not match this legacy endpoint. Connect its provider in Models.Do this
An old address setting and your saved key point at different services. Add the provider as a connection in SettingsModels & engines and pick its models instead.
You see
Provider payment or account access requiredDo this
The service returned a payment error. Check its billing and your access to that model.
You see
The provider rejected the credentials used for this request.Do this
The key is wrong or was revoked. Replace it in SettingsModels & engines.
You see
The provider reported a request limit.Do this
You hit a rate limit or quota. Wait, or pick another model.
You see
A bot says it can't do somethingDo this
If it is the browser, that is expected here. For anything else, the model or service may not take tools. Switch the bot to Fuigo with the same key in Bot settingsModel.