Make OpenClaw memory operationally reliable.
Catch embeddings/provider failures early instead of discovering them after memory search breaks.
Keep recovery simple: restore agents, config, memory, and workspaces on a fresh machine.
Prefer safe defaults, especially around gateway restarts.

Current features

clawkeeper doctor
- Reads the current OpenClaw memorySearch config
- Shows OpenClaw memory status when available
- For provider=openai, runs a real minimal embeddings probe
- For provider=ollama, checks reachability and whether nomic-embed-text is present
clawkeeper switch openai|ollama [--dry-run]
- --dry-run previews the provider/config change without writing config or restarting the gateway
- Real switches update agents.defaults.memorySearch.provider
- Switching to ollama removes memorySearch.remote from that section to avoid stale OpenAI config there
- Makes a timestamped backup of ~/.openclaw/openclaw.json before any real write
- Restarts the gateway after a real config change
clawkeeper backup-plan [--json]
- Prints recommended daily/weekly backup coverage
- --json emits machine-readable include/exclude structure
clawkeeper verify-backup <path.tgz>
- Validates that a backup tarball contains required OpenClaw paths
- Exits non-zero when critical paths are missing
clawkeeper restore-guide
- Prints a safe restore procedure for a new machine
clawkeeper restore-apply <path.tgz> [--restart-gateway]
- Safe default: renames existing ~/.openclaw before extracting backup
- Does not restart the gateway unless --restart-gateway is explicitly passed

Install / run

Local dev

npm install
npm run build
node dist/cli.js --help

Global install

npm install -g .
clawkeeper --help

Compatibility alias is also kept for now:

memops --help

Usage

clawkeeper doctor
clawkeeper switch ollama
clawkeeper switch openai
clawkeeper switch ollama --dry-run
clawkeeper switch openai --dry-run
clawkeeper backup-plan
clawkeeper backup-plan --json
clawkeeper verify-backup ~/openclaw-backup.tgz
clawkeeper restore-guide
clawkeeper restore-apply ~/openclaw-backup.tgz
clawkeeper restore-apply ~/openclaw-backup.tgz --restart-gateway

Repo rule detector (script)

If you need to quickly see what GitHub repo rules might block merges (repo rulesets + classic branch protection), run:

node scripts/repo-rule-detector.mjs dtzp555-max/ocm --branch main

Example output (dtzp555-max/ocm):

{
  "repo": "dtzp555-max/ocm",
  "url": "https://github.com/dtzp555-max/ocm",
  "defaultBranch": "main",
  "branch": "main",
  "allowedMergeMethods": {
    "mergeCommit": true,
    "squash": true,
    "rebase": true
  },
  "rulesetsRulePresence": {
    "required_linear_history": true,
    "non_fast_forward": true,
    "deletion": true
  },
  "branchProtection": {
    "enabled": false
  },
  "rulesets": [
    {
      "id": 13362557,
      "name": "ocm",
      "enforcement": "active",
      "target": null,
      "rules": {
        "pull_request": {
          "present": true,
          "parameters": {
            "required_review_thread_resolution": true,
            "allowed_merge_methods": [
              "merge",
              "squash",
              "rebase"
            ],
            "required_approving_review_count": 0,
            "require_code_owner_review": false,
            "dismiss_stale_reviews_on_push": false,
            "require_last_push_approval": false
          }
        },
        "required_linear_history": {
          "present": true
        },
        "non_fast_forward": {
          "present": true
        },
        "deletion": {
          "present": true
        }
      }
    }
  ]
}

Safety notes

This tool edits ~/.openclaw/openclaw.json.

Always makes a timestamped backup before modifying config.
Never prints secrets; reports only whether keys are present.
restore-apply uses safe mode by default.
Gateway restart is opt-in during restore because restart/install flows can be disruptive on a live machine.

Non-goals

Replacing OpenClaw memory-core
Uploading user memory content to Git
Automatically making risky service changes during restore without explicit request

Requirements

OpenClaw CLI installed on the same machine
Node.js 20+

ocm — local dashboard and built-in CLI for operating OpenClaw with less config friction.
execution-agent-planner — skill for deciding when to keep work with one execution agent vs split across multiple workers.
gh-pr-release-flow — skill for PR-first GitHub workflows, protected branches, and release-after-merge habits.

License

MIT

README.md

clawkeeper