1688 Finance Tax

v0.1.0

财税税负测算专家技能。帮助用户计算商品含税定价、评估整体税负。支持增值税测算、四税联算（增值税+附加税+印花税+所得税）、整体税负分析等场景。用户提到税务、税率、含税定价、税负、增值税、所得税、发票、纳税人等测算问题时使用。

⭐ 0· 83·0 current·0 all-time

by@1688aiinfra

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for 1688aiinfra/1688-finance-tax.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "1688 Finance Tax" (1688aiinfra/1688-finance-tax) from ClawHub.
Skill page: https://clawhub.ai/1688aiinfra/1688-finance-tax
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required binaries: python3
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install 1688-finance-tax

ClawHub CLI

Package manager switcher

npx clawhub@latest install 1688-finance-tax

Security Scan

Capability signals

CryptoCan make purchasesRequires sensitive credentials

These labels describe what authority the skill may exercise. They are separate from suspicious or malicious moderation verdicts.

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

技能声明为财税测算，代码实现包含多个测算命令（calc-vat / calc-all-taxes / calc-overall）、参数校验和对外 HTTP 调用到 skills-gateway.1688.com，所需主凭据为 FINANCE_TAX_API_KEY 用于签名请求，这与技能目的高度一致。仅要求 python3，合理且必要。

ℹ

Instruction Scope

SKILL.md 指示通过 python3 cli.py <command> 调用并要求先阅读 references 文档，运行时会向 1688 的 skills-gateway 发起 POST/GET 请求并返回业务结果，说明和代码行为基本一致。值得注意的是：代码在运行时会尝试读取两类额外来源以获取 AK（环境变量 FINANCE_TAX_API_KEY 优先，其次为 OpenClaw 配置文件 OPENCLAW_CONFIG_PATH 中的条目），并且 tracker 模块会在加载时解析项目根目录的 .env 文件并注入环境变量（不覆盖已存在的环境变量）。这些文件读取行为没有在 SKILL.md 的显式“执行前置”中列出，属于实现细节，应让用户知晓。

✓

Install Mechanism

无安装脚本（instruction-only 元数据），但包包含 Python 脚本，运行时在本地执行这些文件；没有从不受信任的 URL 下载、也未修改系统位置或安装外部二进制。无需额外包管理器或远程提取，安装风险低。

ℹ

Credentials

主凭据 FINANCE_TAX_API_KEY 与调用网关并对请求签名的需求一致且必要。代码还会可选读取 FINANCE_TAX_USER_ID（ENV_USER_ID_NAME）和本地 .env / OPENCLAW_CONFIG_PATH 作为回退来源，这些是合理的实现便利但未在 SKILL.md 显式声明（FINANCE_TAX_USER_ID 未列为必需，仅为可选）。读取 OPENCLAW_CONFIG_PATH（用户主目录下的 openclaw.json）可能访问到本地网关配置文件以获取本技能的 AK 条目；这是功能性方便，但用户应确认该配置文件中不包含他们不愿外泄的其它敏感项。

✓

Persistence & Privilege

技能未请求 always:true，也不修改其他技能或系统级配置。它会在每次命令执行后向 skills-gateway 上报埋点（report_skill_usage），但上报失败被静默忽略；这是正常的遥测行为，权限范围限于网络请求并使用同一 AK 签名。

Assessment

要点与建议： - 功能简介：此技能确实实现了增值税/四税联算/整体税负测算，会将用户提供的参数打包、用 FINANCE_TAX_API_KEY 对请求签名后向 https://skills-gateway.1688.com 发起请求并返回格式化的中文结果。 - 必要凭据：技能需要提供 FINANCE_TAX_API_KEY（SKILL.md 的 primaryEnv），这是用于 HMAC 签名的访问凭据。仅在信任该网关并信任所提供 AK 时才配置。技能可选读取 FINANCE_TAX_USER_ID（非必需）以附加用户维度。 - 本地文件访问：实现会尝试读取两个本地位置作为回退：1) OpenClaw 配置文件 (OPENCLAW_CONFIG_PATH，默认 ~/.openclaw/openclaw.json) 以查找本技能的 apiKey 条目；2) 项目根目录的 .env 文件（tracker 模块在加载时解析并注入环境变量，但不会覆盖已存在的环境变量）。如果这些文件中包含其它敏感信息，建议在运行或安装前审查或移除不必要的条目。 - 网络与遥测：每次命令执行会向 skills-gateway 发起业务请求并上报一次埋点（/api/reportSkillsUsage/1.0.0）。这些行为是透明且与技能目的相关的，但会产生外部网络请求并带上签名的 AK，因此请在受信网络环境下使用。 - 若你担心隐私/泄露：不要将其他服务的密钥写入同一 .env 或 openclaw.json 中；仅为此技能生成并提供必要的 FINANCE_TAX_API_KEY；如不想读取本地文件，可在运行环境中明确设置环境变量并确保 openclaw.json/.env 不含敏感条目。 - 额外建议：如想进一步降低风险，可在隔离环境中运行或审计传出的请求（URL / 请求体中不应包含除测算参数外的本地文件内容）。

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

💰 Clawdis

Binspython3

Primary envFINANCE_TAX_API_KEY

latestvk974c62bbc26zgyh1pxd7zfqyh85c6vy

83downloads

0stars

1versions

Updated 4d ago

v0.1.0

MIT-0

财税税负测算

统一入口：python3 {baseDir}/cli.py <command> [options]

命令速查

命令	说明	示例
`calc-vat`	商品含税定价（仅增值税）	`cli.py calc-vat --taxpayer-type SMALL_SCALE_TAXPAYER --invoice-requirement ORDINARY_INVOICE --invoice-tax-rate RATE_3_PERCENT --original-price 1000 --upstream-cost 600 --calculation-mode EXPECTED_PROFIT --expected-profit 400`
`calc-all-taxes`	商品含税定价（四税联算）	`cli.py calc-all-taxes --taxpayer-type SMALL_SCALE_TAXPAYER ... --registration-type LIMITED_COMPANY --city-tax-rate 7% --is-small-profit-enterprise true`
`calc-overall`	整体税负测算	`cli.py calc-overall --taxpayer-type SMALL_SCALE_TAXPAYER --annual-sales-amount 300 --annual-profit-amount 50 --registration-type LIMITED_COMPANY --city-tax-rate 7% --is-small-profit-enterprise true`
`configure`	配置 AK	`cli.py configure YOUR_AK`

所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}}

展示时直接输出 markdown 字段，Agent 分析追加在后面，不得混入其中。

工具码与命令映射

ClawHub 工具码	CLI 命令	说明
`ai_tax_calc_vat`	`calc-vat`	商品含税定价（仅增值税）
`ai_tax_calc_all`	`calc-all-taxes`	商品含税定价（四税联算）
`ai_tax_calc_overall`	`calc-overall`	整体税负测算

测算类功能通过 ClawHub 工具码调用（与上表 CLI 对应）。

意图识别与文档索引

根据用户提问意图，跳转到对应的业务流程文档：

用户提问意图	对应文档
商品含税定价、增值税测算、加价点数、含税报价计算	references/tax-calculation.md
四税联算、增值税+附加税+印花税+所得税、综合含税定价	references/tax-calculation.md
整体税负、年度税负、年度税费总额、税负率、企业综合税务成本	references/tax-calculation.md

执行前置（首次命中能力时必须）

首次执行 calc-vat 前：先完整阅读 references/tax-calculation.md
首次执行 calc-all-taxes 前：先完整阅读 references/tax-calculation.md
首次执行 calc-overall 前：先完整阅读 references/tax-calculation.md
同一会话内后续重复调用同一能力可复用已加载知识；仅在规则冲突或文档更新时重读。

通用规则

执行任何业务前，完整阅读并遵守 references/common/common-rules.md。其中对 对客中文、不暴露请求、免责声明、数据验证 等为硬性要求。

异常处理

任何命令输出 success: false 时：

先输出 markdown 字段（已包含用户可读的错误描述）
再根据关键词追加引导：

markdown 关键词	Agent 额外动作
"AK 未配置"	输出下方 AK 引导话术
"参数错误" / "400"	检查用户输入是否正确，引导修正
"限流" / "429"	建议用户等待 1-2 分钟后重试
"服务异常" / "500"	建议用户稍后重试
其他	仅输出 markdown 即可

AK 引导话术

"需要先配置 AK 才能使用财税测算功能。请登录 ClawHub，点击右上角钥匙按钮获取 AK，然后告诉我：'我的AK是 xxx'"