Troubleshooting

gw-link Troubleshooting and FAQ

When you hit 401, 404, missing-model, wrong base_url or failed requests, work through this checklist to locate the problem fast.

Auth errors

Check the API key is copied in full and still valid.

Address errors

Confirm the base_url points at gw-link's OpenAI-compatible endpoint.

Model errors

Confirm the model name configured in your tool is available in gw-link.

Troubleshooting checklist

  1. Verify the key with a minimal request first.
  2. Check the base_url includes the correct path.
  3. Confirm the model name and permission settings.

常见问题

What usually causes a 401?

Typically a wrong or expired API key, insufficient permission, or a tool reading a stale environment variable.