Integration

OpenClaw Skill

Give your OpenClaw assistant full access to your email. The Vigil skill lets your agent check your inbox, track obligations, manage threads, and talk to the Vigil agent — all through natural language.

Quick Install

One command. Downloads the skill and links it into OpenClaw.

Terminal

curl -sf https://vigil.run/install-skill.sh | bash

Or install manually:

Manual

# Clone or download the skill
git clone https://github.com/ArekAlvarez/vigil.git
ln -s "$(pwd)/vigil/skills/openclaw" ~/.openclaw/skills/vigil

# Set your API key
echo 'export VIGIL_API_KEY="vk_your_key_here"' >> ~/.zshrc
source ~/.zshrc

Configuration

The skill needs your Vigil API key. Get one from Account → Developer.

Your API Key

Add to ~/.zshrc

export VIGIL_API_KEY="vk_your_key_here"

VIGIL_API_KEYRequired. Your API key (starts with vk_)VIGIL_API_URLOptional. API base URL. Default: https://api.vigil.runVIGIL_WATCHER_IDOptional. Default watcher. Auto-detects if not set.

What You Can Say

Once installed, just talk to your assistant:

"Check my email"→vigil.sh status

"Any obligations I'm missing?"→vigil.sh obligations

"Show me the last 20 emails"→vigil.sh emails 20

"Tell Vigil to ignore marketing emails"→vigil.sh chat "ignore marketing emails"

"What does Vigil remember?"→vigil.sh memories

"How much has Vigil cost this month?"→vigil.sh usage

"What models are available?"→vigil.sh models

"Show watcher config"→vigil.sh config

All Commands

Command	Description
status	Inbox overview with costs, active threads, watching threads
emails [n]	List recent emails with triage status (default 10)
threads [status]	List threads: active, watching, ignored, resolved
obligations	Ask the agent what needs attention right now
chat "message"	Talk to the agent — can take actions and add rules
usage	Full cost and usage breakdown
memories	List agent memories with importance levels
tools	List custom webhook tools
models	List available AI models
config	Show all watcher configurations
set-model <id> <model>	Change a watcher's AI model
flush [watcher_id]	Flush all data for a watcher

How It Works

The skill is a SKILL.md file that tells OpenClaw when and how to call Vigil, plus a bash script that wraps the Vigil REST API. When you mention email, obligations, or deadlines, OpenClaw matches the skill description and runs the appropriate command.

The script uses curl and python3 (both preinstalled on macOS and most Linux systems). No additional dependencies.

Public Files

These files are available for agents and scripts:

vigil.run/SKILL.md — skill definition
vigil.run/vigil.sh — CLI wrapper script
vigil.run/llms.txt — machine-readable product summary

What is OpenClaw?

OpenClaw is an AI assistant platform that uses skills to extend what your agent can do. Skills are directories with a SKILL.md file and optional scripts. Drop them in ~/.openclaw/skills/ and your assistant learns new capabilities.