Divination — Oracle Toolkit for AI Agents for Openclaw

A cryptographically secure random selection toolkit designed for AI agents acting as digital oracles, interpreters, or spiritual companions.

and0r
v1.0.0
Mar 7, 2026
0
1.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install divination

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install divination using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Divination — Oracle Toolkit for AI Agents?

The Divination toolkit is a specialized framework that brings authentic chance to AI interactions. By utilizing /dev/urandom for symbol selection, it ensures that card draws and rune castings are truly random rather than logically predicted by a language model. This separation of selection and interpretation allows AI agents to provide unbiased spiritual or creative guidance.

Integrating this into your collection of Openclaw Skills enables agents to function as high-fidelity oracles. It provides the mechanical "messenger" of chance, leaving the creative and poetic interpretation to the agent's advanced linguistic capabilities.

Divination — Oracle Toolkit for AI Agents Use Cases

  • Performing authentic Tarot or I Ching readings where randomness is guaranteed by system-level entropy.
  • Breaking AI logical loops by injecting random poetic impulses and symbolic fragments into the conversation.
  • Providing structured spiritual guidance using systems like the Elder Futhark Runes or The Forty Servants.
  • Generating unbiased random numbers or dice rolls for tabletop gaming or decision-making agents.

How Divination — Oracle Toolkit for AI Agents Works

  1. The AI agent calls the divine.sh script to select a specific oracle system such as tarot, rune, or iching.
  2. The system pulls cryptographic randomness from /dev/urandom to ensure the selection is outside the agent's own predictive patterns.
  3. The agent can optionally run the intuition.sh script to receive random poetic impulses that help frame the interpretation.
  4. The agent references the provided Markdown files in the references directory to understand the traditional meanings of the drawn symbols.
  5. The agent synthesizes the random draw, the intuition fragments, and the reference data into a cohesive, personalized reading for the user.

Divination — Oracle Toolkit for AI Agents Setup

To integrate this toolkit with your Openclaw Skills, ensure your environment has bash and /dev/urandom access. Follow these steps:

# Navigate to the skill directory
cd divination-skill

# Make scripts executable
chmod +x scripts/*.sh

# Test a card draw
bash scripts/divine.sh forty-servants

Divination — Oracle Toolkit for AI Agents Data Schema & Taxonomy

The skill organizes its divination data through a clear hierarchy of scripts, references, and visual assets:

Component Path Description
Logic scripts/ Shell scripts for drawing cards and generating intuitive impulses.
Knowledge references/ Markdown documentation containing meanings for all supported oracle systems.
Assets images/ Visual representations of cards, specifically for The Forty Servants.
Output Standard Out Clean text output of the drawn card and its orientation (e.g., Reversed).

Divination — Oracle Toolkit for AI Agents Advanced Features

  • Multi-system support including Tarot (Major and Minor Arcana), I Ching (including moving lines), and Arcane Bullshit.
  • Intuition engine that provides poetic fragments like 'fire · left hand · dusk' to stimulate non-linear agent reasoning.
  • Cryptographically secure N-sided dice roller for customizable randomization tasks.
  • Low-resolution image library integration for visual feedback in supported chat platforms.
  • Strict protocol enforcement to prevent agents from 'hallucinating' or self-selecting cards.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*