Issue Station
Sign In
Tools hereToolbox

hermes - 💡(How to fix) Fix Nous Tool Gateway returns 401 despite successful Nous OAuth and managed tools available

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

body: {"error":{"code":"AUTH_ERROR","message":"Unauthorized"},"requestId":"473a7e67-92a0-4966-8a89-ac4b4fd70178"} body: {"error":{"code":"AUTH_ERROR","message":"Unauthorized"},"requestId":"0f9944a8-b156-4c85-95df-47ea0860a6af"}

Code Example

hermes auth status nous
nous: logged in

hermes status
Nous Portal         ✓ logged in
Nous Portal         ✓ managed tools available
Web tools           ✓ active via Nous subscription
Image generation    ✓ active via Nous subscription
Browser automation  ✓ active via Nous subscription

---

read_nous_access_token: True
firecrawl ready=True origin=https://firecrawl-gateway.nousresearch.com has_token=True
fal-queue ready=True origin=https://fal-queue-gateway.nousresearch.com has_token=True
browser-use ready=True origin=https://browser-use-gateway.nousresearch.com has_token=True

---

web_search -> AUTH_ERROR Unauthorized
web_extract -> AUTH_ERROR Unauthorized
image_generate -> Nous Subscription gateway rejected model 'fal-ai/z-image/turbo' (HTTP 401)

---

POST https://firecrawl-gateway.nousresearch.com/v2/search
status: 401
x-request-id: 473a7e67-92a0-4966-8a89-ac4b4fd70178
body: {"error":{"code":"AUTH_ERROR","message":"Unauthorized"},"requestId":"473a7e67-92a0-4966-8a89-ac4b4fd70178"}

POST https://firecrawl-gateway.nousresearch.com/v2/search
status: 401
x-request-id: 0f9944a8-b156-4c85-95df-47ea0860a6af
body: {"error":{"code":"AUTH_ERROR","message":"Unauthorized"},"requestId":"0f9944a8-b156-4c85-95df-47ea0860a6af"}

---

web:
  backend: firecrawl
  use_gateway: true

image_gen:
  provider: fal
  model: fal-ai/z-image/turbo
  use_gateway: true

---

hermes auth add nous --type oauth

---

hermes auth status nous
hermes status

---

web_search
web_extract
image_generate
RAW_BUFFERClick to expand / collapse

Bug Description

Hermes OAuth for Nous Portal succeeds and hermes status reports managed tools available, but Nous Tool Gateway requests for Firecrawl and FAL are rejected with HTTP 401.

This was reproduced after a clean reauth: stale Nous credentials were removed from the default and sos-toulon profile auth stores, the stale shared nous_auth.json was archived, then hermes auth add nous --type oauth completed successfully.

Expected Behavior

With a paid Nous Portal subscription and use_gateway: true, web search/extract and image generation should route through the Nous Tool Gateway without requiring direct FIRECRAWL_API_KEY or FAL_KEY.

Official docs reference:

Actual Behavior

Auth and local gateway resolution look successful:

hermes auth status nous
nous: logged in

hermes status
Nous Portal         ✓ logged in
Nous Portal         ✓ managed tools available
Web tools           ✓ active via Nous subscription
Image generation    ✓ active via Nous subscription
Browser automation  ✓ active via Nous subscription

Local resolver also reports gateway readiness for all managed vendors:

read_nous_access_token: True
firecrawl ready=True origin=https://firecrawl-gateway.nousresearch.com has_token=True
fal-queue ready=True origin=https://fal-queue-gateway.nousresearch.com has_token=True
browser-use ready=True origin=https://browser-use-gateway.nousresearch.com has_token=True

But tool calls fail:

web_search -> AUTH_ERROR Unauthorized
web_extract -> AUTH_ERROR Unauthorized
image_generate -> Nous Subscription gateway rejected model 'fal-ai/z-image/turbo' (HTTP 401)

Direct Firecrawl gateway checks using the active Nous token return HTTP 401:

POST https://firecrawl-gateway.nousresearch.com/v2/search
status: 401
x-request-id: 473a7e67-92a0-4966-8a89-ac4b4fd70178
body: {"error":{"code":"AUTH_ERROR","message":"Unauthorized"},"requestId":"473a7e67-92a0-4966-8a89-ac4b4fd70178"}

POST https://firecrawl-gateway.nousresearch.com/v2/search
status: 401
x-request-id: 0f9944a8-b156-4c85-95df-47ea0860a6af
body: {"error":{"code":"AUTH_ERROR","message":"Unauthorized"},"requestId":"0f9944a8-b156-4c85-95df-47ea0860a6af"}

Steps to Reproduce

  1. Configure Hermes with Nous Tool Gateway enabled:
web:
  backend: firecrawl
  use_gateway: true

image_gen:
  provider: fal
  model: fal-ai/z-image/turbo
  use_gateway: true
  1. Run clean Nous OAuth:
hermes auth add nous --type oauth
  1. Verify:
hermes auth status nous
hermes status
  1. Call:
web_search
web_extract
image_generate

Environment

  • Hermes version: v0.13.0 (2026.5.7)
  • OS: macOS
  • Provider in active profile: OpenAI Codex as primary; Nous Portal auth configured for subscription/tool gateway
  • Direct Firecrawl/FAL keys intentionally not configured; expected route is Nous Tool Gateway

Notes

No secrets/tokens are included here. The local OAuth currently reports nous: logged in; this issue is specifically that Tool Gateway requests are rejected with 401 despite Hermes reporting managed tools available.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#dependency error#configuration error#environment variable#network issue

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix Nous Tool Gateway returns 401 despite successful Nous OAuth and managed tools available