Start with the connection type
The fix depends on whether you are using WebView, API, or a local runtime. Open the provider settings and confirm the selected mode before troubleshooting.
WebView connection
Confirm online mode
The provider web app needs internet access.
Sign in again
The provider session may have expired.
Allow the window to load
Security tools, VPNs, or network filters may block the provider.
Check the provider
A provider outage or account restriction can prevent access.
API connection
Check the key
Confirm it is active and copied without extra spaces.
Check model access
The account or key must be allowed to use the selected model.
Check billing and limits
Provider credits, spending limits, or rate limits may stop requests.
Do not share the key
Never place it in support messages or screenshots.
Local model connection
Start the runtime
The local service must be open.
Install the model
Confirm the selected model exists locally.
Check the connection address
Use the supported local address and port.
Review resources
Large models may fail when memory or storage is insufficient.
Reconnect safely
Disconnect the provider in LobeWork, close and reopen the provider or runtime, then connect again. Capture unsaved work before restarting.
What to include in a support request
Include the provider name, connection mode, LobeWork version, visible error message, and steps already tried. Remove API keys, passwords, private project data, and provider billing information.
Ask LobeWork about this guide.
The question will be placed into the support widget so you can continue from the exact topic.