openclaw-safeclaw-plugin 2.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -7
- package/SKILL.md +8 -0
- package/openclaw.plugin.json +11 -3
- package/package.json +10 -2
package/README.md
CHANGED
|
@@ -4,13 +4,7 @@ Neurosymbolic governance plugin for OpenClaw AI agents. Validates every tool cal
|
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
|
-
### Via
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
openclaw plugins install safeclaw
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
### Manual install
|
|
7
|
+
### Via npm (recommended)
|
|
14
8
|
|
|
15
9
|
```bash
|
|
16
10
|
npm install -g openclaw-safeclaw-plugin
|
|
@@ -20,6 +14,8 @@ safeclaw-plugin restart-openclaw
|
|
|
20
14
|
|
|
21
15
|
The `setup` command copies the plugin manifest to `~/.openclaw/extensions/safeclaw/` and enables it in `~/.openclaw/openclaw.json`. After install, restart OpenClaw to activate the plugin.
|
|
22
16
|
|
|
17
|
+
> Install from npm (above) or from source (`git clone` + `npm install && npm run build` in `openclaw-safeclaw-plugin/`). This plugin is **not** on ClawHub — the `safeclaw` id there belongs to an unrelated third-party plugin, not this project.
|
|
18
|
+
|
|
23
19
|
## Quick Start
|
|
24
20
|
|
|
25
21
|
1. Install the plugin (see above)
|
package/SKILL.md
CHANGED
|
@@ -2,6 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
SafeClaw validates every tool call, message, and agent action against OWL ontologies and SHACL constraints before execution. It acts as a governance gate between your AI agent and the tools it uses.
|
|
4
4
|
|
|
5
|
+
> **Requires OpenClaw v2026.6.8 or newer.** The plugin reads v2026.6.8 hook
|
|
6
|
+
> payloads; on older hosts governance data is incomplete.
|
|
7
|
+
|
|
5
8
|
## What it does
|
|
6
9
|
|
|
7
10
|
- **Blocks dangerous actions** -- force push, deleting root, exposing secrets
|
|
@@ -24,6 +27,11 @@ SafeClaw validates every tool call, message, and agent action against OWL ontolo
|
|
|
24
27
|
- `subagent_spawning` / `subagent_ended` -- multi-agent governance
|
|
25
28
|
- `session_start` / `session_end` -- session lifecycle tracking
|
|
26
29
|
|
|
30
|
+
> The `llm_input`/`llm_output` audit hooks only fire when you grant raw
|
|
31
|
+
> conversation access:
|
|
32
|
+
> `plugins.entries.safeclaw.hooks.allowConversationAccess: true`. Without it the
|
|
33
|
+
> LLM audit trail is silently empty.
|
|
34
|
+
|
|
27
35
|
## Agent tools
|
|
28
36
|
|
|
29
37
|
- `safeclaw_status` -- check governance service status and active enforcement mode
|
package/openclaw.plugin.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"id": "safeclaw",
|
|
3
3
|
"name": "SafeClaw Neurosymbolic Governance",
|
|
4
4
|
"description": "Validates AI agent actions against OWL ontologies and SHACL constraints before execution",
|
|
5
|
-
"version": "2.0.
|
|
5
|
+
"version": "2.0.1",
|
|
6
6
|
"author": "Tendly EU",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"homepage": "https://safeclaw.eu",
|
|
@@ -23,13 +23,21 @@
|
|
|
23
23
|
},
|
|
24
24
|
"enforcement": {
|
|
25
25
|
"type": "string",
|
|
26
|
-
"enum": [
|
|
26
|
+
"enum": [
|
|
27
|
+
"enforce",
|
|
28
|
+
"warn-only",
|
|
29
|
+
"audit-only",
|
|
30
|
+
"disabled"
|
|
31
|
+
],
|
|
27
32
|
"default": "enforce",
|
|
28
33
|
"description": "Enforcement mode: enforce blocks violations, warn-only logs, audit-only records silently"
|
|
29
34
|
},
|
|
30
35
|
"failMode": {
|
|
31
36
|
"type": "string",
|
|
32
|
-
"enum": [
|
|
37
|
+
"enum": [
|
|
38
|
+
"open",
|
|
39
|
+
"closed"
|
|
40
|
+
],
|
|
33
41
|
"default": "open",
|
|
34
42
|
"description": "Behavior when service is unreachable: open allows actions, closed blocks them"
|
|
35
43
|
},
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openclaw-safeclaw-plugin",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.1",
|
|
4
4
|
"description": "SafeClaw Neurosymbolic Governance plugin for OpenClaw — validates AI agent actions against OWL ontologies and SHACL constraints",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -16,7 +16,15 @@
|
|
|
16
16
|
"openclaw": {
|
|
17
17
|
"extensions": [
|
|
18
18
|
"dist/index.js"
|
|
19
|
-
]
|
|
19
|
+
],
|
|
20
|
+
"compat": {
|
|
21
|
+
"pluginApi": ">=2026.6.8",
|
|
22
|
+
"minGatewayVersion": "2026.6.8"
|
|
23
|
+
},
|
|
24
|
+
"build": {
|
|
25
|
+
"openclawVersion": "2026.6.8",
|
|
26
|
+
"pluginSdkVersion": "2026.6.8"
|
|
27
|
+
}
|
|
20
28
|
},
|
|
21
29
|
"files": [
|
|
22
30
|
"dist/",
|