Xero：自动化云端会计和发票管理 - Openclaw Skills

什么是 Xero？

Xero 技能是专为 AI 智能体设计的强大集成功能，旨在与 Xero 云端会计平台直接交互。它为智能体提供了一种结构化方式，通过 Xero API 管理关键财务数据，包括联系人、发票和银彳交易。通过利用 Openclaw Skills，开发人员可以弥合 AI 驱动的自动化与专业会计软件之间的鸿沟，实现无需人工干预的财务管理和实时数据检索。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mrgoodb/xero

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install xero

2. 手动安装

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

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

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

3. 提示词安装

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

请帮我使用 Clawhub 安装 xero。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Xero 应用场景

• 根据项目完成数据自动创建客户发票 (ACCREC)。
• 定期获取并汇总损益表，以便向利益相关者更新信息。
• 在外部数据库与 Xero 会计环境之间同步联系人信息。
• 坚控并列出最近的银彳交易，以便进行对账。

Xero 工作原理

1. AI 智能体使用 Bearer 令牌和特定的租户 ID (Tenant ID) 向 Xero API 进行身份验证。
2. 触发命令后，智能体向相关的 Xero 会计 API 端点发起安全的 HTTPS 请求。
3. 智能体处理来自 Xero 的 JSON 响应，例如联系人列表或财务报表。
4. 对于创建发票等写入操作，智能体将交易数据格式化为所需的 JSON 结构并提交给 Xero。

Xero 配置指南

要开始使用此技能，您需要使用 Xero API 凭据配置环境：

export XERO_ACCESS_TOKEN="your_access_token_here"
export XERO_TENANT_ID="your_tenant_id_here"

Xero 数据架构与分类体系

该技能与 Xero 会计 API v2.0 模式交互。关键数据实体包括：

实体	描述	主要字段
联系人	客户和供应商记录	ContactID, Name, EmailAddress, ContactStatus
发票	销售和采购记录	InvoiceID, Type (ACCREC/ACCPAY), Contact, LineItems, Date, DueDate
银彳交易	银彳流水记录	BankTransactionID, Type, Contact, LineItems, Total
报表	财务绩效数据	ProfitAndLoss, DateRange, Summary Rows

name: xero
description: Manage Xero accounting - invoices, contacts, bank transactions, and reports via Xero API.
metadata: {"clawdbot":{"emoji":"??","requires":{"env":["XERO_ACCESS_TOKEN","XERO_TENANT_ID"]}}}

Xero

Cloud accounting platform.

Environment

export XERO_ACCESS_TOKEN="xxxxxxxxxx"
export XERO_TENANT_ID="xxxxxxxxxx"

List Contacts

curl "https://api.xero.com/api.xro/2.0/Contacts" r
  -H "Authorization: Bearer $XERO_ACCESS_TOKEN" r
  -H "Xero-Tenant-Id: $XERO_TENANT_ID" r
  -H "Accept: application/json"

Create Invoice

curl -X POST "https://api.xero.com/api.xro/2.0/Invoices" r
  -H "Authorization: Bearer $XERO_ACCESS_TOKEN" r
  -H "Xero-Tenant-Id: $XERO_TENANT_ID" r
  -H "Content-Type: application/json" r
  -d '{
    "Invoices": [{
      "Type": "ACCREC",
      "Contact": {"ContactID": "xxxxx"},
      "LineItems": [{"Description": "Consulting", "Quantity": 1, "UnitAmount": 500}],
      "Date": "2024-01-30",
      "DueDate": "2024-02-28"
    }]
  }'

List Invoices

curl "https://api.xero.com/api.xro/2.0/Invoices" r
  -H "Authorization: Bearer $XERO_ACCESS_TOKEN" r
  -H "Xero-Tenant-Id: $XERO_TENANT_ID" r
  -H "Accept: application/json"

Get Bank Transactions

curl "https://api.xero.com/api.xro/2.0/BankTransactions" r
  -H "Authorization: Bearer $XERO_ACCESS_TOKEN" r
  -H "Xero-Tenant-Id: $XERO_TENANT_ID"

Get Profit & Loss Report

curl "https://api.xero.com/api.xro/2.0/Reports/ProfitAndLoss?fromDate=2024-01-01&toDate=2024-12-31" r
  -H "Authorization: Bearer $XERO_ACCESS_TOKEN" r
  -H "Xero-Tenant-Id: $XERO_TENANT_ID"

Links

• Dashboard: https://go.xero.com
• Docs: https://developer.xero.com/documentation/api/accounting/overview