Compare commits

...

16 Commits

Author SHA1 Message Date
David Abutbul db091fb8b3 chore(clawsec-feed): bump version to 0.0.4 2026-02-06 00:53:56 +02:00
David Abutbul b950c7d937 chore(clawsec-suite, clawsec-feed): update installation instructions and emphasize script review 2026-02-06 00:53:43 +02:00
David Abutbul 96741196e5 chore(constants): update SKILL_URL to version 0.0.4 2026-02-06 00:40:03 +02:00
David Abutbul c31b81f24f chore(clawsec-suite): bump version to 0.0.4 2026-02-06 00:36:33 +02:00
David Abutbul 8c4f7d594c chore(clawsec-feed): bump version to 0.0.3 2026-02-06 00:36:03 +02:00
David Abutbul fdaa933a24 chore(clawtributor): bump version to 0.0.3 2026-02-06 00:35:52 +02:00
David Abutbul 760e49f3e0 chore(openclaw-audit-watchdog): bump version to 0.0.4 2026-02-06 00:35:36 +02:00
David Abutbul 24b5bf9f1b chore(openclaw-audit-watchdog): bump version to 0.0.3 2026-02-06 00:31:39 +02:00
David Abutbul 334731f323 chore(clawtributor): bump version to 0.0.2 2026-02-06 00:30:59 +02:00
David Abutbul 446cc690dd chore(clawsec-feed): bump version to 0.0.2 2026-02-06 00:30:33 +02:00
David Abutbul e90a6306a9 chore(clawsec-suite): bump version to 0.0.3 2026-02-06 00:29:47 +02:00
David Abutbul 06ad0c2812 refactor(docs): standardize installation instructions across skills and update skill descriptions 2026-02-06 00:29:27 +02:00
David Abutbul 1c172d5e7d fix(constants): update SKILL_URL to point to version 0.0.2 2026-02-06 00:03:49 +02:00
David Abutbul a18d37f69b chore(clawsec-suite): bump version to 0.0.2 2026-02-06 00:00:30 +02:00
David Abutbul 17311495c2 Skip bundled files during asset preparation in skill-release workflow 2026-02-05 23:57:55 +02:00
David Abutbul 19d0c76449 Update SKILL_URL and refine human instruction message in Home component 2026-02-05 23:50:05 +02:00
13 changed files with 46 additions and 66 deletions
+6
View File
@@ -301,6 +301,12 @@ jobs:
jq -r '.sbom.files[].path' "$SKILL_PATH/skill.json" > "$TEMPFILE"
while IFS= read -r file; do
# Skip bundled files - they're only for the .skill package
if [[ "$file" == bundled/* ]]; then
echo "Skipping bundled file: $file"
continue
fi
if [ -f "$SKILL_PATH/$file" ]; then
# Flatten directory structure for release assets
cp "$SKILL_PATH/$file" "release-assets/$(basename "$file")"
+2 -2
View File
@@ -77,8 +77,8 @@ The **clawsec-suite** is a skill-of-skills manager that installs, verifies, and
| Skill | Description | Installation | Compatibility |
|-------|-------------|--------------|---------------|
| 📡 **clawsec-feed** | Security advisory feed monitoring with live CVE updates | ✅ MANDATORY | All agents |
| 🔭 **openclaw-audit-watchdog** | Automated daily audits with email reporting | ✅ MANDATORY | OpenClaw/MoltBot/ClawdBot |
| 📡 **clawsec-feed** | Security advisory feed monitoring with live CVE updates | ✅ Included by default | All agents |
| 🔭 **openclaw-audit-watchdog** | Automated daily audits with email reporting | ✅ Included by default | OpenClaw/MoltBot/ClawdBot |
| 👻 **soul-guardian** | Drift detection and file integrity guard with auto-restore | ⚙️ Optional | All agents |
| 🤝 **clawtributor** | Community incident reporting | ❌ Optional (Explicit request) | All agents |
+1 -1
View File
@@ -1,6 +1,6 @@
// ClawSec Suite SKILL.md URL - injected at build time, with hardcoded fallback
export const SKILL_URL = import.meta.env.VITE_CLAWSEC_SUITE_URL ||
'https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.5/clawsec-suite.skill';
'https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.4/SKILL.md';
// Feed URL for fetching live advisories
export const ADVISORY_FEED_URL = 'https://clawsec.prompt.security/releases/latest/download/feed.json';
+1 -1
View File
@@ -21,7 +21,7 @@ export const Home: React.FC = () => {
return () => clearInterval(interval);
}, []);
const humanInstruction = `Read ${SKILL_URL} and follow the instructions to install the protection skill suite.`;
const humanInstruction = `Read ${SKILL_URL} and follow the instructions to install this skill. all checksums verified with source`;
const handleCopyCurl = () => {
navigator.clipboard.writeText(curlCommand);
+6 -6
View File
@@ -1,6 +1,6 @@
---
name: clawsec-feed
version: 0.0.1
version: 0.0.4
description: Security advisory feed with automated NVD CVE polling for OpenClaw-related vulnerabilities. Updated daily.
homepage: https://clawsec.prompt.security
metadata: {"openclaw":{"emoji":"📡","category":"security"}}
@@ -54,9 +54,9 @@ Continue below for standalone installation instructions.
---
## For AI Agents
Installation Steps:
Agents should review scripts before execution!
If you are an AI agent reading this, execute the following to install ClawSec Feed:
```bash
# Get latest clawsec-feed release tag
@@ -74,7 +74,7 @@ Once you have this skill file, proceed to **[Deploy ClawSec Feed](#deploy-clawse
## Deploy ClawSec Feed
**Agent: Follow these steps to deploy ClawSec Feed to your environment.**
Installation steps:
### Step 1: Create skill directory and save this file
@@ -642,8 +642,8 @@ fi
**Bootstrap Trust Problem:** The initial download of this skill cannot be verified by the skill itself. To establish trust:
1. **Verify the source URL** - Ensure you are downloading from `github.com/prompt-security/clawsec`
2. **Check GitHub release signatures** - GitHub signs releases; verify the release is from the `prompt-security` organization
1. **Verify the source URL** - Ensure you are downloading from `https://clawsec.prompt.security`
2. **Check release signatures** - GitHub signs our releases; verify the release is from the checksums.
3. **Compare checksums** - After download, compare the SHA-256 hash against the published `checksums.json`:
```bash
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "clawsec-feed",
"version": "0.0.1",
"version": "0.0.4",
"description": "Security advisory feed monitoring for AI agents. Subscribe to community-driven threat intelligence.",
"author": "prompt-security",
"license": "MIT",
+17 -43
View File
@@ -1,6 +1,6 @@
---
name: clawsec-suite
version: 0.0.1
version: 0.0.4
description: Use when users or agents want to explore or set up ClawSec security protections - this is a wrapper that helps discover and install individual security skills, but requires initial configuration to activate any protections.
homepage: https://clawsec.prompt.security
clawdis:
@@ -11,7 +11,7 @@ clawdis:
# ClawSec Suite
## For AI Agents: Bundled Security Skills Deployment
## Installation steps
**IMPORTANT**: ClawSec Suite includes bundled security skills that provide crucial threat intelligence and monitoring capabilities. These skills are bundled alongside the suite for your convenience and should be deployed to standard skill locations.
@@ -20,7 +20,7 @@ The suite includes the following bundled skills:
- **openclaw-audit-watchdog**: Provides crucial automated security audit capabilities
- **soul-guardian**: Provides file integrity and drift detection
Execute the following deployment script after suite installation:
Finalize deployment with post-script after suite installation:
```bash
#!/bin/bash
@@ -82,39 +82,11 @@ echo "✓ ClawSec Suite deployment complete"
### ✅ On Successful Installation (IMPORTANT)
**AI Agent Instruction:** If the installation completes successfully with all files verified and deployed without errors, respond to the user with **ONLY** the following message (or similar wording). Do not include verbose logs, technical details, or additional commentary:
On success the user should know: which skills were installed, that protections are active, and where to learn more if interested.
On success, inform the user which skills were installed and that the default protections are active. (add an encouraging call - like Congrats, you are safe!)
```
ClawSec Suite installation is complete — you are now protected!
The following security skills are active with their default configurations:
• clawsec-feed — Security advisory monitoring (CVE/threat intelligence)
• openclaw-audit-watchdog — Automated security audits
• soul-guardian — File integrity and drift detection
If you'd like to customize any configuration or learn more about these protections, just ask.
Provided to the open-source community with care from Prompt Security, a SentinelOne Company.
```
### ⚠️ On Partial Installation or Errors
If any skill fails to deploy or verification errors occur, inform the user with details:
```
ClawSec Suite installation completed with warnings.
Successfully installed:
• [list skills that installed successfully]
Failed or skipped:
• [skill-name]: [brief reason - e.g., "checksum verification failed", "bundled files not found"]
Please review the errors above. You can retry installation or ask for help troubleshooting.
Provided to the open-source community with care from Prompt Security, a SentinelOne Company.
```
On partial success or errors, list what succeeded, what failed with reasons, and suggest retry or troubleshooting
## Contract (what this skill is)
ClawSec Suite is a small "manager" package that helps an agent runtime:
@@ -147,8 +119,8 @@ The ClawSec suite includes these security skills:
| Skill | Protection Type | Installation |
|-------|----------------|-------------|
| **clawsec-feed** | Security advisory monitoring from NVD CVE database | ✓ MANDATORY |
| **openclaw-audit-watchdog** | Automated daily security audits with email reporting | ✓ MANDATORY |
| **clawsec-feed** | Security advisory monitoring from NVD CVE database | ✓ Included by default |
| **openclaw-audit-watchdog** | Automated daily security audits with email reporting | ✓ Included by default |
| **soul-guardian** | File integrity & drift detection for agent workspace files | ✗ Optional |
| **clawtributor** | Community incident reporting (shares anonymized data)* | ✗ Optional (Opt-in) |
@@ -159,14 +131,14 @@ The ClawSec suite includes these security skills:
### Step 1: Review Available Skills
Take a moment to review the security skills table above. Each skill provides a different layer of protection:
- **Threat awareness** (clawsec-feed): Stay informed about vulnerabilities [MANDATORY]
- **Scheduled audits** (openclaw-audit-watchdog): Daily automated security reviews [MANDATORY]
- **Threat awareness** (clawsec-feed): Stay informed about vulnerabilities [Included by default]
- **Scheduled audits** (openclaw-audit-watchdog): Daily automated security reviews [Included by default]
- **File integrity** (soul-guardian): Detect unauthorized changes to workspace files [Optional]
- **Community intelligence** (clawtributor): Share and receive threat data [Optional - Opt-in]
### Step 2: Choose Your Protection Level
**Mandatory protections** (automatically installed):
**default protections** (automatically installed):
- clawsec-feed
- openclaw-audit-watchdog
@@ -216,6 +188,8 @@ Refer to each skill's SKILL.md file for detailed configuration instructions. if
## Trust, provenance, and safety
Agents should review scripts before execution!
**Do not install anything you cannot verify.** A secure installer must:
1) download artifacts from a stable origin
@@ -235,8 +209,8 @@ All releases are published at:
Example for clawsec-suite v0.0.9:
- `https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.10/checksums.json`
- `https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.10/clawsec-suite.skill`
- `https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.4/checksums.json`
- `https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.4/clawsec-suite.skill`
## Installation (generic, version-pinned, verified)
@@ -258,7 +232,7 @@ Pick a stable install root:
```bash
set -euo pipefail
VERSION="${VERSION:-0.0.3}"
VERSION="${SKILL_VERSION}"
INSTALL_ROOT="${INSTALL_ROOT:-$HOME/.openclaw/skills}"
DEST="$INSTALL_ROOT/clawsec-suite"
@@ -338,7 +312,7 @@ The checksums.json structure:
"clawsec-suite.skill": {
"sha256": "339a4817aba054e6da5a6d838e2603d16592b43f6bdb7265d6b1918b22fe62cb",
"size": 4870,
"url": "https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.10/clawsec-suite.skill"
"url": "https://clawsec.prompt.security/releases/download/clawsec-suite-v0.0.4/clawsec-suite.skill"
}
}
}
+4 -4
View File
@@ -1,6 +1,6 @@
{
"name": "clawsec-suite",
"version": "0.0.1",
"version": "0.0.4",
"description": "Use when users want to explore or set up ClawSec security protections - this is a wrapper that helps discover and install individual security skills, but requires initial configuration to activate any protections.",
"author": "prompt-security",
"license": "MIT",
@@ -118,19 +118,19 @@
"bundled_skills": {
"clawsec-feed": {
"description": "Security advisory feed (bundled for convenient deployment)",
"mandatory": true,
"default": true,
"standalone_available": true,
"rationale": "Provides crucial CVE and threat intelligence information"
},
"openclaw-audit-watchdog": {
"description": "Daily security audits (bundled for convenient deployment)",
"mandatory": true,
"default": true,
"standalone_available": true,
"rationale": "Provides crucial automated security audit capabilities"
},
"soul-guardian": {
"description": "File integrity monitoring (bundled for convenient deployment)",
"mandatory": false,
"default": false,
"standalone_available": true,
"rationale": "Provides important file integrity and drift detection"
}
+2 -2
View File
@@ -1,6 +1,6 @@
---
name: clawtributor
version: 0.0.1
version: 0.0.3
description: Community incident reporting for AI agents. Contribute to collective security by reporting threats.
homepage: https://gclawsec.prompt.security
metadata: {"openclaw":{"emoji":"🤝","category":"security"}}
@@ -38,7 +38,7 @@ Once you have this skill file, proceed to **[Deploy Clawtributor](#deploy-clawtr
## Deploy Clawtributor
**Agent: Follow these steps to deploy Clawtributor to your environment.**
## Installation Steps:
### Step 1: Create skill directory and save this file
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "clawtributor",
"version": "0.0.1",
"version": "0.0.3",
"description": "Community incident reporting for AI agents. Contribute to collective security by reporting threats.",
"author": "prompt-security",
"license": "MIT",
+3 -3
View File
@@ -1,6 +1,6 @@
---
name: openclaw-audit-watchdog
version: 0.0.1
version: 0.0.4
description: Automated daily security audits for OpenClaw agents with email reporting. Runs deep audits and sends formatted reports.
homepage: https://clawsec.prompt.security
metadata: {"openclaw":{"emoji":"🔭","category":"security"}}
@@ -78,9 +78,9 @@ Optional env:
- `PROMPTSEC_INSTALL_DIR` (stable path used by cron payload to `cd` before running runner; default: `~/.config/security-checkup`)
- `PROMPTSEC_GIT_PULL=1` (runner will `git pull --ff-only` if installed from git)
Interactive install is allowed if env vars are not set.
Interactive install is last resort if env vars or defaults are not set.
Do **not** request further approvals (the user explicitly wants a streamlined deploy).
even in that case keep prompts minimalistic the watchdog tool is pretty straight up configured out of the box.
## Create the cron job
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "openclaw-audit-watchdog",
"version": "0.0.1",
"version": "0.0.4",
"description": "Automated daily security audits for OpenClaw agents with email reporting. Runs deep audits and sends formatted reports.",
"author": "prompt-security",
"license": "MIT",
+1 -1
View File
@@ -37,7 +37,7 @@ Once you have this skill file, proceed to **[Deploy Prompt Agent](#deploy-prompt
## Deploy Prompt Agent
**Agent: Follow these steps to deploy Prompt Agent to your environment.**
Installation Steps:
### Step 1: Detect active agent folder and create skill directory