/install infisical-reader
Infisical
Read secrets from Infisical via REST API.
User Setup
- Create Machine Identity: Organization → Access Control → Machine Identities.
- Add Universal Auth to the identity → save Client ID + Client Secret.
- Grant identity access to each project: Project Settings → Access Control → Identities → add as Member.
- Store credentials in
~/.openclaw/.env:
INFISICAL_CLIENT_ID=\x3Cclient-id>
INFISICAL_CLIENT_SECRET=***
Agent Workflow
POST /api/v1/auth/universal-auth/login→{"clientId":"...","clientSecret":"***"}→accessTokenGET /api/v1/workspace→ list projects (id, slug, environments)GET /api/v3/secrets/raw?workspaceId=\x3Cid>&environment=\x3Cenv>&secretPath=/→ secrets
Script
# List projects
python3 {baseDir}/scripts/infisical.py --list-projects
# Read all secrets
python3 {baseDir}/scripts/infisical.py -w \x3CworkspaceId> -e prod
# Get single secret (raw value)
python3 {baseDir}/scripts/infisical.py -w \x3Cwid> -e prod -k OPENAI_API_KEY --raw
Requires INFISICAL_CLIENT_ID and INFISICAL_CLIENT_SECRET in ~/.openclaw/.env.
Notes
- Use
workspaceId(notprojectSlug) — slug may not work in all API versions. - Tokens are short-lived; re-authenticate each session.
- Too many failed logins temporarily locks Universal Auth.
- Free tier: up to 5 Machine Identities.
- Detailed API reference: see
{baseDir}/references/api.md
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install infisical-reader - After installation, invoke the skill by name or use
/infisical-reader - Provide required inputs per the skill's parameter spec and get structured output
What is Infisical Reader?
Direct REST API reader for Infisical secrets. Lightweight, no middleware. Use when the agent needs to fetch API keys or credentials from Infisical. It is an AI Agent Skill for Claude Code / OpenClaw, with 36 downloads so far.
How do I install Infisical Reader?
Run "/install infisical-reader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Infisical Reader free?
Yes, Infisical Reader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Infisical Reader support?
Infisical Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Infisical Reader?
It is built and maintained by Jau Hofu (@achikochikorogaru); the current version is v1.0.0.