核心用法
klientenportal 是一款针对奥地利 RZL Software 旗下 klientenportal.at 平台的自动化技能，专为企业客户与税务会计师之间的文档交换设计。通过 Playwright 浏览器自动化技术，该技能实现了完整的门户操作流程：登录验证、凭证票据上传（Belegübergabe）、已发布文件查询以及事务所文档批量下载（Kanzleidokumente）。
主要功能模块包括：
- 身份管理：
login/logout命令支持会话持久化与清理 - 智能上传：支持 PDF、XML 等多格式文件，按业务类别（ER/AR/KA/SP）自动分类归档
- 双向获取：查询会计师已发布的处理结果，批量下载完整报告文档
- 调试支持：
--visible模式便于首次配置或故障排查
显著优点
1. 专业场景精准覆盖：深度适配奥地利德语区税务会计流程，Belegkreis 分类体系（收入发票/支出发票/现金/银行）与本地实务完全对齐
2. 零接触自动化：消除手工登录、分类拖拽、逐个下载等重复劳动，适合月度/季度定期归档
3. 会话安全设计：显式 logout 机制强制清理浏览器状态，降低凭证泄露风险
4. 开源可审计：代码公开于 GitHub，依赖 Playwright 成熟生态，无黑箱操作
潜在局限与风险
- 地域限制：仅服务于 RZL Klientenportal.at 平台，其他国家税务系统或 RZL 旗下其他产品不支持
- 平台绑定：依赖特定 Portal ID 与账户体系，迁移成本较高
- 下载粒度不足：暂不支持单文件选择，只能全量下载 Kanzleidokumente
- 浏览器依赖：Playwright 需定期同步 Chromium/Firefox 版本，存在兼容性维护负担
- 凭证暴露：环境变量明文存储密码，在共享环境中需配合外部密钥管理（如 1Password、Bitwarden）使用
适合人群
- 在奥地利运营、使用 RZL 会计服务的企业财务负责人
- 需要将月度票据批量提交给外包会计团队的中小企业
- 追求合规自动化、减少人工数据录入错误的财务流程优化者
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | 密码以环境变量形式存储 | 使用专属服务账户、最小权限原则，配合密码管理器注入 |
| 会话劫持 | Playwright 持久化上下文可能被恶意读取 | 严格执行 logout，定期清理 `/tmp/openclaw/` 临时目录 |
| 操作冲突 | 自动化与人工同时操作可能产生状态不一致 | 设定专属时间窗口执行自动化任务 |
| 平台变更 | RZL 门户 UI 更新可能导致选择器失效 | 关注上游仓库更新，保留 `--visible` 调试能力 |