OpenClaw Hyperspell Plugin

OpenClaw plugin for Hyperspell - Context and memory for your AI agents.

Installation

openclaw plugins install @hyperspell/openclaw-hyperspell

Quick Start

Run the interactive setup wizard:

openclaw openclaw-hyperspell setup

The setup wizard will guide you through:

1. Creating a Hyperspell account (if you don't have one)
2. Configuring your API key
3. Setting up your User ID for multi-tenant memory
4. Connecting your apps (Notion, Slack, Google Drive, etc.)

Manual Configuration

Alternatively, add to your openclaw.json:

{
  "plugins": {
    "entries": {
      "openclaw-hyperspell": {
        "enabled": true,
        "config": {
          "apiKey": "${HYPERSPELL_API_KEY}",
          "userId": "your-email",
          "autoContext": true
        }
      }
    }
  }
}

Or set the environment variable:

export HYPERSPELL_API_KEY=hs_...

CLI Commands

openclaw openclaw-hyperspell setup

Interactive setup wizard that walks you through configuration.

openclaw openclaw-hyperspell status

Check your current configuration and connection status.

openclaw openclaw-hyperspell connect

Open the Hyperspell connect page to link your accounts (Notion, Slack, Google Drive, etc.)

Options

Option	Type	Default	Description
apiKey	string	${HYPERSPELL_API_KEY}	Hyperspell API key
userId	string	-	User ID (can be your email)
autoContext	boolean	true	Auto-inject relevant memories before each AI turn
sources	string	-	Comma-separated sources to search (e.g., notion,slack)
maxResults	number	10	Maximum memories per context injection
debug	boolean	false	Enable verbose logging

Slash Commands

/getcontext <query>

Search your memories for relevant context.

/getcontext Q1 budget planning

/remember <text>

Save something to memory.

/remember Meeting with Alice: discussed Q1 budget, need to follow up on headcount

AI Tools

The plugin registers tools that the AI can use autonomously:

• hyperspell_search - Search through connected sources
• hyperspell_remember - Save information to memory

Auto-Context

When autoContext: true (default), the plugin automatically:

1. Intercepts each user message before the AI responds
2. Searches Hyperspell for relevant memories
3. Injects matching context into the AI's prompt

This ensures the AI always has access to relevant information from your connected sources.

Available Sources

• vault - User-created memories
• notion - Notion pages and databases
• slack - Slack messages
• google_calendar - Google Calendar events
• google_mail - Gmail messages
• google_drive - Google Drive files
• box - Box files
• web_crawler - Crawled web pages