Skip to content

Releases

v0.3.1

Choose a tag to compare

@superWorldSavior superWorldSavior released this 04 Nov 04:02

Version 0.3.1 provides the same plugin in two distributions:

  • ClawHub: lightweight plugin, with an explicit, separately downloaded SysML Toolkit.
  • GitHub: complete prebuilt archive, including all Toolkit 0.10.10 files and licenses.

The runtime, viewer, diagnostics and Oxigraph are identical in both. Plugin installation and export never download the Toolkit automatically. The selected Toolkit is verified against pinned SHA-256 hashes before use. A missing external Toolkit is reported explicitly and the export remains available; a damaged complete package never silently falls back to a cache.

Install from ClawHub

openclaw plugins install clawhub:@casys/openclaw-sysmlv2-export@0.3.1 --accept-capabilities
openclaw sysmlv2-toolkit install
openclaw sysmlv2-toolkit status
openclaw sysmlv2-export

--accept-capabilities gives the consent OpenClaw requires for the plugin's declared capabilities. For an offline Toolkit archive, use openclaw sysmlv2-toolkit install --from ./sysml-wasm-0.10.10.tgz.

Install the complete GitHub package

Download the named .tgz asset and SHA256SUMS below. Follow INSTALL-0.3.1.md for fail-closed checksum verification, installation and first export. The automatic “Source code” archives do not include generated bundles and Toolkit files.

Complete archive SHA-256:

e22c30f8faba78e43e607e8a5274a3c5ec02034b2c22fe33334e5da7680792d6

Requires OpenClaw 2026.10.9+ and Node 24.22.1+ or 26.12.1+. Preview status is unchanged.
See the changelog and full illustrated README.

v0.3.0

Choose a tag to compare

@superWorldSavior superWorldSavior released this 03 Nov 15:20

Install the plugin and everything works: the SysML Toolkit now ships inside the package, so every export is validated and checked with no extra step and nothing to download.

Download and install 0.3.0

The attached casys-openclaw-sysmlv2-export-0.3.0.tgz is the complete, prebuilt
plugin: all nine pinned SysML Toolkit 0.10.10 files, Oxigraph, the viewer,
diagnostic rules and licenses are included. No Deno build or separate Toolkit
download is needed.

Requires OpenClaw 2026.10.9 or later and its supported Node.js runtime
(24.22.1+ or 26.12.1+).

Run the following on the machine hosting your OpenClaw Gateway. The checksum
must pass before installation. --force confirms this archive as the source
and permits replacing an existing sysmlv2-export installation;
--accept-capabilities accepts the plugin's declared capabilities.

(
  set -eu
  mkdir -p openclaw-sysmlv2-export-0.3.0
  cd openclaw-sysmlv2-export-0.3.0
  curl --fail --location --output casys-openclaw-sysmlv2-export-0.3.0.tgz \
    https://github.com/Casys-AI/openclaw-sysmlv2-export/releases/download/v0.3.0/casys-openclaw-sysmlv2-export-0.3.0.tgz
  curl --fail --location --output SHA256SUMS \
    https://github.com/Casys-AI/openclaw-sysmlv2-export/releases/download/v0.3.0/SHA256SUMS
  if command -v sha256sum >/dev/null 2>&1; then
    sha256sum --check SHA256SUMS
  else
    shasum -a 256 --check SHA256SUMS
  fi
  openclaw plugins install ./casys-openclaw-sysmlv2-export-0.3.0.tgz \
    --force --accept-capabilities
)

SHA-256 of the plugin archive:

6a930ee9007a98e7e4176446cf7c8eaaa6c4a6d68c8b5b8d271ee8422ea8814f

After installation, follow any Gateway restart instruction printed by OpenClaw,
then verify the bundled Toolkit and make an export:

openclaw sysmlv2-toolkit status
openclaw sysmlv2-export

The Toolkit status should report version 0.10.10 and verified: true. The
export writes a standalone index.html viewer. Open it in your browser; for a
remote Gateway, copy the export directory to your computer first. Inferred
behaviour remains optional (--infer).
See the plugin README
for configuration and inference options.

Use the named .tgz asset above, rather than GitHub's automatic “Source
code” archives, which do not contain the generated plugin bundles and Toolkit.
ClawHub publication of 0.3.0 is still pending; the archive installation above
installs this GitHub release directly.

Highlights

  • Toolkit bundled. The pinned sysml-toolkit 0.10.10 WebAssembly build (Apache-2.0 and EPL-2.0, licenses included) sits in toolkit/ next to Oxigraph. Every load still checks each file against its pinned SHA-256.
  • A viewer that tells the truth.
    • Each version says whether its checks ran and whether your configuration changed or the export was only re-emitted. Only real changes are marked.
    • The Doctor groups findings, says what is new or resolved since the last checked version, and never shows a clean list when checks did not run.
  • Reach view. It shows who can delegate to whom, up to an agent with unapproved host exec. Clicking a delegation finding lights its cycle, and widened grants sit under the exec they reach.
  • Reading at scale.
    • Fit uses the space, and F or Enter frames an element.
    • Zoomed out, Behaviour shows titled procedures, and Behaviour lists procedures and states the agent's authority.
    • Back and Forward work, every element has a link, and Doctor and Changes entries select without leaving the panel.
  • More of the configuration shown.
    • Posture: network, workspace access, external binds and elevated.
    • Hook mappings, Overview figures, Tools filtered by holder count and grouped by OpenClaw capability, and the model and delivery of each scheduled task.
    • The scheduled week is placed in UTC at the version's instant, with each task's agent in its own column.
  • New check PROSE_NOT_ENFORCED. It flags an inferred exec prohibition or constraint that the configuration does not enforce.
  • Stable inference. An agent keeps its earlier inference when what the model is sent has not changed.

Upgrading

  • openclaw sysmlv2-toolkit install and --from are gone; openclaw sysmlv2-toolkit status verifies the bundled files.
  • A <state dir>/sysmlv2-export-toolkit/ folder from an earlier install is no longer read and can be deleted.
  • The snapshot schema and the inference contract are unchanged; older exports read as before.

Full list in CHANGELOG.md.

0.2.0

Choose a tag to compare

@superWorldSavior superWorldSavior released this 03 Nov 09:39

The snapshot schema stays openclaw-snapshot/5, with one optional field,
plaintextCredentialPaths; the inference contract is unchanged.

  • APE rules on the model graph. With the Toolkit installed, every export
    checks APE good practices on the graph of its SysML model: the Toolkit's
    element graph, projected to the versioned openmbee-v2 RDF subset, is queried
    through a scoped SHACL SPARQL profile on Oxigraph in WebAssembly. Three rules:
    an agent that can reach unapproved host exec through delegation, delegation
    cycles, unreachable agents; each names the agents involved. Views and
    constraints are in rules/ape/ape.ttl; a completed analysis writes
    ape-report.ttl. Findings start with APE_ and join the others. The same
    shapes produced matching findings and related pairs on synthetic baseline and
    extended fixtures using unmodified
    OpenSysML v0.11.0
    Turtle. The projection is a subset, not an identical native graph; the
    mapping and test oracle describe the boundaries.

  • Agent links are SysML references. Delegation is a DelegationRule
    connection between two agents, with a DelegationPolicy keeping the literal
    targets and wildcards; messaging targets, hook targets and scheduled-task
    targets refer to agents. Unknown targets stay explicit (unresolvedTarget,
    unresolvedTargets). Consumers of the former String attributes must follow
    the new form.

  • Diagnostics. Sixteen OpenClaw configuration checks and three portable APE
    checks run as SHACL rules on the compiled SysML model. The Doctor panel
    displays the findings and collector notes. With no Toolkit, model checks are
    skipped and collector notes remain available; no TypeScript fallback runs.
    CRON_FAILING is dropped because runtime health is not emitted. The
    diagnose CLI checks an existing export without writing to it.

  • Model validation. openclaw sysmlv2-toolkit install installs the pinned
    sysml-toolkit 0.10.10 WebAssembly release, downloaded or from a local copy
    with --from, and status checks it. Once it is installed, every export is
    compiled in a worker stopped after 60 seconds: the summary and versions.json
    give the result, validation.json the diagnostics, and a failed validation
    keeps the export. No Assembly checkout is needed any more.

  • CI compiles exports with the pinned public archive.

  • Overview. The viewer opens on a table of the agents: model, host or
    sandbox, tools by origin, channel accounts, scheduled tasks, context and, with
    inference, procedures and rules, under the instance's totals. Each row names
    the declarations it sums up and links to the agent in the other views.

  • Tools as an allocation matrix. The Tools diagram becomes a SysML
    allocation matrix of tools (by origin and provider) against agents, each cell
    an agent's grant on the host, in the sandbox or both. Header and first column
    stay in place, groups fold and count each agent's tools, a filter keeps the
    matching tools, and rows, columns and cells show what changed and open their
    SysML.

  • Rules as a requirements table. A Behaviour view keeps its procedures as
    action flows and lists its rules under them: name, kind, text and source,
    sortable and filtered by kind, each linked to its SysML lines. Many procedures
    wrap into rows instead of one wide row.

  • A week of scheduled tasks. Under the Scheduled tasks diagram, a 7 × 24
    hour strip per task shows when each cron schedule fires, in its own time zone,
    and the intervals that run all week; one-shot and date-bound schedules are
    listed as not weekly.

  • A table under a diagram can be resized, and schedules in words also read day
    ranges and names (MON-FRI).

  • A sidebar. An icon rail on the right opens the Inspector, Changes and
    Doctor panels, with their counts on the icons. The sidebar sits beside the
    diagram and the table, collapses, and keeps the width you drag it to. Changes
    lists what was added, changed and removed, with each changed value before and
    after; the inspector strikes the old value above the new one and folds each
    piece of SysML to its first line. View and version pickers show a larger,
    styled list where the browser allows it.