Repository navigation
Releases
v0.3.1
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
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-exportThe 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 installand--fromare gone;openclaw sysmlv2-toolkit statusverifies 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
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 versionedopenmbee-v2RDF 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 inrules/ape/ape.ttl; a completed analysis writes
ape-report.ttl. Findings start withAPE_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 aDelegationPolicykeeping 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_FAILINGis dropped because runtime health is not emitted. The
diagnoseCLI checks an existing export without writing to it. -
Model validation.
openclaw sysmlv2-toolkit installinstalls the pinned
sysml-toolkit 0.10.10 WebAssembly release, downloaded or from a local copy
with--from, andstatuschecks it. Once it is installed, every export is
compiled in a worker stopped after 60 seconds: the summary andversions.json
give the result,validation.jsonthe 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.