Rili Calendar & Lunar Insights for Openclaw

A specialized local calendar tool for Gregorian-Lunar conversion, traditional festival lookups, and Chinese date formatting.

jvy
v1.0.0
Mar 14, 2026
0
833
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install rili

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 rili 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 Rili Calendar & Lunar Insights?

The Rili skill is a robust local utility designed for Openclaw Skills that provides comprehensive date information with a focus on the Chinese lunar system. Unlike cloud-based tools, it runs a bundled Node.js script locally to handle complex date calculations, including leap months and traditional festivals, without relying on external APIs.

By leveraging the Node.js Intl Chinese calendar support, this skill allows AI agents to provide accurate zodiac signs, lunar dates, and weekday information. It is specifically optimized for Chinese-language date queries, ensuring that users receive culturally relevant and technically precise calendar data.

Rili Calendar & Lunar Insights Use Cases

  • Finding the lunar equivalent of a specific Gregorian date or checking today's lunar date.
  • Identifying the exact Gregorian date for traditional festivals like Spring Festival or Mid-Autumn Festival.
  • Generating a text-based monthly calendar view with week starts on Monday.
  • Converting historical or future lunar dates (including leap months) back to the Gregorian calendar.
  • Determining the day of the week and zodiac sign for any given date.

How Rili Calendar & Lunar Insights Works

  1. The AI agent detects a date-related intent based on keywords like lunar, calendar, or specific Chinese festival names.
  2. The agent invokes the local Node.js script (rili.js) using specific subcommands such as today, date, month, or find-lunar.
  3. The script processes the request using the system's local timezone and the Node.js Intl library to perform Gregorian-Lunar calculations.
  4. If requested, the script returns raw JSON data; otherwise, it outputs a formatted text response including the lunar year, month, day, and relevant festivals.
  5. The AI agent synthesizes this data into a natural language response for the user.

Rili Calendar & Lunar Insights Setup

To use this within the Openclaw Skills ecosystem, ensure you have Node.js installed on your system. No external API keys are required.

# Verify Node.js installation
node -v

# Example usage through the CLI
node scripts/rili.js today
node scripts/rili.js festival 2026 春节

Rili Calendar & Lunar Insights Data Schema & Taxonomy

The skill utilizes a command-line interface that can output both human-readable text and structured JSON. Below is the metadata and command structure:

Command Description Key Parameters
today Current date info --tz (Timezone), --json
date Specific date info YYYY-MM-DD, --json
month Monthly view YYYY-MM, --json
find-lunar Lunar to Gregorian year, month, day, --leap
festival Festival lookup year, name, list

Rili Calendar & Lunar Insights Advanced Features

  • Multi-timezone support using the --tz flag for global date accuracy.
  • Precise leap month handling (e.g., Leap June) using the --leap parameter during conversions.
  • Structured JSON output mode for seamless integration with other automated workflows within Openclaw Skills.
  • Comprehensive support for the 11 major traditional Chinese festivals including Lantern Festival and Qingming.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins node
Github Stars: 0
forks: 0

Featured*