Secret Manager
Manage API keys securely via GNOME Keyring and inject them into OpenClaw config.
- Rating
- 4.6 (61 reviews)
- Downloads
- 3,252 downloads
- Version
- 1.0.0
Overview
Manage API keys securely via GNOME Keyring and inject them into OpenClaw config.
Complete Documentation
View Source →
Secret Manager
A secure way to manage API keys for OpenClaw using the system keyring (GNOME Keyring / libsecret).
This skill provides a secret-manager CLI that:
- Stores API keys securely using
secret-tool. - Injects them into your
auth-profiles.json. - Propagates them to
systemduser environment. - Restarts the OpenClaw Gateway service inside your Distrobox container.
Installation
Ensure you have the dependencies:
- Debian/Ubuntu:
sudo apt install libsecret-tools - Fedora:
sudo dnf install libsecret - Arch:
sudo pacman -S libsecret
Configuration
The script uses default paths that work for most OpenClaw installations, but you can override them with environment variables:
| Variable | Description | Default |
| :--- | :--- | :--- |
| OPENCLAW_CONTAINER | Name of the Distrobox container | clawdbot |
| OPENCLAW_HOME | Path to OpenClaw config directory | ~/.openclaw |
| SECRETS_ENV_FILE | Path to an optional .env file to source | ~/.config/openclaw/secrets.env |
Usage
List all configured keys:
secret-manager list
Set a key (interactive prompt):
secret-manager OPENAI_API_KEY
# (Paste key when prompted)
Set a key (direct):
secret-manager DISCORD_BOT_TOKEN "my-token-value"
Supported Keys:
OPENAI_API_KEYGEMINI_API_KEYDISCORD_BOT_TOKENGATEWAY_AUTH_TOKENOLLAMA_API_KEYGIPHY_API_KEYGOOGLE_PLACES_API_KEYLINKEDIN_LI_ATLINKEDIN_JSESSIONID
Installation
openclaw install secret-manager
💻Code Examples
**Set a key (interactive prompt):**
secret-manager OPENAI_API_KEY
# (Paste key when prompted)⚙️Configuration Options
| Option | Type | Default | Description |
|---|---|---|---|
OPENCLAW_CONTAINER | string | Name of the Distrobox container | `clawdbot` |
OPENCLAW_HOME | string | Path to OpenClaw config directory | `~/.openclaw` |
SECRETS_ENV_FILE | string | Path to an optional .env file to source | `~/.config/openclaw/secrets.env` |
Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.