← Back to Skills Marketplace

Konto

Name: Konto
Author: angelstreet

by angelstreet · GitHub ↗ · v1.1.0

cross-platform ⚠ suspicious

406

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install konto

Description

Deploy and run Konto (personal finance dashboard) locally. Use when setting up a new Konto instance, troubleshooting installation, or helping users get start...

README (SKILL.md)

Konto — Personal Finance API

Query personal finance data from Konto (bank accounts, investments, assets, loans, transactions).

Setup

# ~/.openclaw/secrets/konto.env
export KONTO_API_KEY="konto_xxxxxxxxxxxx"
export KONTO_URL="https://konto.angelstreet.io"

Quick Answers

"How much BTC do I have?"

source ~/.openclaw/secrets/konto.env
curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/investments" | jq '.investments[] | select(.code | test("BTC|bitcoin"; "i")) | {label, quantity, current_value}'

"What's my net worth?"

curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/summary" | jq '{patrimoine_net, accounts: .accounts.total_balance, investments: .investments.total_value, assets: .assets.total_value, loans: .loans.total_remaining}'

"When does my loan end?"

curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/loans" | jq '.loans[] | {name, remaining_amount, end_date, monthly_payment}'

"What are my subscriptions?"

curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/summary" | jq '{count: .subscriptions.count, monthly: .subscriptions.monthly}'

"How much do I spend on housing?"

curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/transactions?months=6&category=logement" | jq '{total: .total, transactions: [.transactions[] | {date, label, amount}]}'

"Financial overview"

curl -s -H "Authorization: Bearer $KONTO_API_KEY" "$KONTO_URL/api/v1/summary"

Helper Script

bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh summary
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh investments
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh transactions 3  # last 3 months
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh loans
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh assets
bash ~/.openclaw/workspace/skills/konto/scripts/konto.sh accounts

Endpoints

Endpoint	Description
`GET /api/v1/summary`	Full financial overview (start here)
`GET /api/v1/accounts`	Bank accounts list
`GET /api/v1/transactions?months=6&category=X`	Categorized transactions
`GET /api/v1/investments`	Portfolio (ETFs, stocks, crypto)
`GET /api/v1/assets`	Real estate, vehicles
`GET /api/v1/loans`	Active loans

Full API Reference

See ~/shared/projects/konto/docs/api.md for complete docs including analytics endpoints.

Scope

This skill uses a personal scope key (free). For cross-user analytics (pro), see the konto-analytics skill.

Usage Guidance

This skill appears to be a simple API client for a Konto service (it curls endpoints and expects an API key). Before installing or using it: 1) Be aware that the package description claims it will 'deploy' Konto locally but there are no deployment steps — if you wanted a deploy script, ask the author or reject the skill. 2) The helper script and SKILL.md source ~/.openclaw/secrets/konto.env — do not put secrets there unless you trust the endpoint. Confirm KONTO_URL is the host you expect (script defaults to https://konto.angelstreet.io while api.md mentions localhost). 3) Inspect or run the script yourself in a restricted environment (or a container) to verify behavior; the script only issues curl requests, but those requests will reveal your API key to the configured URL. 4) If you need analytics endpoints, note they require a different scope; only give that key if you understand the implications. If you want deployment instructions or source for running Konto locally, request those explicitly — they are not included here.

Capability Analysis

Type: OpenClaw Skill Name: konto Version: 1.1.0 The Konto skill bundle is a legitimate tool for querying personal finance data via the Konto API. It includes a bash script (scripts/konto.sh) and documentation (SKILL.md, api.md) that facilitate standard API interactions using curl and jq. No evidence of data exfiltration, malicious execution, or prompt injection was found; all actions are consistent with the stated purpose of managing financial data from https://konto.angelstreet.io.

Capability Assessment

⚠ Purpose & Capability

The skill description says 'Deploy and run Konto (personal finance dashboard) locally' but the SKILL.md, api.md, and helper script are purely an API client / query helper (curl + jq) and contain no deployment or build instructions. That mismatch could be benign (misleading description) but is an incoherence a user should be aware of.

ℹ Instruction Scope

Runtime instructions consistently tell the agent/user to source ~/.openclaw/secrets/konto.env and then curl Konto endpoints. The instructions do not read other system files or credentials beyond that secrets file. They do not attempt to exfiltrate data to unexpected endpoints. Note: example default endpoints differ between files (SKILL.md/script use https://konto.angelstreet.io while api.md lists default http://localhost:5004).

✓ Install Mechanism

There is no install spec (instruction-only) and the only bundled code is a small helper script (konto.sh) that issues curl calls. Nothing in the package downloads or extracts remote code during install.

ℹ Credentials

The skill requires an API key and URL (KONTO_API_KEY, KONTO_URL) to function; that is proportionate for an API client. However, the registry metadata lists no required env vars while the SKILL.md and script explicitly expect ~/.openclaw/secrets/konto.env — a minor metadata omission that could confuse users. Ensure you only provide the key to a trusted URL.

✓ Persistence & Privilege

The skill does not request always:true, does not attempt to modify other skills or system-wide configuration, and doesn't persist tokens beyond reading the user's secrets file. It runs as an on-demand helper.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install konto
After installation, invoke the skill by name or use /konto
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.1.0

Konto skill v1.1.0 — now provides API querying for live personal finance data. - Redesigned skill to use API keys and direct API calls for live data queries. - Added comprehensive API usage examples for common finance questions. - Introduced a helper shell script (`scripts/konto.sh`) for quick command-line access to key endpoints. - Added new documentation files: `api.md` and `_meta.json`. - Updated instructions and scope details to clarify setup and personal usage.

v1.0.0

Initial release — self-host personal finance dashboard

Metadata

Slug konto

Version 1.1.0

License —

All-time Installs 1

Active Installs 1

Total Versions 2

Frequently Asked Questions

What is Konto?

Deploy and run Konto (personal finance dashboard) locally. Use when setting up a new Konto instance, troubleshooting installation, or helping users get start... It is an AI Agent Skill for Claude Code / OpenClaw, with 406 downloads so far.

How do I install Konto?

Run "/install konto" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Konto free?

Yes, Konto is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Konto support?

Konto is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Konto?

It is built and maintained by angelstreet (@angelstreet); the current version is v1.1.0.

More Skills