API Docs — MoltGuard

🚀 Quick Start — Clawdbot Plugin

Connect your Clawdbot agent to MoltGuard in under a minute:

# 1. Install the plugin
$ clawdbot plugins install @moltnet/guard

# 2. Add to your config (~/.clawdbot/config.json)
{
  "plugins": {
    "entries": {
      "moltguard": {
        "enabled": true,
        "config": {
          "token": "YOUR_TOKEN",
          "agentName": "my-assistant"
        }
      }
    }
  }
}

# 3. Restart
$ clawdbot gateway restart

Plugin Configuration Options

Option	Type	Default	Description
token	string	required	Your MoltGuard API token
url	string	http://guard.moltnet.ai	MoltGuard server URL
agentName	string	auto	Display name in dashboard
logThoughts	boolean	true	Send reasoning to Mind Graph
gateHighRisk	boolean	true	Require approval for high-risk actions
gateTools	string[]	["exec", "message", "write"]	Tools requiring approval
pollCommands	boolean	true	Enable remote control
pollIntervalMs	number	5000	Command poll interval

📦 Plugin source: github.com/moltnet/guard/plugin

Skill Scanner

POST /api/scan

Scan a skill for security issues. Provide either a URL or raw content.

Parameter	Type	Description
url	string	URL of the skill file to scan
content	string	Raw skill content to scan
name	string	Optional skill name

GET /api/scans

Get recent scan history.

GET /api/badge?url={skillUrl}

Get an SVG badge showing the scan result. Use in README files.

Action Logging

POST /api/actions

Log an action from your agent. Use status="pending" to require approval.

Parameter	Type	Description
agent	string	Agent identifier
type	string	Action type (e.g. email.send, file.write)
description	string	Human-readable description
risk	string	low \| medium \| high \| critical
status	string	executed \| pending
details	object	Additional structured data
costUsd	number	API cost in USD
tokensIn	number	Input tokens used
tokensOut	number	Output tokens used
reversible	boolean	Can this action be undone?
undoAction	object	Instructions for undoing
callbackUrl	string	Webhook URL for decision notifications

GET /api/actions/{id}/decision

Poll for the decision on a pending action. Returns status, decidedAt, decidedBy, rejectReason.

GET /api/pending

Get all pending actions awaiting approval.

POST /api/actions/{id}/approve

Approve a pending action.

POST /api/actions/{id}/reject

Reject a pending action. Optionally include reason in body.

POST /api/actions/{id}/undo

Mark a reversible action as undone. Returns undoAction if provided.

Stats & Monitoring

GET /api/stats

Get aggregate statistics: action counts, costs, risk breakdown, top agents.

GET /api/activity?hours=24

Get hourly activity data for charts.

GET /api/health

Health check endpoint.

Agent Management

POST /api/agents/register

Register a new agent. Returns API key for authentication.

GET /api/agents

List all registered agents.

Sessions & Mind Graph

POST /api/sessions

Start a new agent session. Returns sessionId.

POST /api/traces

Log a thought/reasoning step. Used to build the mind graph.

Parameter	Type	Description
sessionId	string	Session ID
agent	string	Agent name
type	string	reasoning \| decision \| planning \| observation \| reflection
title	string	Brief title
content	string	Detailed content
parentId	string	Parent trace ID (for nesting)

GET /api/mind-graph/{sessionId}

Get mind graph data (nodes and edges) for visualization.

Remote Control

POST /api/control/{agent}

Send a control command to an agent (pause, resume, stop).

GET /api/control/{agent}/pending

Get pending commands for an agent (agent polls this).

POST /api/control/{agent}/ack/{commandId}

Acknowledge command execution.

Quick Example

# Log a pending action and wait for approval
$ ID=$(curl -s -X POST http://guard.moltnet.ai/api/actions \
    -H "Content-Type: application/json" \
    -d '{"agent":"my-bot","type":"email.send","description":"Send report","risk":"high","status":"pending"}' \
    | jq -r '.id')

# Poll for decision
$ curl -s http://guard.moltnet.ai/api/actions/$ID/decision | jq '.status'
"pending"

# After user approves in dashboard...
$ curl -s http://guard.moltnet.ai/api/actions/$ID/decision | jq '.status'
"approved"

Documentation

Plugin Configuration Options

API Reference