A Meta Skill that automates API key management and state persistence through native conversational prompts for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install skill-state-manager
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install skill-state-manager using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Skill State Manager (SSM)?
The Skill State Manager (SSM) is a powerful Meta Skill designed to streamline the authentication workflow for AI coding agents. Instead of manual configuration of environment variables or hardcoded secrets, SSM provides a native conversational experience that allows agents to request, store, and manage API keys on the fly. By integrating this capability into Openclaw Skills, developers can ensure their AI assistants handle third-party integrations with Jira, Notion, and custom APIs seamlessly while maintaining secure local storage across different platforms.
Skill State Manager (SSM) Use Cases
- Triggering authentication workflows when a custom tool requires secret keys
- Automatically handling 401 or 403 unauthorized errors during API calls
- Centralizing state persistence for multi-tool workflows without manual config
- Eliminating the need for manual .env file editing in AI CLI environments
How Skill State Manager (SSM) Works
- The AI agent detects a need for credentials or encounters an authentication failure during tool execution.
- The system checks the local environment to identify the platform, such as Claude Code or Codex.
- SSM searches for existing credentials in platform-specific global storage directories like ~/.ai-skills-state/.
- If credentials are missing, the agent prompts the user directly in the chat for the required token or secret.
- Upon receipt, the agent writes the data to a secure local JSON file and resumes the original workflow immediately.
Skill State Manager (SSM) Setup
The Skill State Manager is typically integrated into the system prompt or skill manifest of your AI agent. To ensure the storage directories are prepared for Openclaw Skills, you can use the following commands:
# Create default state directory
mkdir -p ~/.ai-skills-state/
# For Claude Code specific environments
mkdir -p ~/.claude/skills-state/
Once directories are established, the SSM logic will manage file creation and updates automatically during your chat sessions.
Skill State Manager (SSM) Data Schema & Taxonomy
SSM organizes data into platform-specific directories with a simple JSON structure per tool. For example, a Jira integration would create a jira-tool.json file.
| Path | Description |
|---|---|
| ~/.claude/skills-state/ | Storage for Claude Code specific skill states |
| ~/.ai-skills-state/ | Generic storage for other CLI agents using Openclaw Skills |
| Contains key-value pairs of required secrets and persistent metadata |
Skill State Manager (SSM) Advanced Features
- Automatic platform detection for environment-specific storage path resolution
- Real-time secret recovery and injection during active agentic workflows
- Seamless integration with custom third-party API tools via Openclaw Skills
- Native conversational auth logic that prevents workflow disruption and context loss
SKILL.md
Loading
Related Openclaw Skills
Skill Index
An automated inventory management tool that scans, categorizes, and indexes your entire collection of Openclaw Skills.
Claude Code Integration for OpenClaw
A professional-grade programming integration that bridges the Claude Code CLI with OpenClaw for autonomous software engineering tasks.
Memory Dream
Memory Dream is a structured memory classification and periodic consolidation system designed to keep Openclaw Skills agents efficient and context-aware.
voice-minimax
A professional integration that converts text into natural speech using MiniMax TTS and delivers it as voice messages or files to Lark via lark-cli.
GitHub Iteration Workflow
A complete end-to-end automation skill for managing GitHub Issues from initial fetching to final deployment.
1Password CLI Manager
A secure integration layer for managing 1Password secrets and vault access within AI agent environments.
Featured*
