openclaw.plugin.json

{
  "id": "memory-powermem",
  "kind": "memory",
  "uiHints": {
    "mode": {
      "label": "Backend mode",
      "placeholder": "cli",
      "help": "Use \"cli\" to run pmem locally (recommended for individuals; no server). Use \"http\" for powermem-server (teams / enterprise). Default: cli"
    },
    "baseUrl": {
      "label": "PowerMem API URL",
      "placeholder": "http://localhost:8000",
      "help": "Required when mode is http. Base URL of PowerMem HTTP API (no /api/v1). Start server with: powermem-server --port 8000"
    },
    "apiKey": {
      "label": "API Key",
      "sensitive": true,
      "placeholder": "",
      "help": "Optional; required if PowerMem server has authentication enabled (http mode only)"
    },
    "httpApiVersion": {
      "label": "HTTP API version",
      "placeholder": "v1",
      "advanced": true,
      "help": "HTTP mode: v1 (default) or v2. v2 enables per-request config and agent memory APIs."
    },
    "requestTimeoutMs": {
      "label": "Request timeout (ms)",
      "placeholder": "30000",
      "advanced": true,
      "help": "Abort HTTP/CLI requests after this many milliseconds (0 = no timeout)"
    },
    "requestConfig": {
      "label": "Request config (v2)",
      "placeholder": "",
      "advanced": true,
      "help": "HTTP v2 only: per-request PowerMem config object (same shape as auto_config())."
    },
    "envFile": {
      "label": "Env file path",
      "placeholder": "",
      "advanced": true,
      "help": "CLI mode: path to PowerMem .env (default ~/.openclaw/powermem/powermem.env if you use install.sh -y). Optional; pmem can discover .env if omitted"
    },
    "pmemPath": {
      "label": "pmem binary path",
      "placeholder": "bundled",
      "advanced": true,
      "help": "CLI mode: bundled (default) or auto = npm powermem next to this plugin if installed, else pmem on PATH; or absolute path / command name (e.g. Python venv pmem)"
    },
    "userId": {
      "label": "User ID",
      "placeholder": "openclaw-user",
      "advanced": true,
      "help": "PowerMem user_id (optional). Use ${ENV_NAME} to read from the process environment; if any referenced variable is unset, falls back to identity.json / a new UUID. \"auto\" or omit = generated stable id."
    },
    "agentId": {
      "label": "Agent ID",
      "placeholder": "openclaw-agent",
      "advanced": true,
      "help": "PowerMem agent_id (optional). Set to \"auto\" to mirror OpenClaw `agents.list[].id` into agent-identities.json (PowerMem agentId = that id); default row in identity.json uses the first listed agent."
    },
    "openclawConfigPath": {
      "label": "OpenClaw config path",
      "placeholder": "",
      "advanced": true,
      "help": "When agentId is auto: JSON file to read for `agents.list` (default: <stateDir>/openclaw.json). Used for startup + periodic sync."
    },
    "agentListSyncIntervalMs": {
      "label": "Agent list sync interval (ms)",
      "placeholder": "60000",
      "advanced": true,
      "help": "When agentId is auto: re-read the OpenClaw config file on this interval and merge new agents into agent-identities.json. 0 = no polling (sync once at startup). Omit for 60000."
    },
    "recallLimit": {
      "label": "Recall limit",
      "placeholder": "5",
      "advanced": true,
      "help": "Max memories to return in recall / inject in auto-recall (1–100)"
    },
    "recallScoreThreshold": {
      "label": "Recall score threshold",
      "placeholder": "0",
      "advanced": true,
      "help": "Min score (0–1); memories below are filtered out"
    },
    "walCapture": {
      "label": "WAL Capture",
      "help": "Incrementally capture key facts during conversations to prevent loss on crash/compaction"
    },
    "autoCapture": {
      "label": "Auto-Capture",
      "help": "Automatically store important information from conversations"
    },
    "autoRecall": {
      "label": "Auto-Recall",
      "help": "Automatically inject relevant memories into context"
    },
    "autoExperience": {
      "label": "Auto-Experience",
      "help": "Automatically store session experiences at agent_end"
    },
    "experienceRecall": {
      "label": "Experience Recall",
      "help": "Automatically inject relevant experiences into context"
    },
    "inferOnAdd": {
      "label": "Infer on Add",
      "help": "Use PowerMem intelligent extraction when adding (infer=true)"
    },
    "importMarkdownOnStart": {
      "label": "Import markdown on start",
      "advanced": true,
      "help": "One-time import of existing OpenClaw markdown memories on service start. Defaults to memory/, MEMORY.md, and USER.md."
    },
    "importMarkdownPaths": {
      "label": "Markdown import paths",
      "advanced": true,
      "placeholder": "[\"memory\", \"MEMORY.md\", \"USER.md\"]",
      "help": "Files or directories to import when importMarkdownOnStart is enabled. Relative paths resolve from the OpenClaw workspace."
    },
    "importMarkdownMaxFileBytes": {
      "label": "Markdown import max file bytes",
      "advanced": true,
      "placeholder": "10485760",
      "help": "Max size for a single markdown file. Files above this are marked skipped_too_large. Default: 10 MiB."
    },
    "importMarkdownBatchDelayMs": {
      "label": "Markdown import delay (ms)",
      "advanced": true,
      "placeholder": "300",
      "help": "Delay between imported chunks to avoid startup write bursts. Default: 300ms."
    },
    "importMarkdownMaxFiles": {
      "label": "Markdown import max files",
      "advanced": true,
      "placeholder": "",
      "help": "Optional hard cap on markdown files imported in one run. Empty means no cap."
    },
    "importMarkdownMaxChunks": {
      "label": "Markdown import max chunks",
      "advanced": true,
      "placeholder": "",
      "help": "Optional hard cap on markdown chunks imported in one run. Empty means no cap."
    },
    "debugPerfLog": {
      "label": "Debug performance logs",
      "advanced": true,
      "help": "Enable slow-path performance logs for key memory operations."
    },
    "perfSlowMs": {
      "label": "Perf slow threshold (ms)",
      "advanced": true,
      "placeholder": "800",
      "help": "Only log performance entries slower than this threshold."
    },
    "dualWrite": {
      "label": "Dual write (HTTP + SQLite)",
      "advanced": true,
      "help": "When enabled, write to remote HTTP and local sqlite for failover and resync."
    },
    "dualWritePriority": {
      "label": "Dual write priority",
      "advanced": true,
      "placeholder": "remote",
      "help": "Dual-write read/write priority: remote (default) tries PowerMem first and falls back to local SQLite; local writes/searches SQLite first and syncs to remote."
    },
    "localDbPath": {
      "label": "Local sqlite path",
      "advanced": true,
      "placeholder": "",
      "help": "Local sqlite file path for dual-write. Default: <stateDir>/powermem/local-memories.sqlite"
    },
    "localUserId": {
      "label": "Local User ID",
      "advanced": true,
      "placeholder": "",
      "help": "Override user_id for local sqlite storage (dual-write)"
    },
    "localAgentId": {
      "label": "Local Agent ID",
      "advanced": true,
      "placeholder": "",
      "help": "Override agent_id for local sqlite storage (dual-write)"
    },
    "syncOnResume": {
      "label": "Sync pending writes",
      "advanced": true,
      "help": "When remote recovers, sync local pending writes (default true)"
    },
    "syncBatchSize": {
      "label": "Sync batch size",
      "advanced": true,
      "placeholder": "50",
      "help": "Max pending writes per sync attempt"
    },
    "syncMinIntervalMs": {
      "label": "Sync min interval (ms)",
      "advanced": true,
      "placeholder": "5000",
      "help": "Minimum interval between sync attempts"
    },
    "syncBaseDelayMs": {
      "label": "Sync base delay (ms)",
      "advanced": true,
      "placeholder": "5000",
      "help": "Base backoff delay after a failed sync"
    },
    "syncMaxDelayMs": {
      "label": "Sync max delay (ms)",
      "advanced": true,
      "placeholder": "60000",
      "help": "Maximum backoff delay after failures"
    },
    "syncMaxRetries": {
      "label": "Sync max retries",
      "advanced": true,
      "placeholder": "10",
      "help": "Skip items after this many failed retries (0 = unlimited)"
    },
    "localVector": {
      "label": "Local vector search",
      "advanced": true,
      "help": "Optional local vector fallback for dual-write (OpenAI/Ollama compatible embeddings + sqlite-vec)."
    },
    "pluginLlmModel": {
      "label": "Plugin LLM model (provider/model)",
      "advanced": true,
      "placeholder": "e.g. glm-5_1",
      "help": "Optional. For plugin-only LLM calls when agents.defaults.model is a router (e.g. auto-router/auto). Must match models.providers. Fallback order: env MEMORY_POWERMEM_PLUGIN_LLM_MODEL, then first non-router key in agents.defaults.models, then first model in models.providers."
    },
    "useOpenClawModel": {
      "label": "Use OpenClaw LLM for PowerMem",
      "advanced": true,
      "help": "When true (default), inject LLM/embedding from OpenClaw agents.defaults.model into pmem (overrides powermem .env for those keys). SQLite defaults under OpenClaw state dir when no .env."
    }
  },
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "mode": { "type": "string", "enum": ["http", "cli"] },
      "baseUrl": { "type": "string" },
      "apiKey": { "type": "string" },
      "httpApiVersion": { "type": "string", "enum": ["v1", "v2"] },
      "requestTimeoutMs": { "type": "number" },
      "requestConfig": { "type": "object" },
      "envFile": { "type": "string" },
      "pmemPath": { "type": "string" },
      "userId": { "type": "string" },
      "agentId": { "type": "string" },
      "openclawConfigPath": { "type": "string" },
      "agentListSyncIntervalMs": { "type": "number" },
      "recallLimit": { "type": "number" },
      "recallScoreThreshold": { "type": "number" },
      "walCapture": { "type": "boolean" },
      "autoCapture": { "type": "boolean" },
      "autoRecall": { "type": "boolean" },
      "autoExperience": { "type": "boolean" },
      "experienceRecall": { "type": "boolean" },
      "inferOnAdd": { "type": "boolean" },
      "importMarkdownOnStart": { "type": "boolean" },
      "importMarkdownPaths": {
        "type": "array",
        "items": { "type": "string" }
      },
      "importMarkdownMaxFileBytes": { "type": "number" },
      "importMarkdownBatchDelayMs": { "type": "number" },
      "importMarkdownMaxFiles": { "type": "number" },
      "importMarkdownMaxChunks": { "type": "number" },
      "debugPerfLog": { "type": "boolean" },
      "perfSlowMs": { "type": "number" },
      "dualWrite": { "type": "boolean" },
      "dualWritePriority": { "type": "string", "enum": ["remote", "local"] },
      "localDbPath": { "type": "string" },
      "localUserId": { "type": "string" },
      "localAgentId": { "type": "string" },
      "syncOnResume": { "type": "boolean" },
      "syncBatchSize": { "type": "number" },
      "syncMinIntervalMs": { "type": "number" },
      "syncBaseDelayMs": { "type": "number" },
      "syncMaxDelayMs": { "type": "number" },
      "syncMaxRetries": { "type": "number" },
      "localVector": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "enabled": { "type": "boolean" },
          "provider": { "type": "string" },
          "model": { "type": "string" },
          "apiKey": { "type": "string" },
          "baseUrl": { "type": "string" },
          "headers": {
            "type": "object",
            "additionalProperties": { "type": "string" }
          }
        }
      },
      "pluginLlmModel": { "type": "string" },
      "useOpenClawModel": { "type": "boolean" }
    },
    "required": []
  }
}