FIND SAP API

提供命令行脚本，用 Playwright Chromium 及环境变量凭据登录 SAP Business Accelerator Hub，按 API ID 下载并校验 OpenAPI/EDMX 规范到 /usr/download，支持重试、规范导入项目分类和从 OpenAPI 生成后端脚手架；需在 OpenClaw 与 Python 3.10+ 下运行。

shenruiyang

热度 54.94

最近更新 2026-05-17 14:30:27

分类：开发依赖：联网浏览搜索 / 代码执行 / 读写文件 / 第三方 API应用场景：API 集成 / 代码生成 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add sap-bah-openapi-backend-openclaw

Metadata

name: sap-bah-openapi-backend
description: Reliable SAP Business Accelerator Hub API spec downloader for OpenClaw. Uses SAP_HUB_USERNAME and SAP_HUB_PASSWORD to log in through Playwright Chromium, downloads OpenAPI JSON/YAML and OData EDMX to /usr/download, validates payload signatures, and supports importing specs into APIConnectionToSAP categories.
metadata: {"openclaw":{"version":"1.1.0","requires":{"env":["SAP_HUB_USERNAME","SAP_HUB_PASSWORD"]},"os":["linux","darwin"],"default_output_dir":"/usr/download","browser":"chromium","entrypoint":"scripts/reliable_sap_hub_download.py"}}

SAP BAH OpenAPI Backend (OpenClaw Upload Package)

Purpose

Use this skill to reliably download SAP API specification files from hub.sap.com.

Authentication:

SAP_HUB_USERNAME
SAP_HUB_PASSWORD

Downloaded files are written to:

/usr/download/<API_ID>_openapi.json
/usr/download/<API_ID>_openapi.yaml
/usr/download/<API_ID>_odata.edmx

Prerequisites

Chromium available through Playwright.
Python 3.10+.
Python Playwright installed:

python3 -m pip install playwright
python3 -m playwright install chromium

Writable output directory /usr/download.

If needed:

sudo mkdir -p /usr/download
sudo chown "$USER":staff /usr/download

Maintain login credentials via environment variables:

export SAP_HUB_USERNAME='your_user'
export SAP_HUB_PASSWORD='your_password'

Security note:

Do not upload real credentials to ClawHub.
Maintain credentials only in the runtime environment.

How to start

Run from repository root:

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id WAREHOUSEORDER_0001

How to use

1) Download one or more API IDs

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id WAREHOUSEORDER_0001 \
  --api-id API_APAR_SEPA_MANDATE_SRV

2) Download from file list

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id-file /path/to/api_ids.txt

api_ids.txt example:

WAREHOUSEORDER_0001
API_APAR_SEPA_MANDATE_SRV
sap-s4-CE_EBPPPAYMENTREQUEST_0001-v1

3) Useful runtime options

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/reliable_sap_hub_download.py \
  --api-id WAREHOUSEORDER_0001 \
  --retries 4 \
  --timeout-seconds 90 \
  --json-report /usr/download/sap_download_report.json

4) Import downloaded files into project category

python3 Skills/sap-bah-openapi-backend-openclaw-upload-1.0.0/scripts/import_sap_hub_spec.py \
  --category AccountsReceivable \
  --pattern CONTRACTACCOUNT_0001 \
  --mode copy

Reliability behavior

The downloader script automatically:

In default env mode, starts with a clean temporary browser profile.
Uses Playwright Chromium.
Logs in using SAP_HUB_USERNAME and SAP_HUB_PASSWORD.
Downloads JSON/YAML/EDMX through Hub authenticated $value endpoints.
Retries transient failures.
Rejects OAuth/login HTML payloads.
Verifies expected OpenAPI/EDMX signatures before writing files.

Output contract

Exit code 0: all requested files downloaded and validated.
Exit code 2: partial/complete failures (see JSON report/stdout report).

Included files

scripts/reliable_sap_hub_download.py
scripts/import_sap_hub_spec.py
scripts/scaffold_backend_from_openapi.py
references/quickstart.md