A natural language-driven productivity skill for logging time, capturing reflections, and managing todo lists through simple conversation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shiji-timefriend
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shiji-timefriend 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 TimeFriend?
TimeFriend is a comprehensive productivity integration designed to bridge the gap between natural language thoughts and structured personal management. By leveraging this skill within the Openclaw Skills ecosystem, users can log work sessions, append thoughts to a daily diary, and organize tasks without ever leaving their chat interface. It acts as a digital companion that understands context, such as relative time and multi-level tagging, to ensure your personal data is organized precisely on the timefriend.xin platform.
The skill excels at capturing the flow of a user's day. Whether you are performing a deep-work session or simply want to jot down a fleeting idea into an inbox, TimeFriend handles the API complexity and data formatting behind the scenes. It specifically supports the Beijing Time (UTC+8) timezone by default, making it an ideal tool for users looking for a reliable, hands-free way to track their life's traces.
TimeFriend Use Cases
- Logging specific activity durations such as 8:00-9:30 reading with tags like #learning.
- Appending continuous reflections to a daily diary to maintain a consistent habit of mindfulness.
- Rapidly adding tasks to a categorized inbox for later processing.
- Checking today's productivity statistics and completed tasks via voice or text commands.
How TimeFriend Works
- The user provides a natural language command such as Help me record a meeting from 3pm to 5pm today #work.
- The skill parses the input to extract the activity content, start time, end time, and any associated tags using predefined rules.
- It communicates with the TimeFriend API using a secure Bearer token to create a record, todo, or diary entry.
- For diary entries, it intelligently fetches existing content for the day and appends new paragraphs in HTML format to prevent data loss.
- The system returns a formatted confirmation to the user, including details like word counts for reflections or status icons for tasks.
TimeFriend Setup
To get started, you must obtain a token from your settings page at timefriend.xin. Once you have the token, configure it in your Openclaw Skills environment variables:
TIMEFRIEND_TOKEN=tf_your_generated_token_here
TimeFriend Data Schema & Taxonomy
TimeFriend organizes data into four primary structures to ensure a clear metadata taxonomy:
| Data Type | Key Fields | Description |
|---|---|---|
| Records | content, startTime, endTime, tags | Used for time-tracking and duration logs. |
| Reviews | content (HTML), date | Daily reflection entries that support append mode. |
| Todos | title, status, taskDate | Task management with pending, in-progress, or completed states. |
| Inbox | title, categoryId, status | Unscheduled tasks or ideas stored in specific user categories. |
TimeFriend Advanced Features
- Natural language date parsing including relative terms like yesterday or this afternoon.
- Hierarchical tagging support using the #category/subcategory syntax for granular organization.
- Intelligent timezone management defaulting to UTC+8 for consistent logging.
- Automatic HTML paragraph wrapping for daily diary entries to maintain clean formatting.
- Multi-step category selection for inbox items when multiple categories exist.
SKILL.md
Loading
Related Openclaw Skills
Exa Web Search (Free)
A neural search skill for Openclaw Skills that enables AI agents to perform web, code, and company research without requiring an API key.
Smart Crawler
An enterprise-grade data collection engine designed to bypass anti-bot measures while providing structured data extraction.
iFly PDF & Image OCR
A powerful OCR skill that leverages iFlytek's advanced LLM-based recognition to extract text and structure from images and PDF documents.
MediaIO Seedream Image Generator
A professional-grade image generation skill leveraging ByteDance Seedream 4.0 for high-aesthetic 4K visuals with style and character consistency.
Amazon Leadership Principles for Product & Engineering
Integrate Amazon's legendary Leadership Principles into your AI-assisted coding and product development workflow.
Smart Scraper
An AI-driven web scraping tool designed to automatically recognize and extract structured data like lists and tables from any URL.
Featured*
