Openclaw용 Paperless API Skill

강력한 API 통합을 통해 Paperless-ngx 인스턴스의 문서 업로드 및 분류를 자동화하세요.

thistine
v0.1.0
Apr 6, 2026
0
714
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install paperless-api

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 paperless-api 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Paperless API Skill란 무엇인가요?

Paperless API skill은 Openclaw Skills 생태계를 위해 설계된 특수 통합 도구로, 사용자가 프로그래밍 방식으로 Paperless-ngx와 상호 작용할 수 있게 합니다. 로컬 문서 저장소와 자체 호스팅 관리 시스템 사이의 격차를 해소하여, AI agent 또는 스크립트를 통해 송장, 계약서, 개인 기록을 직접 원활하게 전송할 수 있습니다. 이 skill을 활용하면 개발자는 수동 입력을 줄이고 일관된 구성을 보장하는 효율적인 문서 파이프라인을 구축할 수 있습니다.

Paperless API Skill 활용 사례

  • 스캔된 PDF 송장을 자체 호스팅된 Paperless-ngx 인스턴스로 자동 업로드.
  • 들어오는 작업 계약서에 특정 태그 및 문서 유형을 자동으로 분류.
  • 로컬 파일 경로를 중앙 문서 데이터베이스에 연결하여 디지털 아카이빙 워크플로우 간소화.
  • Openclaw Skills를 사용하여 문서 관리를 AI 기반 생산성 파이프라인으로 통합.

Paperless API Skill 작동 원리

  1. 사용자가 Paperless-ngx 호스트 URL과 보안 API key를 제공하여 연결을 설정합니다.
  2. 이 skill은 로컬 파일 경로와 함께 제목, 태그, 문서 유형과 같은 선택적 메타데이터를 허용합니다.
  3. 이 도구는 제공된 자격 증명을 사용하여 Paperless-ngx REST API에 인증된 요청을 시작합니다.
  4. 파일이 업로드되고, OCR 엔진(서버에서 활성화된 경우)에 의해 처리되며, Paperless-ngx 대시보드 내에서 자동으로 분류됩니다.

Paperless API Skill 설정 가이드

Openclaw Skills 환경에서 이 skill을 사용하려면 Paperless-ngx 인스턴스 자격 증명이 준비되어 있는지 확인하십시오. 호스트 URL과 사용자 설정에서 생성된 API key가 필요합니다.

# 매개변수와 함께 업로드 스크립트 실행
python scripts/upload_document.py \
  --file_path /path/to/my_document.pdf \
  --host http://your-paperless-url:8000 \
  --api_key your_api_key_here \
  --title "Annual Report" \
  --tags "finance,report" \
  --document_type "Report"

Paperless API Skill 데이터 스키마 및 분류 체계

이 skill은 Paperless-ngx 데이터 모델과 상호 작용하여 업로드 과정에서 메타데이터가 올바르게 매핑되도록 합니다. 다음 필드가 사용됩니다:

매개변수 유형 설명
file_path String 업로드할 로컬 파일의 절대 경로.
host String Paperless-ngx 인스턴스의 기본 URL.
api_key String API 액세스를 위한 인증 토큰.
title String (선택 사항) 문서 기록의 사용자 지정 제목.
tags String (선택 사항) 적용할 쉼표로 구분된 레이블 목록.
document_type String (선택 사항) 파일의 특정 카테고리.

Paperless API Skill 고급 기능

  • 세밀한 문서 검색 및 구성을 위한 사용자 지정 메타데이터 태깅.
  • 기존 Openclaw Skills 자동화 후크와 완벽하게 호환.
  • 높은 보관 표준을 유지하기 위한 사용자 지정 문서 유형 지원.
  • 일괄 처리 및 다중 문서 업로드를 위한 확장 가능한 스크립트 아키텍처.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*