功能描述

KallyAI Executive Assistant — AI that handles phone calls (outbound + inbound), email, bookings, research, errands, multi-channel messaging, and phone number...

使用说明 (SKILL.md)

KallyAI Executive Assistant

Name: KallyAI Executive Assistant (Claude Code)
Author: sltelitsyn

KallyAI is an AI executive assistant that handles outbound + inbound calls, email, bookings, research, bills, rides, food orders, errands, multi-channel messaging, and phone number management — all from the terminal.

Quick Start

# The 80% command — natural language, routes automatically
python kallyai.py ask "Book a table at Nobu for 4 tonight"
python kallyai.py ask "Email Dr. Smith to reschedule my Thursday appointment"
python kallyai.py ask "Find the best plumber near me and negotiate a quote"

# Check credits (NOT minutes — credits are the sole billing unit)
python kallyai.py credits balance

# Check your inbox
python kallyai.py messages inbox

# View incoming calls handled by your AI receptionist
python kallyai.py inbound calls

Complete Workflow

Step 1: Gather Intent

Determine what the user needs. KallyAI covers 14 domains:

Domain	Examples
Coordination	"Book a table", "Handle this for me", any multi-step request
Calls	Call a business, check on a reservation, negotiate
Inbound	View incoming calls, manage routing rules, voicemails, contacts
Phone	Provision numbers, set up forwarding, manage caller ID
Actions	Calendar events, bookings, bill analysis, rides, food, errands
Messages	Check inbox, read messages, view threads
Search	Find businesses, research options, compare prices
Email	Send emails, manage accounts, train voice profile
Channels	Manage WhatsApp, Telegram, email contacts, channel status
Outreach	Multi-channel outreach tasks (call + email + messaging)
Budget	Estimate costs, approve budgets, view breakdowns
Credits	Check balance, view history, spending breakdown, plans
Subscription	Change plan, view status, cancel pending changes
Referrals	Get referral code, view stats, track referrals

For most requests, use ask — it routes through the coordination AI automatically.

Step 2: Authenticate

Authentication is automatic. First API call opens browser for Google/Apple sign-in.

python kallyai.py login         # Force re-auth
python kallyai.py logout        # Clear credentials
python kallyai.py auth-status   # Check login

Step 3: Execute

Natural language (preferred):

python kallyai.py ask "Reserve a table for 4 at 8pm at Nobu"

Direct commands (when you know the domain):

python kallyai.py calls make -p "+15551234567" -t "Reserve table for 4 at 8pm"
python kallyai.py actions calendar create --title "Dinner" --start "2026-02-14T20:00"
python kallyai.py search run "best Italian restaurant downtown"
python kallyai.py inbound calls --status completed
python kallyai.py phone list

Step 4: Monitor & Follow Up

# Check goal status
python kallyai.py coord goals --status active
python kallyai.py coord goal \x3CGOAL_ID>

# Review outbound call results
python kallyai.py calls history
python kallyai.py calls info \x3CCALL_ID>
python kallyai.py calls transcript \x3CCALL_ID>

# Review inbound calls handled by AI receptionist
python kallyai.py inbound calls
python kallyai.py inbound call \x3CCALL_ID>
python kallyai.py inbound transcript \x3CCALL_ID>

# Check inbox for responses
python kallyai.py messages inbox --unread

Domain Command Reference

`ask` — Natural Language (80% of usage)

python kallyai.py ask "Your request in plain English"

Routes through coordination AI. Creates goals, makes calls, sends emails — whatever is needed.

`coord` — Coordination & Goals

coord message "text"           # Chat with coordination AI
coord goals [--status X]       # List goals
coord goal \x3Cid>                # Goal details
coord goal-tree \x3Cid>           # Goal + sub-goals
coord cancel-goal \x3Cid>         # Cancel goal
coord cascade-cancel \x3Cid>      # Cancel goal + sub-goals
coord escalate \x3Cid>            # Escalate for attention
coord approve-step \x3Cid>        # Approve next step
coord accept \x3Cid>              # Accept outcome
coord continue \x3Cid>            # Continue negotiating
coord archive \x3Cid>             # Archive goal
coord batch-archive \x3Cid>...    # Archive multiple
coord budget \x3Cid>              # Goal budget details
coord history                  # Conversation history
coord conversations            # List conversations
coord new                      # New conversation

`calls` — Outbound Phone Calls

calls make -p "+1..." -t "task"  # Make a call
calls history                     # List calls
calls info \x3Cid>                   # Call details
calls transcript \x3Cid>             # Transcript
calls recording \x3Cid>              # Recording URL
calls calendar \x3Cid>               # Calendar .ics
calls cancel \x3Cid>                 # Cancel call
calls reschedule \x3Cid>             # Reschedule
calls stop \x3Cid>                   # Stop active call

`inbound` — AI Receptionist (Incoming Calls)

inbound calls [--status X]          # List incoming calls
inbound call \x3Cid>                    # Call details
inbound transcript \x3Cid>              # Call transcript
inbound recording \x3Cid>               # Call recording
inbound summary                      # Incoming call summary/stats
inbound analytics [--from X --to X]  # Call analytics
inbound transfer \x3Cid> --to "+1..."   # Transfer call
inbound takeover \x3Cid>                # Take over live call
inbound reject \x3Cid> [--reason X]     # Reject call
inbound rules                        # List routing rules
inbound add-rule --name "..." --action "..." # Create rule
inbound update-rule \x3Cid> ...         # Update rule
inbound delete-rule \x3Cid>             # Delete rule
inbound voicemails                   # List voicemails
inbound voicemail \x3Cid>               # Voicemail details
inbound voicemail-playback \x3Cid>      # Voicemail audio
inbound contacts                     # List contacts
inbound add-contact --name "..." --phone "+1..." # Add contact
inbound update-contact \x3Cid> ...      # Update contact
inbound delete-contact \x3Cid>          # Delete contact
inbound import-contacts \x3Cfile>       # Import contacts
inbound events [--from X --to X]     # Event log

`phone` — Phone Number Management

phone list                           # List your numbers
phone info \x3Cid>                      # Number details
phone countries                      # Supported countries
phone available --country US         # Search available numbers
phone provision --country US         # Provision new number
phone forwarding \x3Cid> --target "+1..." # Set call forwarding
phone remove-forwarding \x3Cid>         # Remove forwarding
phone verify-start \x3Cnumber>          # Start verification
phone verify-check \x3Cnumber> --code X # Check verification code
phone caller-id \x3Cid> --name "..."    # Set caller ID
phone release \x3Cid>                   # Release number

`actions` — Autonomous Actions

actions calendar create --title "..." --start "..."
actions calendar slots [--date X]
actions calendar sync
actions calendar delete \x3Cid>
actions restaurant search "query" [--location X]
actions booking create --type restaurant [--date X]
actions booking cancel \x3Cid>
actions bill analyze "description" [--amount X]
actions bill dispute "description" [--reason X]
actions ride --pickup "..." --destination "..."
actions food "order description" [--address X]
actions errand "errand description"
actions email send --to "..." --subject "..." "body"
actions email approve \x3Cid>
actions email cancel \x3Cid>
actions email outbox
actions email replies \x3Cid>
actions log [--type X]
actions undo \x3Cid>

`messages` — Unified Inbox

messages inbox [--channel email|sms|call|chat] [--unread]
messages read \x3Cid>
messages thread \x3Cconversation_id>
messages mark-read \x3Cid> [\x3Cid>...]

`search` — Research

search run "query" [--location X]
search quick "query"
search history
search sources

`email` — Email Account Management

email accounts                          # List connected
email connect gmail|outlook             # Connect provider
email disconnect \x3Cid>                   # Disconnect
email list [--classification important] # List messages
email read \x3Cid>                         # Read email
email respond \x3Cid> [instructions]       # Respond
email voice-profile                     # Get voice profile
email train-voice                       # Train from samples

`channels` — Multi-Channel Management

channels status                  # All channel statuses
channels email-add \x3Caddress>     # Add email contact
channels email-list              # List email contacts
channels email-update \x3Cid> ...   # Update email contact
channels email-delete \x3Cid>       # Delete email contact
channels email-verify \x3Ctoken>    # Verify email
channels mailbox                 # Get KallyAI mailbox address
channels connect \x3Cchannel>       # Connect WhatsApp/Telegram
channels test \x3Cchannel>          # Test channel connection
channels disconnect \x3Cchannel>    # Disconnect channel

`outreach` — Multi-Channel Outreach

outreach tasks [--status X]      # List outreach tasks
outreach task \x3Cid>               # Task details
outreach create --channel call --target "+1..." "description"
outreach retry \x3Cid>              # Retry failed task
outreach cancel \x3Cid>             # Cancel task

`budget` — Cost Management

budget estimate --type call "description"
budget approve \x3Cgoal_id>
budget breakdown \x3Cgoal_id>
budget ack-cap \x3Cgoal_id>

`credits` — Balance & Usage

credits balance     # Current balance (credits, NOT minutes)
credits history     # Usage history
credits breakdown   # Spending breakdown by action type
credits costs       # Credit cost reference
credits plans       # Available credit plans

`subscription` — Plan Management

subscription status               # Current plan status
subscription change-plan \x3Cplan>   # Change to new plan
subscription cancel-change        # Cancel pending plan change

`referrals` — Referral Program

referrals code        # Get your referral code
referrals stats       # Referral statistics
referrals history     # Referral history

`notifications` — Notifications

notifications pending   # Check pending notification counts

Output Format

Default output is JSON (machine-readable for Claude Code). Add --human for formatted tables.

python kallyai.py credits balance              # JSON
python kallyai.py credits balance --human      # Pretty table

Backward Compatibility

Old flags still work — they map to new subcommands:

python kallyai.py --phone "+1..." --task "..."   → calls make
python kallyai.py --usage                         → credits balance
python kallyai.py --history                       → calls history
python kallyai.py --call-info ID                  → calls info ID
python kallyai.py --transcript ID                 → calls transcript ID

Security

Tokens stored in ~/.kallyai_token.json with 0600 permissions
Only localhost redirect URIs accepted for CLI auth
CSRF protection via state parameter
Tokens expire after 1 hour, auto-refresh supported

Common Errors

Code	HTTP	Action
`quota_exceeded`	402	User needs more credits — kallyai.com/pricing
`missing_phone_number`	422	Ask user for phone number
`emergency_number`	422	Cannot call emergency services
`country_restriction`	403	Country not supported
`budget_exceeded`	402	Goal over budget — approve or cancel
`email_not_connected`	400	Need to connect email account first
`phone_not_provisioned`	400	Need to provision a phone number first

Full API Reference

See references/api-reference.md for complete endpoint documentation.

安全使用建议

This package contains runnable Python code that will open your browser to sign in and then store an OAuth access/refresh token at ~/.kallyai_token.json. Before installing or running: 1) Inspect the scripts locally (you already have them) — do not run code you don't review. 2) Note the missing declared dependency (httpx) and ensure you install packages from trusted sources or run inside an isolated environment (virtualenv or container). 3) Be aware the token grants broad access (email, calls, billing, recordings); if you proceed, review the exact OAuth scopes during sign-in and revoke the token from your account if you stop using the tool. 4) Prefer running in a disposable VM/container if you want to test functionality safely. 5) The skill's source and homepage are not provided — lack of provenance reduces trust; prefer tools with a verifiable upstream and published releases.

功能分析

Type: OpenClaw Skill Name: kallyai-api Version: 2.0.0 The OpenClaw AgentSkills skill bundle for KallyAI is a benign command-line interface (CLI) client. The `scripts/kallyai.py` script securely handles OAuth authentication with CSRF protection, stores tokens with `0o600` permissions in `~/.kallyai_token.json`, and communicates exclusively with the `https://api.kallyai.com` endpoint. User input is parsed via `argparse` and sent as JSON payloads to the API, preventing shell injection. There is no evidence of data exfiltration to unauthorized endpoints, malicious execution (e.g., `curl|bash`, `eval`), persistence mechanisms, or prompt injection attempts in `SKILL.md` designed to subvert the AI agent's instructions beyond the tool's stated purpose. The `webbrowser.open` calls are for legitimate OAuth flows to `api.kallyai.com` and `127.0.0.1` callbacks.

能力评估

ℹ Purpose & Capability

The name/description (phone calls, email, bookings, etc.) align with the included CLI code and the extensive API reference: the tool uses OAuth and calls api.kallyai.com to perform those actions. However the registry metadata claims no dependencies or env vars while the shipped Python code requires the httpx package and implicitly requires Python — this mismatch between declared requirements and actual code is unexpected and worth noting.

✓ Instruction Scope

SKILL.md and the CLI code instruct the user to run local Python commands and perform OAuth sign-in via a browser with a localhost callback; the code only references local token storage (~/.kallyai_token.json) and the API domain. The instructions do not ask the agent to read unrelated system files or exfiltrate arbitrary data. Opening a localhost callback and saving tokens is within the expected scope for a CLI that performs account actions.

⚠ Install Mechanism

There is no install spec in the registry, but the Python scripts require an external dependency (httpx). The mismatch means users may run the script without satisfying dependencies or without a clear install process. No packaged release or verified install source is provided; code will be executed locally from the skill bundle, so users should be aware they're running third-party Python code with network access.

ℹ Credentials

The skill declares no required env vars or primary credential because it uses OAuth. That is coherent. However the OAuth token grants broad scopes (email read/write, calls read/write, billing/manage, recordings/transcripts access). Tokens and refresh tokens are stored on-disk at ~/.kallyai_token.json with 0600 perms — convenient, but this creates persistent credentials on the host which other processes or backups might access if misconfigured. The breadth of scopes is functionally justified by the described features but increases the sensitivity of the stored tokens.

ℹ Persistence & Privilege

The skill does not request always:true and does not modify other skills; autonomous invocation is allowed (default) but not unusual. It does persist credentials to a local file and will reuse/refresh them across runs, which is expected for a CLI but means the skill has ongoing access to the user's account until tokens are revoked.

版本历史

v2.0.0

Major update: Added 6 new domains (inbound AI receptionist, phone number management, multi-channel messaging, outreach, subscription management, referrals, notifications). Expanded from 8 to 14 user-facing domains. Full CLI with 20 subcommands. Complete API reference with 17 endpoint sections.

v1.0.3

Clean release - OAuth-only auth, no PII

v1.0.2

Clean release - OAuth-only auth

v1.0.1

Remove PII from examples, OAuth-only auth

v1.0.0

Initial release - AI phone assistant integration for making calls to businesses

元数据

Slug kallyai-api

版本 2.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 5

常见问题