什么是 SOLO CLI？

SOLO CLI 是为使用 SOLO.ro 会计服务的罗马尼亚企业家和开发人员设计的全面终端实用程序。通过将此工具集成到 Openclaw Skills 系列中，用户可以直接从其开发环境执行复杂的会计任务，例如审计收入、检查纳税义务和管理 e-Factura 文档。

该工具既提供用于快速查询的直接命令执行模式，也提供用于更直观、类似仪表盘体验的丰富终端用户界面 (TUI)。它弥合了专业会计要求与开发人员生产力之间的鸿沟，确保财务管理像 git 工作流一样流畅。

下载入口:https://github.com/openclaw/skills/tree/main/skills/rursache/solo-cli

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

SOLO CLI 应用场景

• 通过终端查看年初至今的财务摘要和税务评估。
• 列出并筛选收入发票，以跟踪客户的待付款项。
• 管理 e-Factura 流，以确保符合罗马尼亚国家电子发票标准。
• 上传 PDF 或图像等业务费用文档进行自动处理。
• 删除或管理会计队列中的待处理项目，以保持记录整洁。

1. 应用程序通过读取用户配置文件并检查缓存的会话 cookie 来初始化，以避免冗余登录。
2. 如果未找到有效的会话，它将使用存储的凭据安全地向 SOLO.ro 平台进行身份验证。
3. 执行命令后，该工具向平台的内部 API 发出经过身份验证的请求以获取会计数据。
4. 数据在本地进行处理，并格式化为 CLI 的可读表格或 TUI 的交互式组件。
5. 对于上传等写入操作，该技能处理文件多部分编码并监控处理队列状态。

SOLO CLI 配置指南

要将此技能集成到您的工作流中，请确保满足 Openclaw Skills 的先决条件，然后通过 Homebrew 安装：

brew install rursache/tap/solo-cli

通过在 ~/.config/solo-cli/config.json 创建具有以下结构的配置文件来配置您的环境：

{
  "username": "your_email@solo.ro",
  "password": "your_password"
}

通过运行 solo-cli summary 查看您当年的财务概览来验证安装。

SOLO CLI 数据架构与分类体系

该技能通过本地配置和结构化 API 交互来组织其操作，详见下文：

name: solo-cli
description: Monitor and interact with SOLO.ro accounting platform via CLI or TUI (summary, revenues, expenses, queue, e-factura, company). Use when a user asks to check their accounting data, view invoices, expenses, or e-factura documents, or translate a task into safe solo-cli commands.

SOLO CLI

Overview

Use solo-cli to access SOLO.ro accounting platform data via command-line interface or interactive TUI.

Installation

If the solo-cli command is not available, install via Homebrew:

brew install rursache/tap/solo-cli

Defaults and safety

• Config file location: ~/.config/solo-cli/config.json (created on first run)
• Use --config or -c to specify a custom config path
• Credentials are stored locally; never passed as command arguments
• Session cookies are cached to ~/.config/solo-cli/cookies.json for faster subsequent logins

Quick start

• Configure: Edit ~/.config/solo-cli/config.json with username/password
• Summary: solo-cli summary
• Summary for year: solo-cli summary 2025
• Revenues: solo-cli revenues
• Expenses: solo-cli expenses
• Queue: solo-cli queue
• E-Factura: solo-cli efactura
• Company: solo-cli company
• Upload: solo-cli upload file.pdf
• Delete: solo-cli queue delete
• TUI: solo-cli (no command)
• Demo: solo-cli demo

Configuration

Config file structure:

{
  "username": "your_email@solo.ro",
  "password": "your_password",
  "company_id": "12345",
  "page_size": 100,
  "user_agent": "Mozilla/5.0 ..."
}

Commands

summary [year]

Show account summary for a year.

solo-cli summary          # Current year
solo-cli summary 2025     # Specific year

Output: Year, Revenues, Expenses, Taxes

revenues

List revenue invoices.

solo-cli revenues
solo-cli rev              # Alias

Output: Invoice code, amount, currency, paid status, client name

expenses

List expenses.

solo-cli expenses
solo-cli exp              # Alias

Output: Amount, currency, category, supplier name

queue

List pending documents in expense queue or delete them.

solo-cli queue            # List queue
solo-cli q                # Alias
solo-cli queue delete 123 # Delete item by ID
solo-cli q del 123        # Alias

Output: Document name, days pending, overdue status (ID included)

efactura

List e-Factura documents.

solo-cli efactura
solo-cli ei               # Alias

Output: Serial code, amount, currency, date, party name

company

Show company profile.

solo-cli company

Output: Company name, CUI, registration number, address

upload

Upload an expense document (PDF or image).

solo-cli upload invoice.pdf
solo-cli up invoice.pdf   # Alias

Output: Upload status and confirmation.

demo

Start TUI with mock data for screenshots or testing (no API calls).

solo-cli demo

tui

Start interactive TUI mode (default when no command given).

solo-cli tui
solo-cli                  # Same as above

Global options

Examples

# Basic usage
solo-cli summary
solo-cli revenues

# Custom config
solo-cli -c ~/work-config.json summary

# Pipe to grep
solo-cli expenses | grep -i "food"

# View specific year
solo-cli summary 2024

# Upload a document
solo-cli upload invoice.pdf

# Delete a queued item
solo-cli queue delete 123456

Authentication flow

1. On startup, loads cookies from ~/.config/solo-cli/cookies.json
2. Validates cookies with a test API call
3. If valid, uses cached session
4. If invalid/missing, logs in with credentials from config
5. Saves new cookies for next session

Troubleshooting

• "credentials missing": Edit config.json with your SOLO.ro username/password
• "authentication failed": Check credentials are correct
• "invalid JSON in config": Fix syntax errors in config.json
• Company info not showing: Add company_id to config (optional field)