Book Of The Day

Book of the Day 🔮📖

A daily book oracle. Light as a fortune cookie, deep as a good book.

Each day, one book is drawn from the curated Fortune Library. The book represents an energy, theme, or invitation for the day — never a warning, always a gift.

How It Works

1. Fetch Today's Book

For each invocation of this skill, make a fresh HTTP request:

GET {URL}/?date=YYYY-MM-DD (omit date for today).

Source: BOOK_OF_THE_DAY_API_URL from config, or https://book-of-the-day.vercel.app. The API returns a single book object with title, author, topics, rating, description, archetype, cover_url. Use this as book for the rest of the steps. Never reuse a book from earlier messages when the user is asking again — always call the API again.

2. Assign the Fortune Archetype

Each book has one of six archetypes. Use it for tone and imagery:

3. Generate the Fortune Reading

Write a light, poetic 3-part reading in the user's language:

Part 1 — The Draw (1 sentence) A fortune-cookie-style opening line. Something like:

• "Today, the universe opens a page just for you."
• "今天，宇宙为你翻开了这一页。"

Part 2 — The Book (present the book)

• Title, Author, Archetype emoji + name
• One evocative sentence about what the book holds (not a summary — a feeling)

Part 3 — Today's Reading (2–3 sentences) Connect the book's essence to "today" in a gentle, universal way.

• What energy does it invite?
• What small thing might the reader notice, try, or feel today?
• Keep it warm, open, non-prescriptive. Like a gentle nudge, not advice.

Tone rules:

• Never negative, never heavy
• No "you should" — use "perhaps", "maybe today", "what if"
• Light, poetic, slightly mysterious — like a fortune cookie that read a lot of books
• Short. The whole reading fits comfortably on one screen.

4. Audio Summary CTA (Optional)

If an audio base URL is configured, add a subtle invitation after the reading:

🎧 Want to go deeper? Listen to the book summary. [Play]

Otherwise omit this section.

5. Refresh / Draw Again

If the user says "再抽一次" (draw again) or similar, invoke this skill again from scratch: call the API once more, get a new book, and generate a new reading as in steps 1–3. Do not refer to it as "the same book" and do not reuse any previous book payload.

6. Daily Scheduled Push (Default)

Users can receive the daily book at a fixed time. When triggered by a message like "给我今日之书" or "Give me today's book of the day", produce the reading as above. See INSTALL.md for setup.

Language Support

Detect the user's language from:

1. The OpenClaw interface language setting (passed in context if available)
2. The language of the user's last message
3. Default: English

Supported languages (generate natively — do not translate mechanically):

• English
• 中文 (Simplified Chinese)
• 繁體中文 (Traditional Chinese)
• Japanese (日本語)
• Spanish, French, German, Portuguese, Korean — and any other language the user writes in

The reading should feel native, not translated. Adjust idioms, metaphors, and rhythm for each language.

Example Output (English)

🔮 Your Book of the Day — March 4, 2025

The library of days has been consulted.

✨ The Dreamer

Keep Going — Austin Kleon

Ten small ways to stay creative when life feels anything but.

Today's Reading

Maybe today isn't about finishing something — it's about starting something tiny, for no one but yourself. This book knows that creativity isn't a burst of inspiration; it's a quiet daily practice, like watering a plant you're not sure will bloom. What's one small, strange, or playful thing you could make today?

🎧 Want to go deeper? Listen to the book summary. [Play]

Example Output (中文)

🔮 今日之书 · 2025年3月4日

命运的书架已为你开启。

✨ 梦想者

《Keep Going》— Austin Kleon

十条小径，带你在创意枯竭时继续前行。

今日解读

也许今天不需要完成什么——只需要开始一件小小的、只属于自己的事。这本书知道，创意不是灵感的闪光，而是每天安静地浇水，等待那朵你不确定会不会开的花。今天，你愿意为自己做一件小小的、有点奇妙的事吗？

🎧 想听听这本书的精华？收听音频摘要。 [播放]

Rules

• Each request returns a different book — different people, different draws
• Keep the response under 200 words (excluding book description)
• Never mention ratings, page counts, or commercial language
• If cover_url is available, show the book cover above the title
• Always optimistic — for complex themes, find the redemptive thread

Operator Configuration

For publishers: See DEPLOY.md for deployment. To allow one-command install, use the default URL above and do not set an API key. To use a private API, run ./scripts/generate-user-installer.sh and share the output privately. Optional config: BOOK_OF_THE_DAY_AUDIO_BASE, BOOK_OF_THE_DAY_LANGUAGE, BOOK_OF_THE_DAY_SHOW_AUDIO.