memorylake-openclaw 0.0.8 → 0.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorylake-openclaw",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "description": "MemoryLake memory backend for OpenClaw",
   "license": "MIT",

package/scripts/install.ps1

@@ -0,0 +1,455 @@
+# MemoryLake OpenClaw Plugin Installer for Windows
+# Usage (with env vars): $env:MEMORYLAKE_API_KEY="sk-..."; $env:MEMORYLAKE_PROJECT_ID="proj-..."; iwr -useb https://app.memorylake.ai/memorylake-openclaw/install.ps1 | iex
+# Or (with params): & ([scriptblock]::Create((iwr -useb https://app.memorylake.ai/memorylake-openclaw/install.ps1))) -ApiKey <key> -ProjectId <id>
+
+param(
+    [string]$ApiKey = $env:MEMORYLAKE_API_KEY,
+    [string]$ProjectId = $env:MEMORYLAKE_PROJECT_ID,
+    [switch]$Help
+)
+
+$ErrorActionPreference = "Stop"
+$script:HadNpmRegistry = -not [string]::IsNullOrWhiteSpace($env:NPM_REGISTRY)
+
+# Set UTF-8 encoding for Chinese characters in output
+try {
+    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    [Console]::InputEncoding = [System.Text.Encoding]::UTF8
+    $OutputEncoding = [System.Text.Encoding]::UTF8
+    chcp 65001 | Out-Null
+} catch {
+    Write-Warning "UTF-8 encoding setup failed: $_"
+}
+
+# Colors (prefixed to avoid $Error etc.)
+$ColorAccent = "`e[38;2;255;77;77m"    # coral-bright
+$ColorSuccess = "`e[38;2;0;229;204m"   # cyan-bright
+$ColorWarn = "`e[38;2;255;176;32m"     # amber
+$ColorError = "`e[38;2;230;57;70m"     # coral-mid
+$ColorMuted = "`e[38;2;90;100;128m"     # text-muted
+$ColorReset = "`e[0m"                  # No Color
+
+$OPENCLAW_CONFIG = "$env:USERPROFILE\.openclaw\openclaw.json"
+$QCLAW_CONFIG = "$env:USERPROFILE\.qclaw\openclaw.json"
+
+function Write-Message {
+    param([string]$Message, [string]$Level = "info")
+    $msg = switch ($Level) {
+        "success" { "$ColorSuccess✓$ColorReset $Message" }
+        "warn"    { "$ColorWarn!$ColorReset $Message" }
+        "error"   { "$ColorError✗$ColorReset $Message" }
+        default   { "$ColorMuted·$ColorReset $Message" }
+    }
+    Write-Host $msg
+}
+
+function Show-Usage {
+    Write-Host @"
+MemoryLake OpenClaw Plugin Installer (Windows)
+
+Usage:
+  `$env:MEMORYLAKE_API_KEY="sk-..."; `$env:MEMORYLAKE_PROJECT_ID="proj-..."; iwr -useb https://app.memorylake.ai/memorylake-openclaw/install.ps1 | iex
+  Or: & ([scriptblock]::Create((iwr -useb https://app.memorylake.ai/memorylake-openclaw/install.ps1))) -ApiKey <key> -ProjectId <id>
+
+Parameters:
+  -ApiKey <key>       MemoryLake API key (required)
+  -ProjectId <id>     MemoryLake project ID (required)
+  -Help               Show this help
+
+Environment variables:
+  MEMORYLAKE_API_KEY        API key (alternative to -ApiKey)
+  MEMORYLAKE_PROJECT_ID     Project ID (alternative to -ProjectId)
+  NPM_REGISTRY              Override npm registry (e.g. https://registry.npmmirror.com for China)
+
+Get apiKey and projectId from https://app.memorylake.ai
+"@
+}
+
+function Test-Params {
+    if ([string]::IsNullOrWhiteSpace($ApiKey) -or [string]::IsNullOrWhiteSpace($ProjectId)) {
+        Write-Message "Missing required parameters: apiKey and projectId" -Level error
+        Write-Host ""
+        Write-Host "Please provide apiKey and projectId. Get them from https://app.memorylake.ai"
+        Write-Host ""
+        Write-Host "Usage: -ApiKey <key> -ProjectId <id>"
+        Write-Host "   or: `$env:MEMORYLAKE_API_KEY=<key>; `$env:MEMORYLAKE_PROJECT_ID=<id>; .\install-memorylake-openclaw.ps1"
+        exit 1
+    }
+}
+
+function Get-QClawScriptPath {
+    try {
+        # $proc = Get-Process qclaw -ErrorAction Stop
+        $path = (Get-Process qclaw).path[0] | Where-Object {$_}
+        $dir = Split-Path -Parent $path
+        $scriptPath = Join-Path $dir "resources\openclaw\config\skills\qclaw-openclaw\scripts\openclaw-win.cmd"
+        if (Test-Path $scriptPath) { return $scriptPath }
+    } catch {
+        Write-Message "Get-QClawScriptPath: $_" -Level warn
+    }
+    return $null
+}
+
+function Refresh-Path {
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+}
+
+function Test-NodeInstalled {
+    $nodeVersion = $null
+    try {
+        $nodeVersion = & node -v 2>&1
+    } catch {
+        return $false
+    }
+    if ($nodeVersion -and $nodeVersion -match '^v(\d+)') {
+        $majorVersion = [int]$Matches[1]
+        return $majorVersion -ge 22
+    }
+    return $false
+}
+
+function Install-NodeJS {
+    Write-Message "Installing Node.js..." -Level info
+    if (Get-Command winget -ErrorAction SilentlyContinue) {
+        Write-Message "Using winget..." -Level info
+        & winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
+        if ($LASTEXITCODE -eq 0) {
+            Refresh-Path
+            Write-Message "Node.js installed via winget" -Level success
+            return $true
+        }
+        Write-Message "winget install failed (exit code: $LASTEXITCODE), trying next method..." -Level warn
+    }
+    if (Get-Command choco -ErrorAction SilentlyContinue) {
+        Write-Message "Using Chocolatey..." -Level info
+        & choco install nodejs-lts -y
+        if ($LASTEXITCODE -eq 0) {
+            Refresh-Path
+            Write-Message "Node.js installed via Chocolatey" -Level success
+            return $true
+        }
+        Write-Message "choco install failed (exit code: $LASTEXITCODE), trying next method..." -Level warn
+    }
+    if (Get-Command scoop -ErrorAction SilentlyContinue) {
+        Write-Message "Using Scoop..." -Level info
+        & scoop install nodejs-lts
+        if ($LASTEXITCODE -eq 0) {
+            Refresh-Path
+            Write-Message "Node.js installed via Scoop" -Level success
+            return $true
+        }
+        Write-Message "scoop install failed (exit code: $LASTEXITCODE), trying next method..." -Level warn
+    }
+    # Fallback: download and install .msi
+    Write-Message "Falling back to .msi installer..." -Level info
+    $nodeVersion = "22.22.1"
+    $arch = if ([System.Environment]::Is64BitOperatingSystem) {
+        if ($env:PROCESSOR_ARCHITECTURE -eq "ARM64") { "arm64" } else { "x64" }
+    } else { "x86" }
+    $msiName = "node-v${nodeVersion}-${arch}.msi"
+
+    if ($script:ChinaNetwork) {
+        $msiUrl = "https://registry.npmmirror.com/-/binary/node/v${nodeVersion}/${msiName}"
+        Write-Message "Downloading Node.js from npmmirror..." -Level info
+    } else {
+        $msiUrl = "https://nodejs.org/dist/v${nodeVersion}/${msiName}"
+        Write-Message "Downloading Node.js from nodejs.org..." -Level info
+    }
+
+    $tmpDir = Join-Path $env:TEMP "node-install-$(Get-Random)"
+    New-Item -ItemType Directory -Path $tmpDir -Force | Out-Null
+    $msiPath = Join-Path $tmpDir $msiName
+
+    try {
+        Invoke-WebRequest -Uri $msiUrl -OutFile $msiPath -UseBasicParsing
+        Write-Message "Installing Node.js via .msi (may prompt for admin permission)..." -Level info
+        # Use /passive instead of /qn: shows progress bar and can auto-elevate via UAC.
+        # /qn silently fails without admin privileges.
+        $msiProc = Start-Process msiexec.exe -ArgumentList "/i", "`"$msiPath`"", "/passive", "/norestart" -Wait -PassThru
+        if ($msiProc.ExitCode -ne 0) {
+            Write-Message "msiexec failed (exit code: $($msiProc.ExitCode))" -Level error
+            Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
+            return $false
+        }
+
+        Refresh-Path
+
+        Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
+        if (Test-NodeInstalled) {
+            Write-Message "Node.js installed via .msi" -Level success
+            return $true
+        }
+        Write-Message "Node.js .msi install completed but node not found in PATH" -Level error
+        return $false
+    } catch {
+        Remove-Item $tmpDir -Recurse -Force -ErrorAction SilentlyContinue
+        Write-Message "Node.js .msi download/install failed: $_" -Level error
+        Write-Host "Please install Node.js 22+ manually: https://nodejs.org/en/download/"
+        return $false
+    }
+}
+
+function Ensure-NodeForQClaw {
+    if (Test-NodeInstalled) {
+        $ver = & node -v 2>&1
+        Write-Message "Node.js $ver found" -Level success
+        return $true
+    }
+    Write-Message "Node.js not found (v22+ required for QClaw plugin install)" -Level warn
+    if (-not (Install-NodeJS)) {
+        exit 1
+    }
+    if (-not (Test-NodeInstalled)) {
+        Write-Message "Node.js installation failed or version too old" -Level error
+        exit 1
+    }
+
+    # Configure npm mirror for China network
+    if ($script:ChinaNetwork) {
+        & npm config set registry $env:NPM_REGISTRY
+        Write-Message "npm registry set to $($env:NPM_REGISTRY)" -Level info
+    }
+
+    return $true
+}
+
+function Get-ClawMode {
+    # Priority: OpenClaw first
+    if (Get-Command openclaw -ErrorAction SilentlyContinue) {
+        $script:ClawMode = "openclaw"
+        Write-Message "Detected OpenClaw" -Level success
+        return $true
+    }
+
+    $qclawScript = Get-QClawScriptPath
+    if ($qclawScript) {
+        $script:ClawMode = "qclaw"
+        $script:QClawScript = $qclawScript
+        Write-Message "Detected QClaw" -Level success
+        return $true
+    }
+
+    Write-Message "OpenClaw or QClaw not found." -Level error
+    Write-Host "QClaw not installed or not running. If using QClaw, install and start it first."
+    Write-Host "Install OpenClaw: iwr -useb https://openclaw.ai/install.ps1 | iex"
+    exit 1
+}
+
+function Test-PluginInstalled {
+    if ($script:ClawMode -eq "openclaw") {
+        $out = openclaw plugins list
+        if ($LASTEXITCODE -ne 0) {
+            Write-Message "openclaw plugins list failed (exit code: $LASTEXITCODE)" -Level error
+            exit 1
+        }
+        return $out -match "memorylake-openclaw"
+    } else {
+        $out = & $script:QClawScript plugins list
+        if ($LASTEXITCODE -ne 0) {
+            Write-Message "QClaw plugins list failed (exit code: $LASTEXITCODE)" -Level error
+            exit 1
+        }
+        return $out -match "memorylake-openclaw"
+    }
+}
+
+function Test-NetworkChina {
+    $script:ChinaNetwork = $false
+
+    if (-not [string]::IsNullOrWhiteSpace($env:NPM_REGISTRY)) {
+        Write-Message "Using NPM_REGISTRY=$($env:NPM_REGISTRY)"
+        return
+    }
+
+    $timeoutSec = 5
+    $job = Start-Job -ScriptBlock {
+        try {
+            $r = Invoke-WebRequest -Uri "https://google.com/generate_204" -UseBasicParsing -TimeoutSec 3 -ErrorAction Stop
+            if ($r.StatusCode -eq 204) { "ok" } else { "fail" }
+        } catch { "fail" }
+    }
+    $completed = Wait-Job $job -Timeout $timeoutSec
+    if ($completed) {
+        $result = Receive-Job $job
+        Remove-Job $job -Force
+        if ($result -eq "ok") { return }
+    } else {
+        Stop-Job $job -ErrorAction SilentlyContinue
+        Remove-Job $job -Force -ErrorAction SilentlyContinue
+    }
+    $script:ChinaNetwork = $true
+    $env:NPM_REGISTRY = "https://registry.npmmirror.com"
+    Write-Message "China network detected, using npmmirror"
+}
+
+function Install-Plugin {
+    param([switch]$TryOnly)
+
+    if ($script:ClawMode -eq "openclaw") {
+        if (-not [string]::IsNullOrWhiteSpace($env:NPM_REGISTRY)) {
+            $env:NPM_CONFIG_REGISTRY = $env:NPM_REGISTRY
+        }
+    }
+
+    $prevEAP = $ErrorActionPreference
+    $ErrorActionPreference = "Continue"
+
+    if ($TryOnly) {
+        # stdout redirected to Out-Host (out of return pipeline), error returns false
+        if ($script:ClawMode -eq "openclaw") {
+            openclaw plugins install memorylake-openclaw | Out-Host
+        } else {
+            & $script:QClawScript plugins install memorylake-openclaw | Out-Host
+        }
+        $exitCode = $LASTEXITCODE
+        $ErrorActionPreference = $prevEAP
+        Write-Message "Install-Plugin exit code: $exitCode" -Level info
+        return $exitCode -eq 0
+    } else {
+        # stdout direct to console, error exits
+        if ($script:ClawMode -eq "openclaw") {
+            openclaw plugins install memorylake-openclaw
+        } else {
+            & $script:QClawScript plugins install memorylake-openclaw
+        }
+        $exitCode = $LASTEXITCODE
+        $ErrorActionPreference = $prevEAP
+        Write-Message "Install-Plugin exit code: $exitCode" -Level info
+        if ($exitCode -ne 0) {
+            exit 1
+        }
+    }
+}
+
+function Write-Config {
+    $configPath = if ($script:ClawMode -eq "openclaw") { $OPENCLAW_CONFIG } else { $QCLAW_CONFIG }
+    $configDir = Split-Path -Parent $configPath
+
+    if (!(Test-Path $configDir)) {
+        New-Item -ItemType Directory -Path $configDir -Force | Out-Null
+    }
+
+    $config = [PSCustomObject]@{}
+    if (Test-Path $configPath) {
+        try {
+            $config = Get-Content $configPath -Raw -ErrorAction Stop | ConvertFrom-Json
+        } catch {
+            Write-Message "Config parse failed: $_" -Level error
+            exit 1
+        }
+    }
+
+    if (-not $config.PSObject.Properties["plugins"]) {
+        $config | Add-Member -NotePropertyName "plugins" -NotePropertyValue ([PSCustomObject]@{}) -Force
+    }
+    if (-not $config.plugins.PSObject.Properties["entries"]) {
+        $config.plugins | Add-Member -NotePropertyName "entries" -NotePropertyValue ([PSCustomObject]@{}) -Force
+    }
+
+    $pluginEntry = [PSCustomObject]@{
+        enabled = $true
+        config = [PSCustomObject]@{
+            apiKey = $ApiKey
+            projectId = $ProjectId
+        }
+    }
+    $config.plugins.entries | Add-Member -NotePropertyName "memorylake-openclaw" -NotePropertyValue $pluginEntry -Force
+
+    # Merge tools config (QClaw only)
+    if ($script:ClawMode -eq "qclaw") {
+        if (-not $config.PSObject.Properties["tools"]) {
+            $config | Add-Member -NotePropertyName "tools" -NotePropertyValue ([PSCustomObject]@{}) -Force
+        }
+        $existing = $config.tools.alsoAllow
+        $arr = @()
+        if ($null -ne $existing) {
+            $arr = @($existing)
+        }
+        if ($arr -notcontains "advanced_web_search") {
+            $arr = $arr + "advanced_web_search"
+        }
+        $config.tools | Add-Member -NotePropertyName "alsoAllow" -NotePropertyValue $arr -Force
+
+        if (-not $config.tools.PSObject.Properties["web"]) {
+            $config.tools | Add-Member -NotePropertyName "web" -NotePropertyValue ([PSCustomObject]@{}) -Force
+        }
+        if (-not $config.tools.web.PSObject.Properties["search"]) {
+            $config.tools.web | Add-Member -NotePropertyName "search" -NotePropertyValue ([PSCustomObject]@{}) -Force
+        }
+        $config.tools.web.search | Add-Member -NotePropertyName "enabled" -NotePropertyValue $false -Force
+    }
+
+    $json = $config | ConvertTo-Json -Depth 10
+    $lines = $json -split "`r?`n"
+    $indentLevel = 0
+    $fixed = @()
+    foreach ($line in $lines) {
+        if ($line -match '[\}\]]') { $indentLevel-- }
+        $trimmed = $line.TrimStart().Replace(':  ', ': ')
+        $fixed += (' ' * ($indentLevel * 2)) + $trimmed
+        if ($line -match '[\{\[]') { $indentLevel++ }
+    }
+    $json = $fixed -join "`n"
+    Set-Content $configPath -Value $json -Encoding UTF8
+}
+
+function Restart-Gateway {
+    if ($script:ClawMode -eq "openclaw") {
+        openclaw gateway restart
+        if ($LASTEXITCODE -ne 0) {
+            Write-Message "openclaw gateway restart failed (exit code: $LASTEXITCODE)" -Level error
+            exit 1
+        }
+    }
+}
+
+# Main
+function Main {
+    if ($Help) {
+        Show-Usage
+        return
+    }
+
+    Test-Params
+    Get-ClawMode | Out-Null
+
+    if (Test-PluginInstalled) {
+        Write-Message "memorylake-openclaw is already installed."
+        exit 0
+    }
+
+    Test-NetworkChina
+
+    # Try install; if qclaw fails, install Node.js and retry
+    if ($script:ClawMode -eq "qclaw") {
+        if (-not (Install-Plugin -TryOnly)) {
+            Write-Message "Plugin install failed, attempting to install Node.js..." -Level warn
+            Ensure-NodeForQClaw | Out-Null
+            Write-Message "Retrying plugin installation..." -Level info
+            Install-Plugin
+        }
+    } else {
+        Install-Plugin
+    }
+    Write-Message "Plugin installed" -Level success
+
+    Write-Config
+    Write-Message "Config updated" -Level success
+
+    Restart-Gateway
+    if ($script:ClawMode -eq "openclaw") {
+        Write-Message "Gateway restarted" -Level success
+    }
+
+    Write-Message "memorylake-openclaw setup complete!" -Level success
+}
+
+try {
+    Main
+} finally {
+    # Clean up env vars set during this script to avoid polluting the caller's shell session
+    if (-not $script:HadNpmRegistry) {
+        Remove-Item Env:\NPM_REGISTRY -ErrorAction SilentlyContinue
+    }
+    Remove-Item Env:\NPM_CONFIG_REGISTRY -ErrorAction SilentlyContinue
+}

package/scripts/install.sh

@@ -0,0 +1,336 @@
+#!/bin/bash
+set -euo pipefail
+
+# MemoryLake OpenClaw Plugin Installer for macOS and Linux
+# Usage: curl -fsSL --proto '=https' --tlsv1.2 https://app.memorylake.ai/memorylake-openclaw/install.sh | bash -s -- --api-key <key> --project-id <id>
+
+# shellcheck disable=SC2034
+BOLD='\033[1m'
+# shellcheck disable=SC2034
+ACCENT='\033[38;2;255;77;77m'       # coral-bright #ff4d4d
+# shellcheck disable=SC2034
+INFO='\033[38;2;136;146;176m'       # text-secondary #8892b0
+SUCCESS='\033[38;2;0;229;204m'      # cyan-bright #00e5cc
+WARN='\033[38;2;255;176;32m'        # amber
+ERROR='\033[38;2;230;57;70m'        # coral-mid #e63946
+MUTED='\033[38;2;90;100;128m'       # text-muted #5a6480
+NC='\033[0m' # No Color
+
+QCLAW_SCRIPT="/Applications/QClaw.app/Contents/Resources/openclaw/config/skills/qclaw-openclaw/scripts/openclaw-mac.sh"
+OPENCLAW_CONFIG="${HOME}/.openclaw/openclaw.json"
+QCLAW_CONFIG="${HOME}/.qclaw/openclaw.json"
+
+ui_info() {
+    echo -e "${MUTED}·${NC} $*"
+}
+
+ui_warn() {
+    echo -e "${WARN}!${NC} $*"
+}
+
+ui_success() {
+    echo -e "${SUCCESS}✓${NC} $*"
+}
+
+ui_error() {
+    echo -e "${ERROR}✗${NC} $*"
+}
+
+print_usage() {
+    cat <<EOF
+MemoryLake OpenClaw Plugin Installer (macOS + Linux)
+
+Usage:
+  curl -fsSL --proto '=https' --tlsv1.2 https://app.memorylake.ai/memorylake-openclaw/install.sh | bash -s -- --api-key <key> --project-id <id>
+
+Options:
+  --api-key, -a <key>       MemoryLake API key (required)
+  --project-id, -p <id>     MemoryLake project ID (required)
+  --help, -h                Show this help
+
+Environment variables:
+  MEMORYLAKE_API_KEY        API key (alternative to --api-key)
+  MEMORYLAKE_PROJECT_ID     Project ID (alternative to --project-id)
+  NPM_REGISTRY              Override npm registry (e.g. https://registry.npmmirror.com for China)
+
+Get apiKey and projectId from https://app.memorylake.ai
+EOF
+}
+
+parse_args() {
+    API_KEY="${MEMORYLAKE_API_KEY:-}"
+    PROJECT_ID="${MEMORYLAKE_PROJECT_ID:-}"
+    HELP=0
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --api-key|-a)
+                API_KEY="${2:-}"
+                shift 2
+                ;;
+            --project-id|-p)
+                PROJECT_ID="${2:-}"
+                shift 2
+                ;;
+            --help|-h)
+                HELP=1
+                shift
+                ;;
+            *)
+                shift
+                ;;
+        esac
+    done
+}
+
+validate_params() {
+    if [[ -z "$API_KEY" || -z "$PROJECT_ID" ]]; then
+        ui_error "Missing required parameters: apiKey and projectId"
+        echo ""
+        echo "Please provide apiKey and projectId. Get them from https://app.memorylake.ai"
+        echo ""
+        echo "Usage: $0 --api-key <key> --project-id <id>"
+        echo "   or: MEMORYLAKE_API_KEY=<key> MEMORYLAKE_PROJECT_ID=<id> $0"
+        exit 1
+    fi
+}
+
+detect_claw_mode() {
+    if command -v openclaw &>/dev/null; then
+        CLAW_MODE="openclaw"
+        ui_success "Detected OpenClaw"
+        return 0
+    fi
+
+    if [[ "$(uname -s)" == "Darwin" ]] && [[ -x "$QCLAW_SCRIPT" ]]; then
+        CLAW_MODE="qclaw"
+        ui_success "Detected QClaw"
+        return 0
+    fi
+
+    ui_error "OpenClaw or QClaw not found."
+    echo "Install OpenClaw first: curl -fsSL https://openclaw.ai/install.sh | bash"
+    exit 1
+}
+
+plugin_already_installed() {
+    if [[ "$CLAW_MODE" == "openclaw" ]]; then
+        openclaw plugins list | grep -q "memorylake-openclaw" || return 1
+    else
+        "$QCLAW_SCRIPT" plugins list | grep -q "memorylake-openclaw" || return 1
+    fi
+}
+
+detect_network() {
+    CHINA_NETWORK=false
+
+    if [[ -n "${NPM_REGISTRY:-}" ]]; then
+        ui_info "Using NPM_REGISTRY=$NPM_REGISTRY"
+        return 0
+    fi
+
+    local code
+    code="$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout 3 --max-time 5 https://google.com/generate_204 2>/dev/null || echo "000")"
+
+    if [[ "$code" != "204" ]]; then
+        CHINA_NETWORK=true
+        NPM_REGISTRY="https://registry.npmmirror.com"
+        ui_info "China network detected, using npmmirror"
+    fi
+}
+
+install_plugin() {
+    if [[ "$CLAW_MODE" == "openclaw" ]]; then
+        if [[ -n "${NPM_REGISTRY:-}" ]]; then
+            NPM_CONFIG_REGISTRY="$NPM_REGISTRY" openclaw plugins install memorylake-openclaw
+        else
+            openclaw plugins install memorylake-openclaw
+        fi
+    else
+        "$QCLAW_SCRIPT" plugins install memorylake-openclaw
+    fi
+}
+
+brew_has_mirror() {
+    # Check if any of the common Homebrew mirror env vars are set
+    [[ -n "${HOMEBREW_BOTTLE_DOMAIN:-}" ]] || [[ -n "${HOMEBREW_API_DOMAIN:-}" ]] || [[ -n "${HOMEBREW_BREW_GIT_REMOTE:-}" ]]
+}
+
+install_node_via_pkg() {
+    local node_version="22.22.1"
+    local pkg_name="node-v${node_version}.pkg"
+    local pkg_url
+
+    if [[ "$CHINA_NETWORK" == "true" ]]; then
+        pkg_url="https://registry.npmmirror.com/-/binary/node/v${node_version}/${pkg_name}"
+        ui_info "Downloading Node.js from npmmirror..."
+    else
+        pkg_url="https://nodejs.org/dist/v${node_version}/${pkg_name}"
+        ui_info "Downloading Node.js from nodejs.org..."
+    fi
+
+    local tmp_dir
+    tmp_dir=$(mktemp -d)
+
+    curl -Lo "${tmp_dir}/${pkg_name}" "$pkg_url"
+
+    if sudo -n true 2>/dev/null; then
+        sudo installer -pkg "${tmp_dir}/${pkg_name}" -target /
+    else
+        ui_warn "sudo requires a password. Please enter your Mac login password below:"
+        sudo installer -pkg "${tmp_dir}/${pkg_name}" -target /
+    fi
+
+    rm -rf "$tmp_dir"
+}
+
+install_node() {
+    ui_info "npm/node not found, installing Node.js..."
+
+    local brew_ok=false
+    if command -v brew &>/dev/null; then
+        if [[ "$CHINA_NETWORK" == "true" ]] && ! brew_has_mirror; then
+            ui_info "China network detected but Homebrew has no mirror configured, skipping brew"
+        else
+            ui_info "Installing Node.js via brew..."
+            if brew install node; then
+                brew_ok=true
+            else
+                ui_warn "brew install node failed, falling back to .pkg installer..."
+            fi
+        fi
+    fi
+
+    if [[ "$brew_ok" == "false" ]]; then
+        install_node_via_pkg
+    fi
+
+    # Verify installation
+    if command -v node &>/dev/null && command -v npm &>/dev/null; then
+        ui_success "Node.js $(node --version) installed"
+    else
+        ui_error "Node.js installation failed"
+        exit 1
+    fi
+
+    # Configure npm mirror for China network
+    if [[ "$CHINA_NETWORK" == "true" ]]; then
+        npm config set registry "$NPM_REGISTRY"
+        ui_info "npm registry set to $NPM_REGISTRY"
+    fi
+}
+
+write_config() {
+    local config_path
+    if [[ "$CLAW_MODE" == "openclaw" ]]; then
+        config_path="$OPENCLAW_CONFIG"
+    else
+        config_path="$QCLAW_CONFIG"
+    fi
+
+    local config_dir
+    config_dir="$(dirname "$config_path")"
+    mkdir -p "$config_dir"
+
+    CONFIG_PATH="$config_path" API_KEY="$API_KEY" PROJECT_ID="$PROJECT_ID" CLAW_MODE="$CLAW_MODE" python3 -c '
+import json
+import os
+
+path = os.environ["CONFIG_PATH"]
+api_key = os.environ["API_KEY"]
+project_id = os.environ["PROJECT_ID"]
+claw_mode = os.environ.get("CLAW_MODE", "")
+
+config = {}
+if os.path.exists(path):
+    with open(path) as f:
+        config = json.load(f)
+
+if "plugins" not in config:
+    config["plugins"] = {}
+if "entries" not in config["plugins"]:
+    config["plugins"]["entries"] = {}
+
+config["plugins"]["entries"]["memorylake-openclaw"] = {
+    "enabled": True,
+    "config": {
+        "apiKey": api_key,
+        "projectId": project_id
+    }
+}
+
+# Merge tools config (QClaw only)
+if claw_mode == "qclaw":
+    if "tools" not in config:
+        config["tools"] = {}
+    if "alsoAllow" not in config["tools"]:
+        config["tools"]["alsoAllow"] = []
+    arr = config["tools"]["alsoAllow"]
+    if "advanced_web_search" not in arr:
+        arr.append("advanced_web_search")
+
+    if "web" not in config["tools"]:
+        config["tools"]["web"] = {}
+    if "search" not in config["tools"]["web"]:
+        config["tools"]["web"]["search"] = {}
+    config["tools"]["web"]["search"]["enabled"] = False
+
+with open(path, "w") as f:
+    json.dump(config, f, indent=2)
+'
+}
+
+restart_gateway() {
+    if [[ "$CLAW_MODE" == "openclaw" ]]; then
+        openclaw gateway restart
+    fi
+}
+
+main() {
+    parse_args "$@"
+
+    if [[ "$HELP" == "1" ]]; then
+        print_usage
+        return 0
+    fi
+
+    validate_params
+    detect_claw_mode
+
+    if plugin_already_installed; then
+        ui_info "memorylake-openclaw is already installed."
+        exit 0
+    fi
+
+    detect_network
+
+    # Try install; if qclaw on macOS fails with npm error, install Node.js and retry
+    local install_output install_exit
+    if install_output=$(install_plugin 2>&1); then
+        echo "$install_output"
+    else
+        install_exit=$?
+        echo "$install_output" >&2
+        if [[ "$CLAW_MODE" == "qclaw" ]] && [[ "$(uname -s)" == "Darwin" ]] && echo "$install_output" | grep -qi "npm"; then
+            ui_warn "Plugin install failed due to npm issue, attempting to install Node.js..."
+            install_node
+            ui_info "Retrying plugin installation..."
+            install_plugin
+        else
+            exit "$install_exit"
+        fi
+    fi
+    ui_success "Plugin installed"
+
+    write_config
+    ui_success "Config updated"
+
+    restart_gateway
+    if [[ "$CLAW_MODE" == "openclaw" ]]; then
+        ui_success "Gateway restarted"
+    fi
+
+    ui_success "memorylake-openclaw setup complete!"
+}
+
+main "$@"

package/skills/common/get-config.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// Parse --agent
+const args = process.argv.slice(2);
+const agentIdx = args.indexOf("--agent");
+if (agentIdx === -1 || !args[agentIdx + 1]) {
+  console.error("Usage: node get-config.mjs --agent <agentId>");
+  process.exit(1);
+}
+const agentId = args[agentIdx + 1];
+
+// Read global config
+const openclawPath = join(homedir(), ".openclaw", "openclaw.json");
+const openclaw = JSON.parse(readFileSync(openclawPath, "utf-8"));
+const globalCfg = openclaw?.plugins?.entries?.["memorylake-openclaw"]?.config;
+if (!globalCfg) {
+  console.error("Error: memorylake-openclaw plugin config not found");
+  process.exit(1);
+}
+
+// Resolve workspace
+const agents = openclaw?.agents;
+const agentEntry = agents?.list?.find((a) => a.id === agentId);
+const workspace = agentEntry?.workspace || agents?.defaults?.workspace;
+if (!workspace) {
+  console.error(`Error: no workspace found for agent "${agentId}"`);
+  process.exit(1);
+}
+
+// Merge per-agent overrides
+const merged = { ...globalCfg };
+const localPath = join(workspace, ".memorylake", "config.json");
+if (existsSync(localPath)) {
+  const raw = JSON.parse(readFileSync(localPath, "utf-8"));
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+    Object.assign(merged, raw);
+  }
+}
+merged.host = merged.host || "https://app.memorylake.ai";
+merged.workspace = workspace;
+
+// Validate required fields
+if (!merged.apiKey || !merged.projectId) {
+  console.error("Error: apiKey and projectId are required");
+  process.exit(1);
+}
+
+console.log(JSON.stringify(merged, null, 2));

package/skills/memorylake-api/SKILL.md

@@ -19,21 +19,15 @@ Directly call MemoryLake's REST APIs by discovering endpoints from the live Open
 
 ## Step 1 — Read MemoryLake Config
 
-Read `~/.openclaw/openclaw.json` and extract the plugin config:
+Run the common config script (path is relative to **this skill's SKILL.md**, i.e. `../common/get-config.mjs`):
 
 ```bash
-cat ~/.openclaw/openclaw.json | jq '.plugins.entries["memorylake-openclaw"].config'
+node {path-to-this-skill}/../common/get-config.mjs --agent {agent}
 ```
 
-Extract these values:
+Where `{agent}` is the current agent ID. The script outputs JSON config with `host`, `apiKey`, `projectId`, etc.
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `host` | API host | `https://app.memorylake.ai` |
-| `apiKey` | API key for authentication | (required) |
-| `projectId` | MemoryLake project ID | (required) |
-
-If `apiKey` or `projectId` is missing, stop and inform the user.
+If the script exits with an error, stop and inform the user.
 
 Auth header for all requests:
 
@@ -185,15 +179,14 @@ All responses follow the same wrapper format:
 
 - **Wrong base URL**: The full URL must include `/openapi/memorylake` before the API path. E.g., `/openapi/memorylake/api/v1/projects`, NOT just `/api/v1/projects`
 - **Missing auth header**: Every request requires `Authorization: Bearer {apiKey}`
-- **Hardcoded project ID**: Always read `projectId` from `~/.openclaw/openclaw.json` config, not from user input (unless the user explicitly wants a different project)
+- **Hardcoded project ID**: Always read `projectId` from the config script output, not from user input (unless the user explicitly wants a different project)
 - **Pagination**: List endpoints default to `page=1, size=20`. Pass `page` and `size` query params if the user needs more results
 
 ## Quick Reference
 
 | Item | Value |
 |------|-------|
-| OpenClaw config | `~/.openclaw/openclaw.json` |
-| Plugin config key | `plugins.entries["memorylake-openclaw"].config` |
+| Config script | `{path-to-this-skill}/../common/get-config.mjs --agent {agent}` |
 | Server base path | `/openapi/memorylake` |
 | OpenAPI spec URL | `{host}/openapi/memorylake/api-docs/open-api` |
 | Auth header | `Authorization: Bearer {apiKey}` |

package/skills/memorylake-upload/SKILL.md

@@ -16,21 +16,15 @@ Upload local files to MemoryLake using the multipart upload API, then associate
 
 ## Step 1 -- Read MemoryLake Config
 
-Read `~/.openclaw/openclaw.json` and extract the plugin config:
+Run the common config script (path is relative to **this skill's SKILL.md**, i.e. `../common/get-config.mjs`):
 
 ```bash
-cat ~/.openclaw/openclaw.json | jq '.plugins.entries["memorylake-openclaw"].config'
+node {path-to-this-skill}/../common/get-config.mjs --agent {agent}
 ```
 
-Extract these values:
+Where `{agent}` is the current agent ID. The script outputs JSON config with `host`, `apiKey`, `projectId`, etc.
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `host` | API host | `https://app.memorylake.ai` |
-| `apiKey` | API key for authentication | (required) |
-| `projectId` | MemoryLake project ID | (required) |
-
-If `apiKey` or `projectId` is missing, stop and inform the user.
+If the script exits with an error, stop and inform the user.
 
 ## Step 2 -- Run the Upload Script
 
@@ -56,5 +50,5 @@ The script prints progress for each step (create upload, upload parts, complete,
 
 ## Common Mistakes
 
-- **Skipping Step 1**: Directly hardcoding host/apiKey/projectId instead of reading from `~/.openclaw/openclaw.json`
+- **Skipping Step 1**: Directly hardcoding host/apiKey/projectId instead of using the config script
 - **Relative file paths**: Always resolve the user's file path to an absolute path before passing to the script

package/skills/migrate-memories-to-memorylake/SKILL.md

@@ -17,8 +17,8 @@ Extract memory files and conversation history from session files, then submit th
 ## Prerequisites
 
 The caller must provide:
+- **`agent`**: The agent name (e.g., `main`). Used to resolve config (Step 1) and locate session files (Step 2).
 - **`user_id`**: The user ID for filtering sessions (e.g., a Feishu user ID like `ou_xxx`). **This is only used for session filtering, NOT for the API request.**
-- **`agent`**: The agent name (e.g., `main`)
 
 ## Preferred: Run the Migration Script
 
@@ -40,26 +40,15 @@ If the script fails, follow these steps manually.
 
 ### Step 1 — Read MemoryLake Config
 
-Read `~/.openclaw/openclaw.json` and extract the plugin config:
+Run the common config script (path is relative to **this skill's SKILL.md**, i.e. `../common/get-config.mjs`):
 
 ```bash
-cat ~/.openclaw/openclaw.json | jq '.plugins.entries["memorylake-openclaw"].config'
+node {path-to-this-skill}/../common/get-config.mjs --agent {agent}
 ```
 
-Extract these values:
-- **`host`** — API host (default: `https://app.memorylake.ai`)
-- **`apiKey`** — API key for authentication
-- **`projectId`** — MemoryLake project ID
+The script outputs JSON config with `host`, `apiKey`, `projectId`, `workspace`, etc. If the script exits with an error, stop and inform the user.
 
-### Step 2 — Identify User and Agent
-
-Use the `user_id` and `agent` provided by the caller:
-- `user_id` — only for filtering sessions in Step 3 (session keys contain the user ID)
-- `agent` — determines which agent's session directory to read
-
-**When POSTing to the API, always use `"user_id": "default"`. Do NOT use the caller-provided `user_id`.**
-
-### Step 3 — Filter Sessions by User ID
+### Step 2 — Filter Sessions by User ID
 
 **You MUST use `sessions.json` to filter sessions. Do NOT grep/search JSONL files directly.**
 
@@ -83,29 +72,21 @@ Use the `user_id` and `agent` provided by the caller:
    ~/.openclaw/agents/{agent}/sessions/{sessionId}.jsonl
    ```
 
-### Step 4 — Read Memory Files
-
-Resolve the workspace path for the agent:
-
-1. Check `agents.list` for an entry with `id` matching the agent. If it has a `workspace` field, use it.
-2. Otherwise, fall back to `agents.defaults.workspace`.
+### Step 3 — Read Memory Files
 
-```bash
-# Agent-specific workspace (e.g., agent "foo"):
-cat ~/.openclaw/openclaw.json | jq -r '.agents.list[] | select(.id == "{agent}") | .workspace'
-# Default workspace:
-cat ~/.openclaw/openclaw.json | jq -r '.agents.defaults.workspace'
-```
-
-Then read:
+Use the `workspace` path from the config output in Step 1. Then read:
 - `{workspace}/MEMORY.md`
 - All files in `{workspace}/memory/` directory
 
 These contain curated memory that should also be migrated.
 
-### Step 5 — Submit Data to MemoryLake
+### Step 4 — Submit Data to MemoryLake
+
+Use `host`, `apiKey`, `projectId` from the config output in Step 1.
+
+**When POSTing to the API, always use `"user_id": "default"`. Do NOT use the caller-provided `user_id`.**
 
-#### 5a — Submit Session Conversations
+#### 4a — Submit Session Conversations
 
 For each matched `.jsonl` session file:
 
@@ -156,7 +137,7 @@ For each matched `.jsonl` session file:
      }
    }
    ```
-#### 5b — Submit Memory Files
+#### 4b — Submit Memory Files
 
 For each memory file (`MEMORY.md` and files in `memory/`):
 
@@ -203,11 +184,10 @@ At the end, print a summary:
 
 | Item | Path / Value |
 |------|-------------|
-| Config file | `~/.openclaw/openclaw.json` |
-| Plugin config key | `plugins.entries["memorylake-openclaw"].config` |
+| Config script | `{path-to-this-skill}/../common/get-config.mjs --agent {agent}` |
 | Session index | `~/.openclaw/agents/{agent}/sessions/sessions.json` |
 | Session files | `~/.openclaw/agents/{agent}/sessions/{id}.jsonl` |
-| Workspace path | `agents.defaults.workspace` in config |
+| Workspace path | from config script output (`workspace` field) |
 | API endpoint | `{host}/openapi/memorylake/api/v2/projects/{projectId}/memories` |
 | Auth header | `Authorization: Bearer {apiKey}` |
 | Default host | `https://app.memorylake.ai` |

package/skills/migrate-memories-to-memorylake/scripts/migrate.mjs

@@ -8,50 +8,27 @@
  */
 
 import { readFileSync, readdirSync, existsSync, statSync } from "fs";
-import { join, basename } from "path";
+import { join, basename, dirname } from "path";
 import { homedir } from "os";
 import { parseArgs } from "util";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
-const OPENCLAW_CONFIG = join(homedir(), ".openclaw", "openclaw.json");
 const BATCH_SIZE = 20;
 const API_USER_ID = "default";
 
-function loadConfig(agent) {
-  const config = JSON.parse(readFileSync(OPENCLAW_CONFIG, "utf-8"));
-
-  const pluginCfg =
-    config?.plugins?.entries?.["memorylake-openclaw"]?.config ?? {};
-
-  const host = (pluginCfg.host || "https://app.memorylake.ai").replace(
-    /\/$/,
-    ""
-  );
-  const apiKey = pluginCfg.apiKey || "";
-  const projectId = pluginCfg.projectId || "";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const GET_CONFIG_PATH = join(__dirname, "../../common/get-config.mjs");
 
-  if (!apiKey) {
-    console.error("ERROR: apiKey is missing from config");
-    process.exit(1);
-  }
-  if (!projectId) {
-    console.error("ERROR: projectId is missing from config");
-    process.exit(1);
-  }
-
-  // Resolve workspace: agent-specific first, then defaults
-  const agentsCfg = config.agents ?? {};
-  let workspace = "";
-  for (const entry of agentsCfg.list ?? []) {
-    if (entry.id === agent) {
-      workspace = entry.workspace || "";
-      break;
-    }
-  }
-  if (!workspace) {
-    workspace = agentsCfg.defaults?.workspace || "";
+function loadConfig(agent) {
+  const result = spawnSync(process.execPath, [GET_CONFIG_PATH, "--agent", agent], {
+    encoding: "utf-8",
+    stdio: ["inherit", "pipe", "inherit"],
+  });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
   }
-
-  return { host, apiKey, projectId, workspace };
+  return JSON.parse(result.stdout);
 }
 
 async function postMemories(host, apiKey, projectId, payload) {