openclaw-add-secret

Stores secrets in macOS Keychain and propagates them across runtime, shell, and provisioning files.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-add-secret-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-add-secret
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/openclaw-skills/skills/openclaw-add-secret
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-add-secret-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding API keys and tokens to an OpenClaw environment often leads to leaked secret values in logs, mismatched environment variable names, and broken disaster recovery when loaders fall out of sync. This Skill standardizes secret onboarding so credentials land in macOS Keychain and every dependent file stays aligned. ## Core Features & Use Cases - Keychain Storage Without Exposure: Reads the secret silently from the terminal and pipes it via stdin to a helper script, keeping values off command-line arguments and shell history. - Naming Enforcement: Derives and validates the Keychain service name (openclaw.<name>) and environment variable (OPENCLAW_<NAME>) so lookups never mismatch. - Multi-File Propagation: Updates openclaw-secrets.sh, openclaw-env.sh, and provisioning secrets.sh, then verifies the mapping resolves and no literal secret leaked into git-tracked files. - Use Case: When adding a new bot token for an OpenClaw gateway, run this Skill to store it in Keychain, wire all shell loaders, and confirm disaster recovery scripts can reprovision it on a new machine. ## Quick Start Ask the agent to add a new OpenClaw secret named my-api-key and wire it into the gateway, shell, and provisioning loaders.

Frequently Asked Questions about openclaw-add-secret

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a secret to macOS Keychain from the terminal?

Read the secret silently with `read -rs`, then pipe it via stdin to the store_keychain_secret.sh helper with the service name and account. Never pass the value as a command-line argument, since argv is visible in process listings and shell history.

How do I add an API key to OpenClaw without exposing it?

Use this Skill to store the key in Keychain under the service `openclaw.<name>`, then wire the derived `OPENCLAW_<NAME>` environment variable into openclaw-secrets.sh, openclaw-env.sh, and secrets.sh. The value never appears in files or logs.

What naming convention does OpenClaw use for secrets?

Keychain services must be `openclaw.<name>` where the name is lowercase with hyphens only. Environment variables must be `OPENCLAW_<NAME>` in uppercase with underscores, and both suffixes must represent the same logical secret.

Why does OpenClaw report a missing environment variable after adding a secret?

A MissingEnvVarError occurs when openclaw-env.sh was not updated alongside openclaw-secrets.sh. Both shell loaders must export the same variable, and secrets.sh must also be updated or disaster recovery reprovisioning will fail.

How do I rotate a compromised OpenClaw secret?

Re-run the Skill with the same secret_name and the new value. The Keychain entry is overwritten and all loaders continue referencing the same derived names, so downstream configuration remains stable.