Openclaw용 safeclaw-proxy

안전한 AI 에이전트 모델 라우팅을 위해 SafeClaw 보안 proxy를 설치, 구성 및 검증하는 자동화 도구입니다.

aceteam-ai
v1.0.0
Apr 17, 2026
0
640
0

설치 및 다운로드

1. ClawHub CLI

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

npx clawhub@latest install safeclaw-proxy

2. 수동 설치

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

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

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

3. 프롬프트 설치

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

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

다운로드를 원하시나요?

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

safeclaw-proxy란 무엇인가요?

이 skill은 Openclaw Skills를 사용하는 개발자가 LLM 트래픽을 모니터링하고 보호하기 위한 필수 구성 요소인 SafeClaw 보안 proxy를 위한 자동화된 엔드투엔드 설정을 제공합니다. 환경 감지, Docker 또는 Podman을 통한 컨테이너 배포, 다양한 에이전트 모드를 위한 자동 라우팅 재구성을 처리합니다.

모델 호출을 로컬 또는 호스팅된 proxy를 통해 전달함으로써 사용자는 전용 대시보드를 통해 AI 상호작용에 대한 완전한 가시성을 확보하는 동시에 보안 가드레일을 적용할 수 있습니다. 이 skill은 게이트웨이, 에이전트 모델 파일 및 shell 환경에 대한 구성 패치를 지능적으로 관리하여 보안이 귀하의 전문적인 Openclaw Skills 개발 워크플로우에 원활하게 통합되도록 합니다.

safeclaw-proxy 활용 사례

  • LLM 트래픽 모니터링 및 감사를 위한 로컬 보안 proxy 설정.
  • 원격 호스팅된 SafeClaw 인스턴스를 통한 Openclaw Skills 모델 트래픽 라우팅.
  • 모니터링 대시보드에 특정 모델 호출이 표시되지 않는 이유 디버깅.
  • Python 3.12 및 uv 패키지 관리자와 같은 필수 구성 요소의 자동 설치.
  • 잠재적으로 유해한 AI 모델 요청에 대한 실시간 보안 차단 시행.

safeclaw-proxy 작동 원리

  1. 현재 환경을 검사하여 Openclaw Skills가 게이트웨이 구성, 에이전트 모델 파일 또는 shell 변수를 통해 트래픽을 라우팅하는지 확인합니다.
  2. localhost 네트워크 권한 및 상승된 실행 기능을 확인하기 위해 사전 비행 검사를 수행합니다.
  3. Docker 또는 Podman을 사용하여 SafeClaw proxy 컨테이너를 배포하며, 필요한 경우 네이티브 Python 설치로 자동 폴백합니다.
  4. 공급자 설정을 패치하거나 agents.json 파일을 편집하여 새 proxy URL을 가리키도록 라우팅 경로를 구성합니다.
  5. 상태 확인 및 고의적인 보안 트리거 테스트 호출을 실행하여 트래픽이 올바르게 가로채지고 기록되는지 확인합니다.

safeclaw-proxy 설정 가이드

Openclaw Skills 환경 내에서 설정을 시작하려면 활성 세션과 컨테이너 관리에 필요한 권한이 있는지 확인하십시오.

컨테이너 배포

이 skill은 Docker 또는 Podman을 통한 실행을 선호합니다:

docker run -d --name safeclaw-proxy -p 8899:8899 ghcr.io/aceteam-ai/aep-proxy:latest

수동 설치 폴백

컨테이너 런타임을 사용할 수 없는 경우, 이 skill은 로컬 설치를 시도합니다:

uv pip install aceteam-aep[all]
aceteam-aep proxy --port 8899 > /dev/null 2>&1 &

safeclaw-proxy 데이터 스키마 및 분류 체계

이 skill은 Openclaw Skills 내에서 올바른 라우팅을 보장하기 위해 여러 데이터 구조를 관리하고 상호 작용합니다:

구성 요소 경로 / Key 설명
게이트웨이 구성 models.providers.<provider>.baseUrl 공급자를 로컬 proxy v1 엔드포인트로 다시 가리킵니다.
에이전트 메타데이터 ~/.openclaw/agents/main/agent/models.json 특정 에이전트 라우팅 구성을 업데이트합니다.
Shell 프로필 OPENAI_BASE_URL CLI로 시작된 프로세스에 대한 환경 변수를 구성합니다.
상태 API {PROXY_URL}/aep/api/state 현재 proxy 상태 및 호출 카운트 데이터를 검색합니다.

safeclaw-proxy 고급 기능

  • 포트 충돌을 방지하기 위해 8899에서 8895까지 순환하는 지능형 호스트 포트 폴백 로직.
  • macOS 및 Linux 시스템에서 Python 3.12 및 uv 설치를 처리하는 자동화된 종속성 관리.
  • 수정이 발생하기 전에 models.json의 자동 백업을 포함한 구성 보안 기능.
  • 다양한 Openclaw Skills 배포 아키텍처를 수용하기 위한 로컬 및 호스팅된 proxy 모드 지원.
  • 활성 보호 및 대시보드 로깅을 확인하기 위해 HTTP 상태 코드를 해석하는 통합 보안 테스트.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*