OpenClaw

Add Tvix memory, wiki, briefs, and attention tools to OpenClaw using the in-repo plugin.

This repository ships an OpenClaw plugin at openclaw/plugins/execution-twin (plugin id execution-twin, display name Tvix). The Agents wizard copies a config block for plugins.entries["execution-twin"].

OpenClaw does not use hosted MCP or an agent Bearer token. It calls the FastAPI tools API and heartbeats at /api/v1/agents/heartbeat.

Setup

Install / enable the plugin

Point OpenClaw at the plugin in this repo (or your installed copy), then enable it in `openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "execution-twin": {
        "enabled": true,
        "config": {
          "apiUrl": "https://api.tvix.ai",
          "userEmail": "you@example.com"
        }
      }
    }
  }
}
```

- **Local / Tvix for Mac:** set `apiUrl` to `http://127.0.0.1:8000`.
- **When `AUTH_DISABLED=false`:** set `config.serviceToken` (or env `EXECUTION_TWIN_SERVICE_TOKEN`) to your `SERVICE_API_TOKEN`. The plugin sends it as `X-Service-Token` with `userEmail`.

Restart the gateway

Restart OpenClaw / reload your LaunchAgent so the plugin loads. On startup it pings heartbeat; Agents should show **OpenClaw gateway** after the first successful call.

Note: Published npm packages such as @tvix/openclaw-tvix and CLI commands like openclaw tvix login are not part of this repository. Prefer the execution-twin plugin config from Agents → + Add Agent → OpenClaw.

Tools

The plugin contract exposes a broad tool set (memory search/capture, wiki search, briefs, commitments, blockers, PARA helpers, and more). Hosted MCP clients use the smaller registry documented in Tvix MCP; the OpenClaw plugin can call additional /api/v1/tools and related endpoints.

Config schema fields: apiUrl, userEmail, serviceToken.

Troubleshooting

• Heartbeat missing on Agents — confirm apiUrl, userEmail, and (if auth is on) serviceToken; check gateway logs for API … failed: 401.
• Wrong memory scope — userEmail must match the Tvix account you signed into.

Next Steps

Tvix MCP

Hosted MCP tool reference.

Quickstart

Connect other agents.