spirit

What This Skill Does

SPIRIT (State Preservation & Identity Resurrection Infrastructure Tool) is a critical utility for OpenClaw agents designed to ensure that an agent's identity, personality, and memory persist across device migrations or system resets. By leveraging a private Git repository as a storage backend, SPIRIT tracks key configuration files and historical logs. With the introduction of Workspace Mode, it now allows developers to symlink their configuration directly into their OpenClaw workspace, enabling seamless editing of tracking preferences without leaving the primary file environment.

Installation

To install the SPIRIT skill, run the following command in your terminal: brew install TheOrionAI/tap/spirit

Ensure you have Git installed, as it serves as the underlying version control system for your identity state. If you prefer to use GitHub authentication, install the GitHub CLI using brew install gh. Once installed, initialize your agent identity using spirit init to create the local repository structure.

Use Cases

1. Multi-Device Syncing: Maintain a consistent persona and memory bank across multiple workstations or cloud environments.
2. Disaster Recovery: Protect your agent's hard-earned identity and project context from hardware failure or accidental file deletion.
3. Versioned Evolution: Track how your agent's 'soul' and personality guidelines change over time using Git commits.
4. Seamless Development: Use Workspace Mode to integrate identity management into your existing project directories, keeping your file system clean and centralized.

Example Prompts

• "Spirit, back up my current memory bank and soul configuration to the remote Git repository immediately."
• "Initialize my workspace in /root/.openclaw/workspace and configure the agent named 'Orion' with the galaxy emoji."
• "Update my .spirit-tracked configuration to include the /archive folder in the next synchronization cycle."

Tips & Limitations

• Tip: Always keep your Git repository private to prevent unauthorized access to your agent's conversation logs and personal identity markers.
• Tip: Use SSH keys for Git remote authentication to automate the syncing process without needing the GitHub CLI or interactive prompts.
• Limitation: SPIRIT requires an existing Git remote. It does not provide its own cloud storage but relies on your personal or organization's Git infrastructure.
• Limitation: Be mindful of what you include in .spirit-tracked; sensitive data inside your memory logs will be pushed to the remote repository, so ensure your remote target is secure.