OpenClaw Assistant — Skill Suite

A set of OpenClaw AgentSkills for personal productivity:

Skill	What it does
⏱ Toggl	Start/stop timers, daily summaries, recent time logs
Email	Send email, fetch unread inbox, search by subject
Slack	Post messages, list channels, read history
OpenRouter	Chat with any AI (GPT-4o, Claude, Llama, Mistral…)

---

Quick Start

1. Clone & configure credentials

cp .env.example .env
# Edit .env and fill in your API keys

2. Install dependencies

Each skill has its own requirements.txt. Install what you need:

# Toggl
pip install -r toggl-skill/requirements.txt

# Email — no install needed (uses Python stdlib)

# Slack
pip install -r slack-skill/requirements.txt

# OpenRouter
pip install -r openrouter-skill/requirements.txt

# Or install everything at once:
pip install requests slack-sdk "openai>=1.0.0"

3. Register skills with OpenClaw

In your openclaw.json (or via the OpenClaw CLI), point to each skill folder:

{
  "skills": [
    "./toggl-skill",
    "./email-skill",
    "./slack-skill",
    "./openrouter-skill"
  ]
}

4. Test each skill individually

# Load .env first
export $(grep -v '^#' .env | xargs)

python toggl-skill/toggl_skill.py        # Check Toggl profile + today's summary
python email-skill/email_skill.py        # Fetch 3 unread emails
python slack-skill/slack_skill.py        # Post test message to default channel
python openrouter-skill/openrouter_skill.py  # Chat with default AI model

---

Credential Setup

Toggl

1. Log in to track.toggl.com
2. Go to Profile Settings → scroll to API Token
3. Copy the token → paste as TOGGL_API_KEY in .env

Email (Gmail)

1. Enable 2FA on your Google account
2. Go to Google Account → Security → App Passwords
3. Create a password for "Mail" → use it as EMAIL_PASSWORD
4. Set EMAIL_ADDRESS to your Gmail address

Slack

1. Visit api.slack.com/apps → Create New App
2. Under OAuth & Permissions, add bot scopes: chat:write, channels:read, channels:history
3. Install the app to your workspace
4. Copy the Bot User OAuth Token → paste as SLACK_BOT_TOKEN
5. Invite your bot to channels: /invite @YourBotName

OpenRouter

1. Sign up at openrouter.ai
2. Go to openrouter.ai/keys → Create Key
3. Paste as OPENROUTER_API_KEY
4. Optionally set OPENROUTER_DEFAULT_MODEL (default: openai/gpt-4o-mini)

Popular free models:

• meta-llama/llama-3.3-70b-instruct
• mistralai/mistral-7b-instruct
• google/gemini-flash-1.5

---

Project Structure

openclaw-assistant/
 .env.example                    ← Copy to .env and fill in keys
 README.md

 toggl-skill/
    SKILL.md                    ← OpenClaw skill descriptor
    toggl_skill.py              ← Toggl Track API v9
    requirements.txt

 email-skill/
    SKILL.md
    email_skill.py              ← SMTP (send) + IMAP (read)
    requirements.txt            ← stdlib only, no pip install

 slack-skill/
    SKILL.md
    slack_skill.py              ← Slack Web API via slack-sdk
    requirements.txt

 openrouter-skill/
     SKILL.md
     openrouter_skill.py         ← Any AI model via OpenRouter
     requirements.txt