核心用法
xero-accounting 是一个专为 OpenClaw 设计的 Xero 会计集成技能,通过 ClawLink 托管服务实现与 Xero API 的安全连接。用户无需自行申请 API 凭证或处理 OAuth 流程,仅需三步即可完成部署:安装插件、配对设备、连接 Xero 账户。
该技能覆盖 Xero 核心会计场景:
- 发票管理:创建、更新、作废、发送发票,支持销售发票(ACCREC)和采购账单(ACCPAY)
- 联系人管理:客户与供应商的增删改查及搜索
- 支付记录:记录和删除付款
- 会计科目:查看和修改科目表
- 银行交易:存取款、转账及银行流水管理
- 手动日记账:会计分录的创建与查询
- 组织信息:获取公司详情及配置货币
所有工具调用均通过 clawlink_call_tool 统一入口,参数采用 JSON 格式,读写操作分离标识明确。
显著优点
1. 零配置接入:ClawLink 托管 OAuth 令牌,用户无需编写代码或管理 API 密钥
2. 操作覆盖面广:支持 40+ 个 Xero API 端点,涵盖从发票到银行流水的完整会计周期
3. 安全设计:写操作强制用户确认,读操作可直接执行,降低误操作风险
4. 实时工具发现:通过 clawlink_list_tools 动态获取可用工具列表,避免硬编码假设
5. 多租户支持:通过 OAuth 自动限定在单一 Xero 组织内,权限边界清晰
潜在缺点与局限性
- 第三方依赖:核心功能依赖 ClawLink 服务可用性,若 ClawLink 中断则工具失效
- 网络要求:所有 API 调用需实时联网,无法离线操作
- OAuth 范围限制:只能访问用户授权时勾选的 Xero 组织,切换组织需重新授权
- 预览确认流程:写操作需先调用
clawlink_preview_tool,增加交互步骤 - 错误信息依赖 Xero API:复杂验证错误(如税务计算)需对照 Xero 后台核对
适合人群
- 中小企业主和财务人员,希望在不打开 Xero 网页的情况下快速处理发票
- 使用 OpenClaw 的自动化工作流构建者,需要将会计数据集成到聊天机器人
- 需要批量查询发票、联系人或生成会计报告的数据分析场景
- 临时性会计操作,如出差途中快速查看账单状态或记录付款
常规风险
- 财务数据敏感性:发票、支付记录涉及真实资金流动,写操作前务必二次确认金额、账户和日期
- 作废与删除不可逆:
xero_void_invoice和xero_delete_invoice会影响财务报表,需明确用户意图 - 汇率与税务准确性:多币种发票的汇率计算以 Xero 后台为准,工具端不负责验证
- OAuth 令牌安全:虽由 ClawLink 托管,但用户仍需保护好 OpenClaw 会话,防止未授权访问
- API 速率限制:高频调用可能触发 Xero API 限流,批量操作建议分时段执行