Otta CLI is a powerful command-line interface for automating otta.fi time-tracking, absence management, and reporting workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install otta-cli
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 otta-cli 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 Otta CLI?
Otta CLI provides a robust terminal-based interface to manage work hours, sick leaves, and holidays on the otta.fi platform. It is designed for developers and power users who prefer CLI-first operations and machine-readable outputs for automation. By leveraging Openclaw Skills, this tool enables AI agents to interact with time-tracking data programmatically, ensuring high accuracy and integration with existing developer workflows.
The tool handles everything from authentication and configuration management to complex calendar generation. It is particularly effective for users who need to maintain their work logs without leaving their development environment, providing a bridge between local terminal productivity and cloud-based time management systems.
Otta CLI Use Cases
- Tracking daily working hours and pauses directly from the terminal.
- Automating holiday and absence lookups for team planning.
- Generating detailed or overview calendar reports in JSON format for external analysis.
- Integrating time-tracking status into CI/CD pipelines or non-interactive environments.
- Managing sick leaves and generating standardized absence comments with specific details.
How Otta CLI Works
- The user authenticates using the auth login command, typically passing credentials via environment variables for security.
- A status check is performed to hydrate the local cache with user metadata, ensuring fallbacks for user and worktimegroup IDs are available.
- The skill executes specific commands such as worktimes add, update, or delete based on structured input (YYYY-MM-DD and HH:MM formats).
- Data is requested using the --format json flag to allow Openclaw Skills to parse response fields precisely instead of scraping text.
- The CLI interacts with the Otta API, managing tokens and refreshing sessions as needed to maintain synchronization.
Otta CLI Setup
To get started with this skill, follow these installation and configuration steps:
# Verify the command surface and storage paths
otta --help
otta config path
otta config cache-path
# Set up environment variables for non-interactive use
export OTTA_CLI_USERNAME="your_username"
export OTTA_CLI_PASSWORD="your_password"
# Authenticate and hydrate the cache
otta auth login --username "$OTTA_CLI_USERNAME" --password "$OTTA_CLI_PASSWORD" --format json
otta status --format json
Otta CLI Data Schema & Taxonomy
The skill organizes its data through a combination of environment variables, local configuration files, and cached metadata to optimize performance and reliability.
| Component | Details |
|---|---|
| Authentication | Support for Access Tokens, Refresh Tokens, and Client IDs via OTTA_CLI_* variables. |
| Cache | Stores user_id and worktimegroup_id to reduce API overhead. |
| Input Formats | Strict validation for dates (YYYY-MM-DD) and times (HH:MM). |
| Output Options | Supports json for machines and minutes, hours, days, or hhmm for durations. |
Otta CLI Advanced Features
- Machine-readable JSON output for all data-producing commands, ideal for multi-agent support.
- Flexible duration formatting allowing users to toggle between minutes, hours, and days (1 day = 24h).
- Headless automation support using --password-stdin to avoid leaking credentials in shell history.
- Detailed calendar reporting that combines worktimes, holidays, and absences into a single view.
- Automatic cache management via the status command to ensure metadata remains valid during long-running sessions.
SKILL.md
Loading
Related Openclaw Skills
Juicebox V5 Skills Collection
A comprehensive suite of Openclaw Skills for architecting, deploying, and managing complex treasury protocols, Revnets, and omnichain financial systems.
Bright Data Web Scraping & Search
A high-performance scraping and search skill that bypasses bot detection to deliver markdown content and structured Google results.
Edge Browser Controller
A high-performance web extraction tool that leverages Microsoft Edge and Playwright to capture content from complex, dynamic web pages.
Agent Father Skill
A comprehensive lifecycle management tool for creating, configuring, and onboarding AI agents and digital employees.
Wolt CLI
A robust command-line interface for interacting with the Wolt marketplace to browse venues, manage carts, and handle profile tasks.
Wolt CLI
A comprehensive command-line tool for browsing Wolt venues, managing carts, and automating delivery profile tasks through structured data.
Featured*
