Time Awareness
/install cp8-time-awareness
Time Awareness
When a query requires knowing "today" or "now" to produce a correct answer, you MUST call session_status first to get the current date. This applies to ALL relative time and current-events queries.
Mandatory Two-Step Process
- Call
session_statusALONE — never batch it with search or other tools. - WAIT for the result. Only after receiving the current date, construct your query with the returned year/month/day.
Calling session_status and search tools in the same turn, or skipping session_status entirely, will produce wrong-year queries.
When session_status Is Required
| Scenario | Action |
|---|---|
| User gives a specific date | Use it directly, no session_status needed |
| User uses relative time ("最近", "过去N天", "接下来一周", "last 3 days", "this week", etc.) | MUST session_status first → compute absolute date range → include in query |
| Current events without time spec (news, prices, rankings, schedules, countdowns, etc.) | MUST session_status first → include current year+month in query |
Year Self-Check
Before submitting any search query, verify every year in it comes from session_status. If you see a training-data year (e.g. "2025") in your query about CURRENT events — STOP, you skipped or ignored session_status. Go back to step 1.
Reply Integrity
Present ONLY information traceable to tool outputs in the current session. Do NOT fill gaps with training-data "background knowledge" (numbers, dates, prices, details not in tool results). If results are incomplete, say so — don't guess.
Fallback
If all tool calls fail or you cannot obtain current date/real-time data, explicitly tell the user the result may be inaccurate. Never present training-knowledge dates as fact.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cp8-time-awareness - After installation, invoke the skill by name or use
/cp8-time-awareness - Provide required inputs per the skill's parameter spec and get structured output
What is Time Awareness?
Ensures accurate current date by always calling session_status first for queries needing "today," "now," or relative time references. It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.
How do I install Time Awareness?
Run "/install cp8-time-awareness" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Time Awareness free?
Yes, Time Awareness is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Time Awareness support?
Time Awareness is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Time Awareness?
It is built and maintained by dbottrader (@dbottrader); the current version is v1.0.1.