blackbox.yaml 3.1 KB

1234567891011121314151617181920212223242526
  1. name: blackbox
  2. repo: https://github.com/umanitek/agent-blackbox
  3. sha: 7d697683e0d56608cfe3fee374d6a6866702058a
  4. subdir: plugins/blackbox
  5. title: Agent Blackbox
  6. description: "Security for agents: checks every tool call and model request before it runs against a curated, verifiable threat graph (prompt injection, dangerous commands, malicious packages, unsafe skills, phishing and drainer indicators) and local rules that keep an agent away from wallet stores, seed phrases, private keys and exchange API keys. Audit mode records; block mode refuses. Can share privacy-safe threat reports with an open community graph once the user turns sharing on (off by default); community findings only ever flag. Hooks only: no tools, no middleware. Disclosure — hooks see every tool call and model request; `hermes blackbox setup` installs Node (via a checksum-pinned nvm installer) if missing, the OriginTrail DKG node from npm (checksum-pinned) and Blazegraph in Docker or Oxigraph, registers the DKG node and the dashboard as login services (systemd/LaunchAgent), and joins the DKG peer-to-peer network; package installs are looked up on api.osv.dev (name and version); community threat reports signed by a local reporter key (threat identifiers, including domains of fetched pages that served a verified injection) are shared to the community graph only after you turn sharing on (off by default); the optional LLM reviewer sends the current turn's user and tool text to OpenAI or Anthropic; `blackbox attach` copies the plugin into the Hermes homes/profiles and OpenClaw workspaces you name and enables it in their config (automatic attaching is off unless you set `auto_attach: true`); `hermes blackbox chat` creates an `agent-blackbox` profile cloned from the current one (config.yaml and .env); the dashboard runs on 127.0.0.1:9700."
  7. maintainer: Umanitek
  8. tier: community
  9. category: tools
  10. version: "1.0.0"
  11. requires_hermes: ">=0.21.7"
  12. docs_url: https://github.com/umanitek/agent-blackbox/tree/7d697683e0d56608cfe3fee374d6a6866702058a/plugins/blackbox
  13. image: https://raw.githubusercontent.com/umanitek/agent-blackbox/7d697683e0d56608cfe3fee374d6a6866702058a/docs/catalog/banner.png
  14. screenshots:
  15. - https://raw.githubusercontent.com/umanitek/agent-blackbox/7d697683e0d56608cfe3fee374d6a6866702058a/docs/catalog/dashboard.png
  16. - https://raw.githubusercontent.com/umanitek/agent-blackbox/7d697683e0d56608cfe3fee374d6a6866702058a/docs/catalog/trader-shield.png
  17. - https://raw.githubusercontent.com/umanitek/agent-blackbox/7d697683e0d56608cfe3fee374d6a6866702058a/docs/catalog/threat-tiers.png
  18. readme: true
  19. platforms: []
  20. known_issues:
  21. - "After installing, run `hermes blackbox setup` once: it installs Blackbox's local DKG node (a pinned, checksum-verified OriginTrail release from npm) and its graph store (Blazegraph in Docker, or Oxigraph when Docker is not available), then syncs the verified threat graph. Until setup has run, the built-in rules protect and `hermes blackbox status` says setup is needed."
  22. capabilities:
  23. provides_tools: []
  24. provides_hooks: [pre_tool_call, post_tool_call, pre_api_request, on_session_start, on_session_end]
  25. provides_middleware: []
  26. requires_env: []