A lightweight Python-based command-line toolkit for French freelancers to manage clients, track time, and generate professional HTML invoices.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install freelance-toolkit-fr
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 freelance-toolkit-fr 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 Freelance Toolkit?
The Freelance Toolkit is a specialized suite of tools designed to simplify the administrative burden for independent workers and micro-entrepreneurs operating in France. By leveraging these Openclaw Skills, users can manage their entire business lifecycle—from client onboarding and time tracking to the generation of legally compliant invoices—directly from their terminal. The system is built using Python 3 standard libraries, ensuring a zero-dependency setup that prioritizes data privacy by storing all information locally in JSON format.
This toolkit specifically addresses the nuances of French business law, including SIRET management, IBAN integration, and mandatory legal mentions for micro-entreprises (such as Art. 293B of the CGI). It transforms the way developers and creatives handle their back-office tasks, providing a professional interface for generating high-quality HTML invoices that are ready for client delivery or PDF export.
Freelance Toolkit Use Cases
- Tracking billable hours for multiple client projects with start/stop functionality.
- Generating professional, French-compliant HTML invoices with automated numbering.
- Managing a centralized database of client contacts, addresses, and negotiated hourly rates.
- Visualizing financial health through a dashboard that calculates total revenue and effective hourly rates.
- Organizing business data for tax season using organized JSON logs and invoice histories.
How Freelance Toolkit Works
- Initialize the system by setting up your provider profile (name, address, SIRET, and tax status) using the configuration script.
- Populate your client database with relevant contact details and default billing rates.
- Track daily work sessions using the time tracking utility, which logs durations against specific projects.
- Generate HTML invoices by pulling data from the client database and time logs; the system automatically calculates totals and applies French legal headers.
- Monitor business performance via the dashboard script, which aggregates data from across the local filesystem to provide monthly and yearly summaries.
Freelance Toolkit Setup
The toolkit requires Python 3 and stores data in your home directory. Follow these steps to initialize your Openclaw Skills environment:
# 1. Configure your professional identity
python3 config.py set --name "Your Name" --address "123 Rue de Paris" --siret "12345678901234" --rate 80 --micro
# 2. Add your first client
python3 clients.py add --name "Client Name" --email "[email protected]" --rate 90
# 3. Start a time tracking session
python3 timetrack.py start "Project Development"
Freelance Toolkit Data Schema & Taxonomy
All business data is organized within the ~/.freelance/ directory for easy backup and portability.
| File/Directory | Description |
|---|---|
config.json |
Stores provider details, IBAN, and tax configuration (e.g., VAT rate). |
clients.json |
A registry of all client profiles, including custom notes and rates. |
timetrack.json |
A linear log of all work sessions with start/stop timestamps and metadata. |
invoices/ |
Contains generated .html invoice files and corresponding .json metadata for each invoice. |
Freelance Toolkit Advanced Features
- Automatic VAT handling: toggles between micro-entreprise (VAT not applicable) and standard VAT regimes.
- Multi-format output: supports
--jsonflags on all commands for integration with custom scripts or other Openclaw Skills. - Intelligent Dashboarding: calculates actual daily rates by dividing total revenue by worked hours across specific time periods.
- Print-optimized invoices: CSS styling specifically designed for high-quality 'Save to PDF' browser output.
- Automated Status Tracking: marks invoices as paid or unpaid to maintain an accurate account of outstanding receivables.
SKILL.md
Loading
Related Openclaw Skills
Deploy Kit
An automated deployment utility that simplifies launching web applications to Vercel, Railway, and Supabase via integrated CLI workflows.
Skill Security Scanner
A security-focused static analysis tool designed to audit Openclaw Skills for malicious patterns and vulnerabilities before they are installed.
Memory PARA
A hybrid memory management system that transforms raw episodic logs into structured semantic knowledge using the PARA method.
Private Chat
An encrypted communication layer for AI agents that secures sensitive data using AES-256-CBC and stealth activation.
French Services Skill
A comprehensive suite of Python scripts for accessing real-time French transport, logistics, and weather data.
Legal Docs FR
A Python-powered CLI generator for French legal documents, creating print-ready HTML for CGV, contracts, and quotes for freelancers.
Featured*
