MOVA

v1.0.3

MOVA HITL tools for OpenClaw — native agent tools for contract-driven business workflows

openclaw-mova·runtime mova·by @mova-compact
Code Pluginsource linkedCommunity code plugin. Review compatibility and verification before install.

README


name: openclaw-mova description: MOVA contract execution ecosystem for OpenClaw. Provides 21 tools to execute AI contracts with human-in-the-loop decision gates, manage connectors, register and run custom contracts, and browse the public contract marketplace. Install this plugin first, then add the contract skills or ecosystem skills you need. license: MIT-0 metadata: {"openclaw":{"plugin":{"name":"MOVA","installCmd":"openclaw plugins install openclaw-mova"},"dataSentToExternalServices":[{"service":"MOVA API (api.mova-lab.eu, EU-hosted, Cloudflare Worker)","data":"contract inputs, decision data, audit metadata, apiKey in Authorization header, llmKey in X-LLM-Key header"},{"service":"OpenRouter (openrouter.ai) — via MOVA API proxy, not directly by this plugin","data":"contract prompts and inputs forwarded by MOVA API for LLM processing; billed to the user-provided llmKey"}],"security":{"fileIO":"none","arbitraryNetworkCalls":"none — plugin calls only https://api.mova-lab.eu (configurable via baseUrl); MOVA API then proxies LLM calls to OpenRouter","credentialStorage":"apiKey and llmKey stored in OpenClaw plugin config, sent only to the configured baseUrl"}}}

MOVA — Contract Execution for AI Agents

What is MOVA

MOVA is a language and execution runtime for governed AI processes. At its core is the concept of a contract — a structured specification that defines:

  • what the agent does at each step
  • where it must stop and hand control to a human (HITL gate)
  • which policies are enforced (cannot be skipped or bypassed)
  • how every action is recorded

A contract is not a script or a prompt. It is a MOVA-spec artifact: input definitions, execution steps, instruction profiles, and human control gates. The contract lives at the author's URL — GitHub, S3, or any HTTPS address. MOVA fetches it, validates it, and executes it.

What the user receives after execution:

  • Verdictfulfilled / partially_fulfilled / failed
  • Step outputs — structured data from each execution step
  • Signed audit receipt — an immutable record of every event: who initiated the run, what the agent did, what the human decided, at exactly what moment. Stored permanently, retrievable by run_id. Designed to satisfy EU AI Act, AMLD6, and GDPR auditability requirements.

Two ways to use MOVA


Path 1 — Use ready-made contracts

Install the plugin, add the contract skills you need, and your agent immediately has complete AI-governed business workflows with HITL gates and full audit trails.

Required:

ComponentTypePurpose
openclaw-mova (this plugin)PluginRequired. Provides all 21 execution tools
mova-connector-setupEcosystem skillConnect your real ERP, CRM, AML systems instead of sandbox mocks

Contract skills — install whichever workflows your org needs:

SkillWhat it runs
mova-invoice-ocrInvoice OCR extraction + AP approval gate
mova-po-approvalPurchase order risk analysis + procurement approval gate
mova-aml-triageAML alert L1 triage + compliance officer decision gate
mova-complaints-handlerEU customer complaint classification + handling gate
mova-crypto-reviewCrypto trade risk analysis + human approval gate
mova-compliance-auditGDPR / PCI-DSS / ISO 27001 / SOC 2 audit + sign-off gate
mova-credit-scoringCredit risk scoring + credit officer approval gate
mova-supply-chain-riskSupplier sanctions / ESG screening + procurement gate
mova-churn-predictionCustomer churn prediction + retention campaign approval gate
mova-contract-generationLegal document generation (NDA, SLA) + section-by-section review gates

Path 2 — Build and publish your own contracts

Go from raw idea to an executable, auditable MOVA contract. Keep it private, share it with your org, or publish it on ClawHub for others to use.

Required:

ComponentTypePurpose
openclaw-mova (this plugin)PluginRequired
mova-intent-calibrationEcosystem skillCrystallizes a raw request into a bounded, testable intent — the input for contract authoring
mova-spec-guideEcosystem skillReference for the MOVA spec language: schemas, envelopes, verbs, instruction profiles
mova-spec-authoringEcosystem skillAuthors a complete MOVA contract from a crystallized intent
mova-user-contract-setupEcosystem skillRegisters your contract at MOVA and runs the first test
mova-contract-discoveryEcosystem skillFinds and runs public contracts from other organizations
mova-connector-setupEcosystem skillConnects your real business systems

The build path:

  1. mova-intent-calibration — define exactly what the contract must do
  2. mova-spec-guide — understand the spec structure if needed
  3. mova-spec-authoring — write the contract from the crystallized intent
  4. Host the contract JSON at your GitHub / S3 / any HTTPS URL
  5. mova-user-contract-setup — register with MOVA and run the first test
  6. Optionally publish the skill on ClawHub so others can use it

Setup

1. Set the shared MOVA API key (open access, no registration needed):

openclaw config set plugins.entries.mova.config.apiKey test-key-001

2. Set your OpenRouter key — LLM costs go to your own account:

openclaw config set plugins.entries.mova.config.llmKey sk-or-v1-YOUR_KEY

Get an OpenRouter key at openrouter.ai/keys.

3. Optionally set the model (default: openai/gpt-4o-mini):

openclaw config set plugins.entries.mova.config.llmModel openai/gpt-4o-mini

Optional — override the base URL for self-hosted or staging:

openclaw config set plugins.entries.mova.config.baseUrl https://your-mova-instance.example.com

All 21 tools

HITL contract execution

mova_hitl_start · mova_hitl_start_po · mova_hitl_start_trade · mova_hitl_start_aml · mova_hitl_start_complaint · mova_hitl_start_compliance · mova_hitl_start_credit · mova_hitl_start_supply_chain · mova_hitl_start_churn · mova_hitl_start_contract_gen · mova_hitl_decide · mova_hitl_status · mova_hitl_audit · mova_hitl_audit_compact · mova_calibrate_intent

Connector registry

mova_list_connectors · mova_list_connector_overrides · mova_register_connector · mova_delete_connector_override

User contract registry & execution

mova_register_contract · mova_list_my_contracts · mova_set_contract_visibility · mova_delete_contract · mova_run_contract · mova_run_status

Public marketplace

mova_discover_contracts

Capabilities

configSchema
Yes
Executes code
Yes
HTTP routes
0
Runtime ID
mova

Compatibility

Built With Open Claw Version
2026.3.13
Plugin Api Range
^0.4.0

Verification

Tier
source linked
Scope
artifact only
Summary
Validated package structure and linked the release to source metadata.
Commit
78741de
Tag
main
Provenance
No
Scan status
clean

Tags

latest
1.0.3