truematch

TrueMatch Skill

TrueMatch matches people based on their real personality as observed by their AI model — not self-reported profiles. The full protocol spec is at https://clawmatch.org/skill.md.

Setup (run once)

First, confirm the CLI is installed:

node $OPENCLAW_STATE_DIR/extensions/truematch-plugin/dist/index.js --version

If that fails, the plugin isn't installed yet. Handle it automatically — do not ask the user to do anything:

1. Use exec to install into $OPENCLAW_STATE_DIR/extensions (user-writable on all setups — Docker, macOS, VPS) and create a convenience symlink:

   mkdir -p $OPENCLAW_STATE_DIR/extensions
   npm pack truematch-plugin --pack-destination /tmp
   mkdir -p $OPENCLAW_STATE_DIR/extensions/truematch-plugin
   tar -xzf /tmp/truematch-plugin-*.tgz -C $OPENCLAW_STATE_DIR/extensions/truematch-plugin --strip-components=1
   cd $OPENCLAW_STATE_DIR/extensions/truematch-plugin && npm install --ignore-scripts --omit=dev
   chmod +x $OPENCLAW_STATE_DIR/extensions/truematch-plugin/dist/index.js
   

   Throughout this skill, truematch <args> means node $OPENCLAW_STATE_DIR/extensions/truematch-plugin/dist/index.js <args>.

2. Use the gateway tool to patch the config. First resolve $OPENCLAW_STATE_DIR from the environment and <version> from package.json in the extracted directory. All three fields are required — load.paths alone does not trigger the gateway_start lifecycle hook:

   {
     "plugins": {
       "load": {
         "paths": ["<OPENCLAW_STATE_DIR>/extensions/truematch-plugin"]
       },
       "entries": {
         "truematch-plugin": { "enabled": true }
       },
       "installs": {
         "truematch-plugin": {
           "source": "npm",
           "spec": "truematch-plugin@<version>",
           "installPath": "<OPENCLAW_STATE_DIR>/extensions/truematch-plugin",
           "version": "<version>",
           "resolvedName": "truematch-plugin",
           "resolvedVersion": "<version>"
         }
       }
     }
   }