openclaw - 💡(How to fix) Fix Skill setup detection false positive when credentials use config files instead of env vars [1 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#59078Fetched 2026-04-08 02:28:58
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Participants
Timeline (top)
labeled ×1

Code Example

IMA_CLIENT_ID="${IMA_OPENAPI_CLIENTID:-$(cat ~/.config/ima/client_id 2>/dev/null)}"

---

requires: { env: ['IMA_OPENAPI_CLIENTID', 'IMA_OPENAPI_APIKEY'] }
RAW_BUFFERClick to expand / collapse

Summary

Problem

When a skill supports credential configuration via config files (with env var as fallback), the OpenClaw skill page still shows "need_setup" even when credentials are properly configured in the file.

Example - ima-skill

The ima-skill supports two credential configuration methods:

  1. Config files (recommended): ~/.config/ima/client_id + ~/.config/ima/api_key
  2. Environment variables: IMA_OPENAPI_CLIENTID + IMA_OPENAPI_APIKEY

The skill code correctly falls back to config files when env vars are not set:

IMA_CLIENT_ID="${IMA_OPENAPI_CLIENTID:-$(cat ~/.config/ima/client_id 2>/dev/null)}"

However, the skill metadata declares:

requires: { env: ['IMA_OPENAPI_CLIENTID', 'IMA_OPENAPI_APIKEY'] }

The skill page UI only checks for the presence of env vars, not the actual credential availability via config file fallback. This results in a false positive "need_setup" status even when credentials are fully configured.

Expected behavior The skill page should either:

Check actual credential availability (not just env var presence), or Support a way for skills to report their own setup status Environment OpenClaw version: 2026.3.31 OS: Linux

Problem to solve

just keep notifying me that ima-skill is need_setup

Proposed solution

Expected behavior The skill page should either:

Check actual credential availability (not just env var presence), or Support a way for skills to report their own setup status

Alternatives considered

No response

Impact

the skills pages,and when openclaw check its skills ,sometimes would ask user to fixes this

Evidence/examples

No response

Additional information

No response

extent analysis

TL;DR

The OpenClaw skill page needs to check actual credential availability instead of just env var presence to accurately reflect the setup status of skills like ima-skill.

Guidance

  • Update the skill page UI to check for credential availability via both config files and env vars.
  • Consider adding a feature for skills to report their own setup status, allowing for more accurate reflections of their configuration.
  • Review the requires section in the skill metadata to ensure it aligns with the actual credential configuration methods supported by the skill.
  • Verify that the fallback mechanism from env vars to config files is correctly implemented in the skill code.

Example

# Example of how the skill code correctly falls back to config files
IMA_CLIENT_ID="${IMA_OPENAPI_CLIENTID:-$(cat ~/.config/ima/client_id 2>/dev/null)}"

This example shows how the skill code is designed to use config files as a fallback when env vars are not set, but the skill page UI does not currently reflect this.

Notes

The current implementation only checks for the presence of env vars, leading to a false positive "need_setup" status even when credentials are fully configured via config files. This issue highlights the need for a more comprehensive check of credential availability.

Recommendation

Apply a workaround by modifying the skill page UI to check actual credential availability, as upgrading to a fixed version is not mentioned in the issue. This approach addresses the immediate problem and provides a more accurate reflection of the skill's setup status.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING