supermemory-free

What This Skill Does

Supermemory-free is an essential utility for OpenClaw users who require cross-session persistence and long-term knowledge management. This skill leverages the Supermemory.ai free tier API to act as a secondary, external brain for your AI agent. By offloading critical insights, configuration details, and discovered solutions to the cloud, you ensure that your agent doesn't lose valuable context when local memory files or session buffers are cleared. It exclusively utilizes the /v3/documents and /v3/search API endpoints, ensuring compatibility with free-tier accounts while maintaining a lightweight footprint.

Installation

To begin using Supermemory-free, ensure your OpenClaw environment is configured with your unique API key. Add the following line to your .env file: SUPERMEMORY_OPENCLAW_API_KEY="sm_...". After saving your environment variables, ensure you have permissions to execute the Python scripts within the skills folder. For automated maintenance, install the daily cron job by running bash skills/supermemory-free/install_cron.sh. This will automatically scan your recent interaction logs for high-value insights, ensuring that your cloud knowledge base stays updated without manual intervention.

Use Cases

This skill is perfect for scenarios where you need to recall information across different working sessions or even across different machine instances. Use it to store complex troubleshooting steps for your development workflow, configuration schemas that you don't want to redefine, or project-specific requirements that are shared across a team. It is especially useful for managing technical documentation that grows over time and becomes too bulky for standard memory files. The automated capture mechanism is ideal for busy users who want to "set it and forget it" while ensuring that every significant breakthrough is saved securely to the cloud.

Example Prompts

1. "OpenClaw, remember that the production database connection string is stored in the vault at path /etc/secrets/db_config; store this in Supermemory with the tag 'infrastructure'."
2. "Do you remember the solution we found last month for the API timeout error on the user authentication service? Please search Supermemory for it."
3. "Summarize the key takeaways from our project architecture discussions over the last week and push them to the cloud for safekeeping."

Tips & Limitations

To maximize the effectiveness of Supermemory-free, use clear and descriptive tags when storing data to ensure faster retrieval. When searching, utilize the --threshold flag to adjust the balance between precision and recall; a threshold of 0.7 is a great starting point for minimizing irrelevant results. Keep in mind that as this uses the free-tier API, you should be mindful of usage quotas. Additionally, since the auto-capture relies on specific heuristics to identify "high-value" content, important manual findings should always be explicitly saved using the store command to guarantee they are indexed.