什么是 RZL 客户门户？

RZL 客户门户技能是专为 RZL Software 的安全平台 klientenportal.at 设计的专业自动化工具。该技能允许用户通过编程方式与门户交互以管理会计文档交换，用精简的 CLI 命令取代手动浏览器操作。通过将其集成到 Openclaw Skills 生态系统中，开发人员可以构建用于税务合规和财务报告的自动化管道。

该技能基于 Playwright 和 Python 构建，可处理复杂的网页导航、会话管理和文件处理。它提供了一种可靠的方式，确保所有财务文档都经过正确分类并交付给税务专业人员，无需人工干预。

下载入口:https://github.com/openclaw/skills/tree/main/skills/odrobnik/klientenportal

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

RZL 客户门户 应用场景

• 自动化批量向税务门户上传进项和销项发票。
• 将银行对账单和信用卡收据与特定的会计类别同步。
• 定期调度下载由税务会计师发布的事务所文档和报告。
• 在 Openclaw Skills 工作流中以编程方式验证文档交付状态。

1. 该技能使用存储在环境变量中的凭据初始化 Playwright 浏览器实例。
2. 执行 klientenportal.at 的安全登录以建立经过身份验证的会话。
3. 根据命令，导航至上传部分、已发布文档列表或接收文件区域。
4. 文件根据用户定义的类别 (Belegkreis) 或下载模式进行处理。
5. 如有必要，下载的文件将自动从 ZIP 压缩包中提取并保存到本地目录。
6. 注销命令会清除浏览器会话以确保安全和数据隐私。

RZL 客户门户 配置指南

要使用此技能，请确保已安装 python3 和 playwright。在您的环境中设置所需的环境变量：

export KLIENTENPORTAL_PORTAL_ID="your_portal_id"
export KLIENTENPORTAL_USER_ID="your_user_id"
export KLIENTENPORTAL_PASSWORD="your_password"

通过运行测试登录来验证安装：

python3 scripts/klientenportal.py login

RZL 客户门户 数据架构与分类体系

该技能根据 RZL 分类法管理文档元数据和文件组织。上传使用 Belegkreis 代码进行分类：

接收的文件通过以下列进行跟踪：文件、发送者、文档区域、接收时间。默认情况下，除非在 Openclaw Skills 配置中指定了自定义输出路径，否则所有下载都将保存到 /tmp/openclaw/klientenportal/。

name: klientenportal
description: "Automate RZL Klientenportal.at — a web-based portal by RZL Software for exchanging receipts, invoices, and reports with your tax accountant. Login/logout, upload documents (Belegübergabe), list released files, and download Kanzleidokumente via Playwright."
summary: "RZL Klientenportal automation: upload receipts, download reports."
version: 1.5.1
homepage: https://github.com/odrobnik/klientenportal-skill
metadata:
  openclaw:
    emoji: "??"
    requires:
      bins: ["python3", "playwright"]
      python: ["playwright"]
      env: ["KLIENTENPORTAL_PORTAL_ID", "KLIENTENPORTAL_USER_ID", "KLIENTENPORTAL_PASSWORD"]

RZL Klientenportal

Automate klientenportal.at — a web portal by RZL Software for securely exchanging accounting documents between clients and their tax accountant.

Entry point: {baseDir}/scripts/klientenportal.py

Setup

See SETUP.md for prerequisites and setup instructions.

Commands

Login / Logout

python3 {baseDir}/scripts/klientenportal.py login          # Test login (validates credentials)
python3 {baseDir}/scripts/klientenportal.py logout         # Clear stored browser session

Upload Documents (Belegübergabe)

Upload receipts/invoices to a specific Belegkreis category:

python3 {baseDir}/scripts/klientenportal.py upload -f invoice.pdf --belegkreis KA
python3 {baseDir}/scripts/klientenportal.py upload -f *.xml --belegkreis SP

List Released Files

Show files your accountant has released (freigegebene Dokumente):

python3 {baseDir}/scripts/klientenportal.py released

Received Files (from Accountant)

List files received from your accountant (Kanzleidokumente / Auswertungen):

python3 {baseDir}/scripts/klientenportal.py received              # List all
python3 {baseDir}/scripts/klientenportal.py received -n 5          # Latest 5
python3 {baseDir}/scripts/klientenportal.py received --json         # JSON output

Output columns: Datei, Von, Dokumentbereich, Empfangen

Download Received Files

Download specific files from the received files list:

python3 {baseDir}/scripts/klientenportal.py received-download --latest                  # Latest file
python3 {baseDir}/scripts/klientenportal.py received-download 1 2 3                     # By index (1=latest)
python3 {baseDir}/scripts/klientenportal.py received-download "10-12_2025"              # By name pattern
python3 {baseDir}/scripts/klientenportal.py received-download "10-12_2025" -o ~/Downloads  # Custom output

Single-file downloads are auto-extracted from ZIP wrapper.

Download Kanzleidokumente (Legacy)

Download all available Kanzleidokumente at once:

python3 {baseDir}/scripts/klientenportal.py download                    # To default dir
python3 {baseDir}/scripts/klientenportal.py download -o /path/to/dir    # Custom output dir

Default output: /tmp/openclaw/klientenportal/

Options

• --visible — Show the browser window (useful for debugging or first login)

Recommended Flow

login → upload / released / download → logout

Always call logout after completing all operations to clear the stored browser session.