✓ Verified 💻 Development ✓ Enhanced Data

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 systemd user 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
Copy the script to your path or run it directly.

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:

bash
secret-manager list

Set a key (interactive prompt):

bash
secret-manager OPENAI_API_KEY
# (Paste key when prompted)

Set a key (direct):

bash
secret-manager DISCORD_BOT_TOKEN "my-token-value"

Supported Keys:

  • OPENAI_API_KEY
  • GEMINI_API_KEY
  • DISCORD_BOT_TOKEN
  • GATEWAY_AUTH_TOKEN
  • OLLAMA_API_KEY
  • GIPHY_API_KEY
  • GOOGLE_PLACES_API_KEY
  • LINKEDIN_LI_AT
  • LINKEDIN_JSESSIONID

Installation

Terminal bash

openclaw install secret-manager
    
Copied!

💻Code Examples

**Set a key (interactive prompt):**

set-a-key-interactive-prompt.sh
secret-manager OPENAI_API_KEY
# (Paste key when prompted)

⚙️Configuration Options

Option Type Default Description
OPENCLAW_CONTAINERstringName of the Distrobox container`clawdbot`
OPENCLAW_HOMEstringPath to OpenClaw config directory`~/.openclaw`
SECRETS_ENV_FILEstringPath to an optional .env file to source`~/.config/openclaw/secrets.env`

Tags

#coding_agents-and-ides #api

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author jswortz
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install secret-manager