openclaw - ✅(Solved) Fix Generation tools Not Live despite provider API keys and explicit defaults on v2026.5.3 [1 pull requests, 4 comments, 4 participants]

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…
GitHub stats
openclaw/openclaw#77244Fetched 2026-05-05 05:50:49
View on GitHub
Comments
4
Participants
4
Timeline
6
Reactions
2
Timeline (top)
commented ×4closed ×1cross-referenced ×1

On v2026.5.3, the generation tools remain Enabled / present in catalog but Not Live / absent from effective tools, even though:

  • OPENAI_API_KEY and GEMINI_API_KEY are present in the running Gateway process environment.
  • Explicit generation defaults are configured under agents.defaults.
  • Relevant bundled provider plugins (openai, google) are enabled/loaded.

This looks like a live-detection / effective-tool registry issue rather than missing credentials.

Root Cause

On v2026.5.3, the generation tools remain Enabled / present in catalog but Not Live / absent from effective tools, even though:

  • OPENAI_API_KEY and GEMINI_API_KEY are present in the running Gateway process environment.
  • Explicit generation defaults are configured under agents.defaults.
  • Relevant bundled provider plugins (openai, google) are enabled/loaded.

This looks like a live-detection / effective-tool registry issue rather than missing credentials.

Fix Action

Fixed

PR fix notes

PR #77590: fix(gateway): start configured generation providers

Description (problem / solution / changelog)

Summary

  • Start manifest owners for explicitly configured image, video, and music generation defaults during gateway startup.
  • Keep disabled, denied, and restrictive allowlist plugin policy enforced.
  • Fixes #77244.

Verification

  • pnpm test:serial src/plugins/channel-plugin-ids.test.ts
  • pnpm exec oxfmt --check --threads=1 CHANGELOG.md src/plugins/gateway-startup-plugin-ids.ts src/plugins/channel-plugin-ids.test.ts
  • Blacksmith Testbox tbx_01kqtq796npcqvgzv2ywc4qy99: pnpm check:changed exit 0

Changed files

  • CHANGELOG.md (modified, +1/-0)
  • src/plugins/channel-plugin-ids.test.ts (modified, +56/-0)
  • src/plugins/gateway-startup-plugin-ids.ts (modified, +137/-0)

Code Example

Gateway service: systemd installed · enabled · running
Telegram: OK
WhatsApp: OK / LINKED
Event loop: OK · p99 ~22ms

---

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-codex/gpt-5.5",
        "fallbacks": ["openai-codex/gpt-5.3-codex"]
      },
      "imageGenerationModel": {
        "primary": "openai/gpt-image-2"
      },
      "videoGenerationModel": {
        "primary": "openai/sora-2"
      },
      "musicGenerationModel": {
        "primary": "google/lyria-3-clip-preview"
      }
    }
  },
  "env": {
    "shellEnv": {
      "enabled": true,
      "timeoutMs": 15000
    }
  },
  "plugins": {
    "entries": {
      "openai": { "enabled": true },
      "google": { "enabled": true }
    }
  }
}

---

PID=$(systemctl --user show -p MainPID --value openclaw-gateway.service)
tr '\0' '\n' < /proc/$PID/environ | grep -E '^(OPENAI_API_KEY|GEMINI_API_KEY)=' | sed -E 's/=.*/=present/'

---

GEMINI_API_KEY=present
OPENAI_API_KEY=present

---

openclaw gateway call tools.catalog --json --timeout 15000

---

{
  "id": "media",
  "tools": [
    { "id": "image" },
    { "id": "image_generate" },
    { "id": "music_generate" },
    { "id": "video_generate" },
    { "id": "tts" }
  ]
}

---

openclaw gateway call tools.effective --json --params '{"sessionKey":"agent:main:main"}' --timeout 15000

---

{
  "profile": "full",
  "found": [
    ["core", ["image"]]
  ]
}

---

openclaw gateway call models.authStatus --json --timeout 15000

---

[
  {
    "provider": "openai-codex",
    "displayName": "Codex",
    "status": "ok"
  }
]
RAW_BUFFERClick to expand / collapse

Summary

On v2026.5.3, the generation tools remain Enabled / present in catalog but Not Live / absent from effective tools, even though:

  • OPENAI_API_KEY and GEMINI_API_KEY are present in the running Gateway process environment.
  • Explicit generation defaults are configured under agents.defaults.
  • Relevant bundled provider plugins (openai, google) are enabled/loaded.

This looks like a live-detection / effective-tool registry issue rather than missing credentials.

Environment

  • OpenClaw: v2026.5.3 (06d46f7c)
  • Install/channel: stable
  • OS: Linux 6.17.0-1010-aws x64
  • Node: 22.22.0
  • Gateway: systemd user service
  • Main model: openai-codex/gpt-5.5

openclaw status --deep shows Gateway healthy:

Gateway service: systemd installed · enabled · running
Telegram: OK
WhatsApp: OK / LINKED
Event loop: OK · p99 ~22ms

Config

Relevant sanitized config:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-codex/gpt-5.5",
        "fallbacks": ["openai-codex/gpt-5.3-codex"]
      },
      "imageGenerationModel": {
        "primary": "openai/gpt-image-2"
      },
      "videoGenerationModel": {
        "primary": "openai/sora-2"
      },
      "musicGenerationModel": {
        "primary": "google/lyria-3-clip-preview"
      }
    }
  },
  "env": {
    "shellEnv": {
      "enabled": true,
      "timeoutMs": 15000
    }
  },
  "plugins": {
    "entries": {
      "openai": { "enabled": true },
      "google": { "enabled": true }
    }
  }
}

The Gateway process environment also has the keys:

PID=$(systemctl --user show -p MainPID --value openclaw-gateway.service)
tr '\0' '\n' < /proc/$PID/environ | grep -E '^(OPENAI_API_KEY|GEMINI_API_KEY)=' | sed -E 's/=.*/=present/'

Output:

GEMINI_API_KEY=present
OPENAI_API_KEY=present

Observed behavior

tools.catalog includes generation tools

openclaw gateway call tools.catalog --json --timeout 15000

Relevant result:

{
  "id": "media",
  "tools": [
    { "id": "image" },
    { "id": "image_generate" },
    { "id": "music_generate" },
    { "id": "video_generate" },
    { "id": "tts" }
  ]
}

tools.effective does not include generation tools

openclaw gateway call tools.effective --json --params '{"sessionKey":"agent:main:main"}' --timeout 15000

Relevant result:

{
  "profile": "full",
  "found": [
    ["core", ["image"]]
  ]
}

image_generate, video_generate, and music_generate are absent.

models.authStatus only shows Codex OAuth

openclaw gateway call models.authStatus --json --timeout 15000

Relevant result:

[
  {
    "provider": "openai-codex",
    "displayName": "Codex",
    "status": "ok"
  }
]

No direct openai or google provider auth appears, despite the API keys being present in the Gateway process env.

Attempted fixes

  • Confirmed systemd override contains the provider keys.
  • Confirmed /proc/<gateway-pid>/environ has OPENAI_API_KEY and GEMINI_API_KEY.
  • Set explicit defaults for image/video/music generation.
  • Enabled env.shellEnv.
  • Confirmed openai and google bundled plugins are enabled/loaded via openclaw plugins inspect.
  • Ran openclaw plugins registry --refresh.
  • Restarted Gateway multiple times.

Result: generation tools still Not Live / absent from effective tools.

Expected behavior

With explicit defaults and provider API keys present in the Gateway process environment:

  • image_generate should be Live via openai/gpt-image-2.
  • video_generate should be Live via openai/sora-2.
  • music_generate should be Live via google/lyria-3-clip-preview.

Actual behavior

  • tools.catalog lists the generation tools.
  • tools.effective omits all three generation tools.
  • Control UI shows them as Enabled but Not Live.
  • models.authStatus does not surface direct openai or google auth, only openai-codex.

Notes

This was seen after upgrading to v2026.5.3. The same install previously had several Enabled-but-Not-Live tool symptoms on v2026.5.2, then rolled back; v2026.5.3 fixed other things (WhatsApp plugin/channel is now live after installing the external plugin), but generation tool liveness still seems stuck.

extent analysis

TL;DR

The generation tools are not live due to a potential issue with the authentication status of the openai and google providers, despite having the required API keys present in the environment.

Guidance

  • Verify that the OPENAI_API_KEY and GEMINI_API_KEY are correctly set in the systemd override file and are being passed to the Gateway process.
  • Check the models.authStatus output to confirm that the openai and google providers are authenticated correctly, as only openai-codex is shown as authenticated.
  • Investigate the possibility of a version-specific issue, as the problem persists after upgrading to v2026.5.3, and consider rolling back to a previous version if possible.
  • Review the configuration files and environment variables to ensure that there are no typos or inconsistencies in the provider names or API keys.

Example

No code snippet is provided as the issue seems to be related to configuration and environment variables rather than code.

Notes

The issue may be specific to the v2026.5.3 version, and further investigation is needed to determine the root cause. The fact that models.authStatus only shows openai-codex as authenticated suggests that there may be an issue with the authentication mechanism for the openai and google providers.

Recommendation

Apply a workaround by checking the authentication status of the openai and google providers and ensuring that the required API keys are correctly set in the environment. If the issue persists, consider rolling back to a previous version or seeking further assistance.

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…

FAQ

Expected behavior

With explicit defaults and provider API keys present in the Gateway process environment:

  • image_generate should be Live via openai/gpt-image-2.
  • video_generate should be Live via openai/sora-2.
  • music_generate should be Live via google/lyria-3-clip-preview.

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

openclaw - ✅(Solved) Fix Generation tools Not Live despite provider API keys and explicit defaults on v2026.5.3 [1 pull requests, 4 comments, 4 participants]