axonflow-openclaw-plugin은(는) 무엇을 하나요?
OpenClaw 에이전트를 위한 AxonFlow 거버넌스 — 위험한 도구 차단, MCP 접근 제어, 프로덕션 에이전트 워크플로우를 위한 감사 추적 유지
개요
이 플러그인은 OpenClaw 에이전트 프레임워크에 AxonFlow의 거버넌스 기능을 추가합니다. 에이전트가 수행할 수 있는 작업을 정책 기반으로 제어하여, 프로덕션 환경에서 안전하게 운영될 수 있도록 합니다.
주요 기능
- 도구 거버넌스: 위험한 도구(파일 시스템 수정, 데이터베이스 쓰기, 외부 API 호출 등)에 대한 접근 제어
- MCP 접근 제어: MCP 서버 엔드포인트에 대한 화이트리스트/블랙리스트 구성
- 감사 추적: 모든 에이전트 작업에 대한 상세한 로그 생성 (규정 준수 및 디버깅 용도)
- 정책 기반 설정: YAML 파일을 통한 간편한 정책 구성
설치
pip install axonflow-openclaw-plugin
또는 프로젝트의 requirements.txt에 추가:
axonflow-openclaw-plugin>=0.1.0
설정
openclaw_config.yaml 파일에 정책을 정의합니다:
governance:
tools:
blacklist:
- "filesystem.write"
- "database.execute"
- "shell.exec"
whitelist:
- "filesystem.read"
- "database.query"
- "search.web"
mcp:
allowed_endpoints:
- "https://api.example.com/mcp/v1"
denied_endpoints:
- "https://malicious-endpoint.com"
audit:
enabled: true
log_level: "info"
output: "stdout"
사용 방법
OpenClaw 에이전트를 시작할 때 플러그인을 활성화합니다:
openclaw --plugin axonflow-openclaw-plugin --config openclaw_config.yaml
프로그래매틱 방식:
from openclaw import Agent
from axonflow_openclaw_plugin import AxonFlowGovernance
governance = AxonFlowGovernance("openclaw_config.yaml")
agent = Agent(plugins=[governance])
agent.run("데이터 분석 수행")
정책 예시
모든 쓰기 작업 차단
governance:
tools:
blacklist:
- "*.write"
- "*.delete"
특정 MCP 엔드포인트만 허용
governance:
mcp:
allowed_endpoints:
- "https://internal-api.company.com/mcp"
로그 및 감사
모든 거버넌스 결정은 상세히 기록됩니다:
2025-03-15 10:30:45 INFO [AxonFlow] 도구 차단됨: filesystem.write (정책: blacklist)
2025-03-15 10:30:46 INFO [AxonFlow] MCP 접근 허용됨: https://api.example.com/mcp/v1
지원
라이선스
MIT