openclaw-mova
v1.0.3
Published
MOVA HITL tools for OpenClaw — native agent tools for contract-driven business workflows
Maintainers
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:
- Verdict —
fulfilled/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:
| Component | Type | Purpose |
|---|---|---|
| openclaw-mova (this plugin) | Plugin | Required. Provides all 21 execution tools |
| mova-connector-setup | Ecosystem skill | Connect your real ERP, CRM, AML systems instead of sandbox mocks |
Contract skills — install whichever workflows your org needs:
| Skill | What it runs |
|---|---|
| mova-invoice-ocr | Invoice OCR extraction + AP approval gate |
| mova-po-approval | Purchase order risk analysis + procurement approval gate |
| mova-aml-triage | AML alert L1 triage + compliance officer decision gate |
| mova-complaints-handler | EU customer complaint classification + handling gate |
| mova-crypto-review | Crypto trade risk analysis + human approval gate |
| mova-compliance-audit | GDPR / PCI-DSS / ISO 27001 / SOC 2 audit + sign-off gate |
| mova-credit-scoring | Credit risk scoring + credit officer approval gate |
| mova-supply-chain-risk | Supplier sanctions / ESG screening + procurement gate |
| mova-churn-prediction | Customer churn prediction + retention campaign approval gate |
| mova-contract-generation | Legal 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:
| Component | Type | Purpose |
|---|---|---|
| openclaw-mova (this plugin) | Plugin | Required |
| mova-intent-calibration | Ecosystem skill | Crystallizes a raw request into a bounded, testable intent — the input for contract authoring |
| mova-spec-guide | Ecosystem skill | Reference for the MOVA spec language: schemas, envelopes, verbs, instruction profiles |
| mova-spec-authoring | Ecosystem skill | Authors a complete MOVA contract from a crystallized intent |
| mova-user-contract-setup | Ecosystem skill | Registers your contract at MOVA and runs the first test |
| mova-contract-discovery | Ecosystem skill | Finds and runs public contracts from other organizations |
| mova-connector-setup | Ecosystem skill | Connects your real business systems |
The build path:
mova-intent-calibration— define exactly what the contract must domova-spec-guide— understand the spec structure if neededmova-spec-authoring— write the contract from the crystallized intent- Host the contract JSON at your GitHub / S3 / any HTTPS URL
mova-user-contract-setup— register with MOVA and run the first test- 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-0012. Set your OpenRouter key — LLM costs go to your own account:
openclaw config set plugins.entries.mova.config.llmKey sk-or-v1-YOUR_KEYGet 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-miniOptional — override the base URL for self-hosted or staging:
openclaw config set plugins.entries.mova.config.baseUrl https://your-mova-instance.example.comAll 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
