komafon/trust-openclaw

trust-openclaw은(는) 무엇을 하나요?

OpenClaw TypeScript 에이전트에 감사 로깅, PII 토큰화, 동의 게이팅, 프롬프트 인젝션 탐지를 추가하여 EU AI Act 규정을 준수할 수 있도록 지원합니다.

개요

이 스킬은 OpenClaw 에이전트가 EU AI Act의 요구사항을 충족하도록 돕습니다. 주요 기능은 다음과 같습니다:

• 감사 로깅 (Audit Logging): 모든 에이전트 상호작용을 기록하여 규제 보고에 활용합니다.
• PII 토큰화 (PII Tokenization): 사용자 개인 식별 정보를 자동으로 감지하고 토큰화하여 데이터 보호를 강화합니다.
• 동의 게이팅 (Consent Gating): 사용자 동의가 필요한 작업을 관리하고 동의 여부를 확인합니다.
• 프롬프트 인젝션 탐지 (Prompt Injection Detection): 악성 프롬프트 인젝션 공격을 실시간으로 탐지하고 차단합니다.

지원 플랫폼

이 스킬은 OpenClaw TypeScript 에이전트를 위해 설계되었습니다.

설치 및 설정

1. 프로젝트에 스킬을 추가합니다:

npm install komafon/trust-openclaw

2. OpenClaw 설정 파일에 스킬을 등록합니다:

import { TrustOpenClaw } from 'komafon/trust-openclaw';

const trust = new TrustOpenClaw({
  auditLogging: {
    enabled: true,
    storage: 'database', // 또는 'file', 'console'
  },
  piiTokenization: {
    enabled: true,
    patterns: ['email', 'phone', 'ssn'],
  },
  consentGating: {
    enabled: true,
    storage: 'redis',
  },
  promptInjectionDetection: {
    enabled: true,
    sensitivity: 'high',
  },
});

// 에이전트에 적용
export const agent = createOpenClawAgent({
  skills: [trust],
});

사용 방법

감사 로그 확인

감사 로그는 설정된 저장소에 자동으로 기록됩니다. 로그를 검색하려면:

const logs = await trust.getAuditLogs({
  from: new Date('2025-01-01'),
  to: new Date('2025-12-31'),
  userId: 'user123',
});

동의 관리

사용자 동의를 확인하거나 요청합니다:

const hasConsent = await trust.checkConsent('user123', 'data-processing');
if (!hasConsent) {
  await trust.requestConsent('user123', {
    purpose: '데이터 처리',
    description: '사용자 데이터를 처리하는 데 동의합니다.',
  });
}

프롬프트 인젝션 탐지

입력 프롬프트를 검사합니다:

const isSafe = await trust.validatePrompt(userInput);
if (!isSafe) {
  console.warn('프롬프트 인젝션 감지됨');
  // 적절한 조치 수행
}

설정 옵션

옵션	타입	기본값	설명
auditLogging.enabled	boolean	true	감사 로깅 활성화 여부
auditLogging.storage	string	'database'	로그 저장소 유형
piiTokenization.enabled	boolean	true	PII 토큰화 활성화 여부
piiTokenization.patterns	string[]	['email', 'phone']	감지할 PII 패턴 목록
consentGating.enabled	boolean	true	동의 게이팅 활성화 여부
promptInjectionDetection.enabled	boolean	true	프롬프트 인젝션 탐지 활성화 여부
promptInjectionDetection.sensitivity	string	'medium'	탐지 민감도 (low, medium, high)

라이선스

MIT