Splitwise

该 Skill 提供 Python 脚本，使用 SPLITWISE_API_KEY 长期令牌调用 Splitwise 的创建支出接口，按 50/50 在两名用户间拆分账单，支持金额、描述、付款人 ID、对方 ID、可选群组 ID 与来源标记等参数；仅实现新增支出，未提供余额查询或记录列表能力。

richieforeman

热度 60.05

最近更新 2026-05-11 17:26:25

分类：生活依赖：代码执行 / 第三方 API应用场景：财务 / 个人理财 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add splitwise

Metadata

name: splitwise
description: Create and manage expenses on Splitwise. Use this skill when the user wants to log a new expense, split a bill, or check their Splitwise balance.
homepage: https://github.com/richieforeman/openclaw-splitwise-skill
metadata: {"clawdbot":{"emoji":"💸","requires":{"env":["SPLITWISE_API_KEY"]},"primaryEnv":"SPLITWISE_API_KEY","files":["scripts/*"]}}

Splitwise Skill

This skill allows an agent to interact with the Splitwise API to automate shared expenses.

Requirements

SPLITWISE_API_KEY: A Long-lived User Token obtained from the Splitwise Developer Console.

External Endpoints

URL	Purpose	Data Sent
`https://secure.splitwise.com/api/v3.0/create_expense`	Create a new expense	Cost, description, user IDs, shares, and group ID.

Security & Privacy

Data Outbound: This skill sends expense details (cost, description, user IDs) to the Splitwise API.
Credentials: Your SPLITWISE_API_KEY is sent in the Authorization header to Splitwise. It never leaves the machine except to communicate with the official Splitwise API.
Input: User input for cost and description is handled safely by the Python urllib.request and argparse libraries.

Usage

Logging an Expense

The primary script handles creating a 50/50 split between two users.

python3 {baseDir}/scripts/add_expense.py \
  --cost "10.00" \
  --desc "Lunch" \
  --payer_id "12345" \
  --other_id "67890" \
  --via "whisker"

Parameters

--cost: Total amount (e.g., "45.00")
--desc: Brief description of the expense.
--payer_id: The Splitwise User ID of the person who paid.
--other_id: The Splitwise User ID of the person being split with.
--group_id: (Optional) The ID of a specific Splitwise group.
--via: (Optional) Appends "(via name)" to the description.

Setup for Agents

Create a Splitwise App at https://secure.splitwise.com/apps.
Generate a "Long-lived User Token".
Store it as SPLITWISE_API_KEY.
Use the API to find your User IDs and Group IDs.

Model Invocation Note

This skill is designed for autonomous invocation by AI models. The model will automatically determine when to call these tools based on user requests (e.g., "split the $20 lunch with Nancy").

Trust Statement

By using this skill, data is sent to Splitwise. Only install this skill if you trust Splitwise with your expense data.