开源中国2026년 9월 20일 23:44중국어 → 한국어

OpenAgent v2.93, Agent Hub·권한·감사 로그 추가

단일 바이너리 자체 호스팅 AI Agent 플랫폼 OpenAgent v2.93이 Agent Hub와 Casbin 도구 권한, 감사 로그를 추가했다.

중국어 원문을 AI로 번역했습니다. 고유명사와 수치는 원문 표기를 우선하며, 중요한 판단에는 아래 출처 원문을 함께 확인하세요.

OpenAgent가 최근 v2.93.0을 출시했다. 이는 자체 호스팅(self-hosted) AI Agent 플랫폼으로, Casbin 오픈소스 커뮤니티가 유지 관리하며 Go + React로 작성되었고 Apache 2.0 라이선스로 오픈소스화되어 현재 GitHub에서 5.6k star, 658 fork를 기록하고 있다.

프로젝트 포지셔닝

OpenAgent는 코드로 오케스트레이션해야 하는 Agent 프레임워크가 아니라, 배포만 하면 바로 사용할 수 있는 플랫폼이다. 모델 API Key를 설정한 뒤에는 비기술자도 웹 인터페이스를 통해 사용할 수 있다. 기능적으로는 다중 모델 연동, RAG 지식베이스, 자율 Agent 루프, BPMN 시각화 워크플로, 예약 작업, 멀티테넌시, SSO, 감사 로그와 사용량·비용 통계를 동시에 아우른다.

배포 방식은 단일 실행 파일이다. 프런트엔드 빌드 산출물은 Go embed를 통해 바이너리 안에 패키징되고, 기본 정적 리소스도 함께 내장되므로 외부 네트워크가 없고 CDN에 접근할 수 없는 내부망과 에어갭(air-gapped) 환경에서도 정상적으로 동작한다. 크로스 컴파일은 Linux의 amd64 / arm64 / riscv64, 그리고 macOS와 Windows의 x86_64 / arm64를 지원한다. Windows에서는 네이티브로 실행되며 WSL이나 Docker가 필요 없다.

macOS / Linux curl -fsSL https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.sh | bash # Windows PowerShell irm https://raw.githubusercontent.com/the-open-agent/openagent/master/scripts/install.ps1 | iex

실행 후 http://localhost:14000 에 접속하면 되며, SQLite와 예시 데이터가 내장되어 있어 데이터베이스를 미리 준비할 필요가 없다. 저장소에는 docker-compose.yml도 제공된다.

주요 기능

모델 연동 : OpenAI, Azure OpenAI, Anthropic Claude, Google Gemini, DeepSeek, 통이치엔원(通义千问), 더우바오(豆包), Kimi, 즈푸 GLM(智谱 GLM), Mistral, Grok, Amazon Bedrock, OpenRouter, Ollama 등 30여 개 모델 제공사를 지원하며, 세션별로 전환할 수 있다.

Agent 도구 체인 : 브라우저 조작(chromedp 또는 공식 Chrome 확장 프로그램 두 가지 모드), Windows UI Automation, Shell 실행, Office 문서 읽기·쓰기(PPTX 템플릿 채우기와 이미지 교체 포함), 웹 검색과 크롤링, 그리고 완전한 MCP 지원(SSE / Stdio / StreamableHTTP 세 가지 전송). 매 도구 호출의 파라미터와 반환값은 인터페이스에서 단계별로 펼쳐 볼 수 있다.

RAG 지식베이스 : PDF, Word, Excel 등 문서 업로드를 지원하고 자동으로 청킹, 벡터화, 인덱싱한다. 임베딩 모델은 OpenAI, Azure, Gemini, Qwen, Cohere, Jina, HuggingFace 및 로컬 모델을 선택할 수 있다. 지식베이스는 서로 격리되며 세션별 또는 애플리케이션별로 할당할 수 있다.

메시지 채널 : 동일한 Agent가 Discord, Slack, Telegram, WhatsApp, 위챗 공식 계정, X 다이렉트 메시지, Threads, Snapchat, Facebook Messenger 및 범용 HTTP Webhook에 동시에 연동될 수 있다.

대외 인터페이스 : 설정이 완료된 Agent는 표준 OpenAI 호환 엔드포인트(/v1/chat/completions)로 외부에 서비스를 제공할 수 있어, 외부 클라이언트가 개조 없이 호출할 수 있으며 동시에 모든 대화는 여전히 로그에 기록된다.

관리 백엔드 : 애플리케이션, 사용자, 모델 차원의 Token 및 비용 통계, 활동 모니터링(성공률, 오류율, 작업 유형 분포), 도구 일괄 관리, 완전한 요청 / 응답 로그, 그리고 OIDC / OAuth2 / LDAP / SAML 싱글 사인온과 멀티테넌시 격리를 제공한다.

최근 업데이트

Agent Hub : 코드 호스팅 플랫폼의 형태를 참조하여 Agent에 Star / Watch / Fork, Issue, 리치 텍스트 댓글, 그리고 Insights 패널(활동도, 기여자, 방문 트래픽, 질문 키워드 워드클라우드, 비용의 다섯 가지 차원)을 추가했다. 사용자는 다른 사람이 게시한 Agent를 Fork한 뒤 계속 수정할 수 있고, Agent 상세 페이지에 내장된 대화 상자에서 바로 시험해 볼 수 있다. Hub에 등록하려면 게시 상태 권한과 자격 검사를 통과해야 한다.

도구 권한 엔진 : 플랫폼 자체 코드에 의존하지 않는 독립적인 guard 모듈을 새로 추가하여 다른 Agent 프로젝트에서도 재사용할 수 있다. 권한 판정은 allow / ask / deny의 3가지 상태이며, 그중 ask는 대역 외(out-of-band) 승인이 필요함을 의미한다. 규칙은 「호출자 / 도구명 / 능력 범주 / 리소스」의 4-튜플로 매칭하며, 와일드카드, 역할 상속과 우선순위 정렬을 지원하고, 하부는 Casbin으로 구현된다. 함께 제공되는 shellcmd 모듈은 전체 명령줄에서 실제로 실행될 프로그램명을 파싱해낼 수 있으며, 파이프, 서브셸, sudo/env/xargs 등의 래핑, sh -c 내용, find -exec 모두 전개된다. 확정할 수 없을 때는 불확정 표시를 반환하여 호출자가 실패 시 차단(fail closed) 방식으로 처리하도록 한다. 현재 엔진과 백엔드 정책 관리 페이지는 이미 메인 브랜치에 병합되었으나, 아직 도구 실행 경로에는 연결되지 않았다.

구조화 감사 로그 : 매 도구 호출마다 한 줄의 JSON을 출력하며, 세션별로 파일을 나누어 바이너리와 같은 레벨의 디렉터리에 저장한다(OPENAGENT_AUDIT_DIR로 재정의 가능). 외부 도구는 읽기 전용으로 추적하기만 하면 데이터베이스에 접근하지 않고도 모든 도구 활동을 얻을 수 있다. 쓰기는 백그라운드 비동기로 이루어지며, 큐가 가득 차면 도구 호출을 차단하지 않고 이벤트를 폐기한다.

마이그레이션 도구 : OpenClaw 등 Agent로부터의 전체 마이그레이션을 지원하며, 해당 구성 디렉터리, ZIP 패키지 또는 단일 구성 파일을 인식하여 Agent, 스킬(SKILL.md), MCP Server, 모델 제공사, 채널 설정 및 과거 세션 기록을 가져올 수 있다. 마이그레이션은 먼저 계획을 생성한 뒤 실행하는 방식을 채택하며, 이름 중복 충돌 시 건너뛰기, 덮어쓰기 또는 이름 변경을 선택할 수 있다.

인간 교정 경험 라이브러리 : 사용자가 AI의 답변을 직접 수정하여 하나의 경험 기록으로 저장할 수 있으며, 원래 질문, 원래 답변, 수정 후 답변, 수정 이유와 분류(사실 / 스타일 / 형식 / 경계)를 포함한다. 이후 생성 전에 벡터 유사도로 회수하며, 유사도가 0.95를 초과하면 승인된 답변으로 직접 사용하고, 0.75를 초과하면 예시로 컨텍스트에 들어간다. 특정 수정을 전역 규칙으로 승격할 수도 있다.

모델 목록과 과금 : 최근 몇 개 버전에서 실리콘플로(硅基流动, DeepSeek-V4 포함), 즈푸 GLM, Kimi, 알리 바이리엔 Qwen, 화산엔진 더우바오의 사용 가능한 모델을 갱신하고, APIMart 제공사를 새로 추가했으며, 제공사 신규 생성 시 현재 유효한 모델이 기본 선택된다. 과금은 입력과 출력 Token을 분리하여 계산하도록 수정되었다.

그 밖의 업데이트로는 사용자 알림 수신함, 채팅 입력창에서 파일과 이미지 직접 붙여넣기 지원, PDF와 Office 온라인 미리보기 수정 등이 있다.