Debug Inference

Diagnose why OpenShell inference is failing and recommend exact fix commands.

Use openshell CLI commands to inspect the active gateway, provider records, managed inference config, and sandbox behavior. Use a short sandbox probe when needed to confirm end-to-end routing.

Overview

OpenShell supports two different inference paths. Diagnose the correct one first.

1. Managed inference through https://inference.local
   • Configured by openshell inference set
   • Shared by every sandbox on the active gateway
   • Credentials and model are injected by OpenShell
2. Direct external inference to hosts like api.openai.com
   • Controlled by network_policies
   • Requires the application to call the external host directly
   • Requires provider attachment and network access to be configured separately