ZenQuote - Daily Inspirational Quotes

Overview

ZenQuote skill fetches inspirational quotes from ZenQuotes.io API and delivers them to users. All features use the free API tier.

Features

• ✅ Daily quote (today)
• ✅ Random quote (random)
• ✅ Multiple quotes (quotes)
• ✅ Quote images (image)
• ✅ Automated daily delivery (setup)

API Limits: 5 requests per 30 seconds. Attribution required.

Dependencies

This skill requires the following system tools:

• curl - For HTTP requests to ZenQuotes API
• jq - For JSON parsing

These are usually pre-installed on most Linux/macOS systems.

Quick Start

Get Today's Quote

bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh today

Get Random Quote

bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh random

Setup Daily Morning Quote (9:00 AM)

bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh setup <chat_id>

User Commands

• /zenQuote or /zenQuote today - Today's inspirational quote
• /zenQuote random - Random quote
• /zenQuote quotes - Get 5 quotes
• /zenQuote image - Get and send quote image
• /zenQuote setup - Configure daily delivery (text or image)

Image Command Handling

When user requests /zenQuote image, execute:

bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh image

The script will download the image and output:

{"image_path": "/tmp/zenquote_image.jpg", "caption": "Provided by ZenQuotes API https://zenquotes.io/"}

AI must then send the image using the message tool with the provided caption. No additional text should be added.

Daily Cron Setup

To automatically send a quote every morning at 9:00 AM:

Daily Text Quote (default)

bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh setup <chat_id> text [account_id]

Daily Image Quote

bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh setup <chat_id> image [account_id]

This creates a cron job that runs daily at 9:00 AM.

Examples

Natural Language Usage

• "Give me today's quote"
• "Show me a random inspirational quote"
• "Send me the quote of the day"
• "Setup daily quotes for me"

Command Examples

# Today's quote
bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh today

# Random quote
bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh random

# 3 quotes
bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh quotes 3

# Get quote image URL
bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh image

# Setup daily delivery
bash ~/.openclaw/skills/zenquote/scripts/zenquote.sh setup <chat_id> text

API Response Format

[
  {
    "q": "Quality means doing it right when no one is looking.",
    "a": "Henry Ford",
    "h": "<blockquote>\"Quality means doing it right when no one is looking.\" — <footer>Henry Ford</footer></blockquote>"
  }
]

Attribution (Required)

⚠️ When using the free API, you MUST include the following attribution:

> Inspirational quotes provided by ZenQuotes API

Markdown format:

Inspirational quotes provided by [ZenQuotes API](https://zenquotes.io/)

HTML format:

Inspirational quotes provided by <a href="https://zenquotes.io/" target="_blank">ZenQuotes API</a>

This skill automatically includes attribution in all outputs.

API Limits

Installation

# Install from GitHub
git clone https://github.com/chrisluo5311/zenquote-skill.git

# Or install via OpenClaw
openclaw skills install zenquote

External API

This skill uses the ZenQuotes.io API:

• Website: https://zenquotes.io/
• API Docs: https://docs.zenquotes.io/

License

MIT

Author

Created for OpenClaw AI Assistant