核心用法
本技能通过 Playwright 浏览器自动化框架,实现对 klientenportal.at 的完整操作闭环。RZL Klientenportal 是奥地利 RZL Software 开发的专业税务文档交换平台,连接企业客户与税务会计师。
主要功能模块:
| 命令 | 功能 |
|------|------|
| `login` | 建立认证会话 |
| `upload` | 上传收据/发票(支持按 Belegkreis 分类:ER/AR/KA/SP)|
| `released` | 列示会计师已释放的文档 |
| `download` | 下载 Kanzleidokumente(财务报告)|
| `logout` | 清除会话,安全退出 |
技术实现: Python 3 + Playwright 驱动无头浏览器,会话状态以 700/600 权限存储于工作目录,下载路径默认沙盒化至 /tmp/openclaw/klientenportal/。
显著优点
1. 地域专业性:深度适配奥地利本地税务流程,支持德语文档分类体系(Eingangsrechnungen/Ausgangsrechnungen/Kassa/Sparkasse)
2. 端到端自动化:从登录到登出的完整工作流,避免人工浏览器操作
3. 安全设计:显式 logout 强制清除会话,目录权限严格控制,无 .env 加载降低凭证泄露面
4. 批量处理能力:支持通配符上传(*.xml)、多文档类型处理
潜在缺点与局限性
- Playwright 依赖:需维护浏览器二进制(~150MB),首次安装较重
- 界面脆弱性:基于 DOM 选择器的自动化,portal 前端更新可能导致失效
- 单租户限制:一次仅支持一个会计师/公司组合,多账户需切换配置
- 无原生 API:模拟浏览器而非调用 REST API,性能和稳定性受页面加载影响
- 地理锁定:仅适用于奥地利 RZL 生态系统,无国际扩展性
适合人群
- 奥地利中小企业财务部门,需定期向税务会计师批量提交凭证
- 使用 RZL 软件的会计事务所客户
- 寻求将收据数字化流程集成到自动化工作流的技术团队
常规风险
- 会话持久化风险:未调用
logout可能导致会话残留于磁盘 - 凭证管理:
config.json需额外加密或权限管控 - 合规边界:自动化上传需确保文档真实性,保留人工审计痕迹
- 依赖链风险:Python + Playwright + 浏览器内核的维护负担