satori

What This Skill Does

Satori is an authoritative long-term memory system designed for AI agents, ensuring continuity across sessions, providers, and tools. Unlike ephemeral chat history, Satori stores notable facts in a persistent, searchable database via the @satori-sh/cli. This skill acts as the agent's "source of truth." Whenever a user asks to recall a preference, project detail, or past decision, the agent utilizes Satori to retrieve context. It bridges the gap between disconnected AI interactions, allowing the agent to remember technical stacks, specific project deadlines, or personal preferences indefinitely.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/joelachance/skills

Once installed, the skill automatically handles its own configuration. On its first execution, the Satori CLI checks for credentials in ~/.config/satori/satori.json. If missing, it provisions new credentials automatically, requiring no manual setup from the user.

Use Cases

1. Cross-Session Continuity: Remember complex architectural decisions or project requirements discussed weeks ago.
2. Personalized Development: Store specific technology preferences (e.g., "always use Bun over Node.js") so the agent applies them consistently.
3. Knowledge Retrieval: Quickly surface status updates or project notes for ongoing development tasks.
4. Contextual Awareness: Automatically look up relevant project entities at the start of a new chat session to provide informed, relevant assistance.

Example Prompts

• "Remember that I prefer to use PostgreSQL for all my database schemas and TypeScript for the frontend."
• "What were the key decisions we made regarding the API structure for the current project?"
• "I'm starting a new task on the dashboard component; search Satori for any existing notes about the current implementation."

Tips & Limitations

• Be Specific: Write clear, standalone facts. Instead of saying "Used React," say "The project uses React 18 with Vite for the build system."
• Proactive Retrieval: Allow your agent to search Satori automatically when starting a new session to ensure it has the necessary context without manual intervention.
• Storage Limits: While Satori handles long-form text, focus on high-signal information such as deadlines, tech stacks, and architectural decisions to maintain high retrieval relevance.