OpenClaw

Add persistent long-term memory and Wiki transcript capture to OpenClaw across Telegram, WhatsApp, Discord, Slack, and more with Tvix's universal knowledge layer.

Persistent long-term memory for OpenClaw, powered by Tvix. Works across Telegram, WhatsApp, Discord, Slack, and any other channel OpenClaw supports. The plugin can preserve conversation transcripts in Wiki, recall relevant Memory and Wiki context, and use Tvix's hybrid retrieval layer across sessions.

How It Works

Once installed, Auto-Capture runs automatically with no extra configuration:

• Auto-Capture (on by default): After conversations, user and assistant messages are buffered and saved as original transcript documents in Tvix Wiki.
• Auto-Recall (off by default): When enabled, the plugin searches memory context before every AI turn and injects relevant snippets. Casual chat is skipped to keep things focused.
• Auto Wiki Recall (off by default): When enabled, the plugin also prefetches wiki documents before every AI turn for factual context and references.
• Knowledge Graph: Unlike simple vector memory, Tvix organizes entities, relationships, and facts into a knowledge graph. Search results include related context for richer responses.

Setup

Install the Tvix plugin

```bash theme={null}
openclaw plugins install @tvix/openclaw-tvix
```

Restart OpenClaw after installing.

Log in to Tvix

```bash theme={null}
openclaw tvix login
```

A browser window opens automatically for OAuth authentication. Tokens are saved automatically, so there are no API keys to manage.

Start using Tvix in OpenClaw

Tvix is now active. Conversation transcripts are automatically captured to Wiki. To also inject memories before each AI response, enable Auto-Recall by asking your AI: `"Enable auto-recall for Tvix"`.

Configuring Tvix

The simplest way to change Tvix settings is to just ask your AI in a conversation. No need to edit config files manually.

Auto-Recall (inject past memories before each response):

"Enable auto-recall for Tvix"
"Turn off auto-recall"

Auto Wiki Recall (inject wiki docs before each response):

"Enable auto wiki recall for Tvix"
"Turn off auto wiki recall"

Auto-Capture (automatically save conversation transcripts to Wiki):

"Stop capturing my conversations to Tvix"
"Re-enable auto-capture"

Memory context size (how much memory is injected per turn, 500–16000 chars):

"Set my Tvix recall limit to 8000 characters"
"Reduce the memory context to 2000 characters"

The AI will update ~/.openclaw/openclaw.json and ask you to restart the OpenClaw gateway for the change to take effect. Alternatively, you can edit the config directly. See the Configuration section below.

AI Tools

The AI uses these tools autonomously during conversations. The tvix_* names below are OpenClaw's plugin-side wrappers around the corresponding Tvix MCP tools.

CLI Commands

openclaw tvix login              # OAuth login (PKCE)
openclaw tvix logout             # Remove stored tokens
openclaw tvix search <query>     # Search memories
openclaw tvix search <query> -s slack,gmail  # Filter by source
openclaw tvix wiki-search <query>            # Search wiki documents
openclaw tvix wiki-search <query> --project "Docs"        # Filter by Project
openclaw tvix wiki-search <query> --collection-id <uuid>  # Filter by Project UUID
openclaw tvix wiki-add "<title>" --content "<markdown>"   # Add wiki doc
openclaw tvix wiki-add "<title>" --content "<markdown>" --project "Docs"
openclaw tvix wiki-update <docId> --title "<new title>"   # Update wiki doc
openclaw tvix wiki-update <docId> --clear-project         # Move to Basic
openclaw tvix wiki-delete <docId>            # Delete wiki doc
openclaw tvix status             # Check API connectivity

Auto-Recall

Runs before every AI response (before_agent_start hook) when enabled.

Queries Tvix for relevant memories and wiki docs and injects them as context when enabled. Casual chat (greetings, acknowledgments) is skipped. The injected context respects a maxRecallChars budget to avoid oversized prompts.

Auto-Recall is disabled by default. Enable it in your plugin config:

{
  "plugins": {
    "entries": {
      "openclaw-tvix": {
        "config": {
          "autoRecall": true
        }
      }
    }
  }
}

Auto-Capture

Runs after every AI response (agent_end hook).

Buffers user and assistant messages per channel and flushes original transcripts to Tvix Wiki. Buffers flush after 5 minutes of silence or 20 messages, whichever comes first. The last 2 messages are kept as overlap for continuity across batches.

Configuration

All configuration is managed through OpenClaw's plugin settings or ~/.openclaw/openclaw.json:

OAuth login keeps stable plugin config in ~/.openclaw/openclaw.json and stores rotating tokens in tokenFile. Legacy keys (accessToken, refreshToken) are migrated automatically when present.

Enabling AI Tools

The plugin automatically adds itself to tools.alsoAllow on first load. If it doesn't take effect, restart the gateway once.

If you prefer to configure it manually, use tools.alsoAllow (not tools.allow) to avoid breaking your existing profile allowlist:

{
  "tools": {
    "profile": "coding",
    "alsoAllow": ["openclaw-tvix"]
  },
  "plugins": {
    "entries": {
      "openclaw-tvix": {
        "enabled": true,
        "config": {
          "autoRecall": false,
          "autoWikiRecall": false,
          "autoCapture": true,
          "maxRecallChars": 4000,
          "debug": false
        }
      }
    }
  }
}

"openclaw-tvix" in tools.alsoAllow expands to all tools registered by this plugin and is appended on top of the active profile. Using tools.allow instead can silently break your profile allowlist. Without this entry, the AI still receives memory context via auto-recall but cannot call the tools explicitly.

Managing Plugins

Use openclaw plugins to manage installed plugins, check status, and update versions.

Updating the Plugin

To update Tvix to the latest version:

openclaw plugins update openclaw-tvix

Restart OpenClaw after updating to apply the new version.

How Tvix Differs

GitHub Repository

Want to inspect the plugin source, track releases, or contribute improvements?

openclaw-tvix on GitHub

Browse the source code, open issues, and follow plugin updates in the standalone repository.

Next Steps

Bring Your Context

Import chat history, connect apps, and more.

Use Your Context

Chat with Memory, agent retrieval, and dashboard exploration.

Knowledge Wiki

Store factual knowledge as wiki documents that OpenClaw can search directly.

Tvix MCP

See every MCP tool your agent can call.