109개의 실습 프로젝트를 담은 AI 에이전트 설계 오픈소스 도서.
한국어는 runchr 제공 번역입니다. 원문 README는 English tool page.
CowAgent
CowAgent는 가볍고 확장 가능한 개인 AI 어시스턴트이자 에이전트 하네스입니다. 작업을 계획하고, 도구와 스킬을 실행하며, 메모리와 지식을 구축합니다.
- Run
- pip install -U cowagent && cowagent
- Interface
- CLI, web, and IM channels (WeChat, Discord)
- Models
- OpenAI
프로젝트 README (번역)
GitHub ↗Written by the project's own authors, not by runchr. Snapshot taken 2026-10-30.
[English] | [ 中文 ] | [ 繁體中文 ] | [ 日本語 ]
CowAgent는 작업을 능동적으로 계획하고, 컴퓨터와 외부 서비스를 제어하며, Skill을 생성·실행하고, 개인 지식 베이스와 장기 기억을 구축하며, 멀티 에이전트 팀을 구성하고, 자기 진화를 통해 여러분과 함께 성장하는 오픈소스 슈퍼 AI 어시스턴트입니다 — Agent Harness 엔지니어링의 참조 구현입니다.
CowAgent는 가볍고 배포가 쉬우며 확장을 위해 설계되었습니다. 모든 주요 LLM 제공업체를 연결하고 개인 컴퓨터나 서버에서 24/7 실행할 수 있으며, 웹과 모든 주요 IM 플랫폼을 지원합니다.
🌐 웹사이트 ·
📖 문서 ·
🚀 빠른 시작 ·
🧩 Skill Hub ·
💻 다운로드 ·
☁️ 온라인 체험
🎬 데모
CowAgent-desktop-demo.mp4
🌟 주요 기능
기능
설명
계획
복잡한 작업을 분해하여 단계별로 실행하고, 목표에 도달할 때까지 도구를 반복 호출합니다
멀티 에이전트
각자 고유한 역할, 모델, 스킬, 지식을 가진 에이전트 팀을 구성하고 공유 대화 내에서 협업합니다
기억
3계층 아키텍처(컨텍스트 → 일일 → 핵심), 자동 Deep Dream 정제, 키워드 + 벡터 하이브리드 검색
지식
구조화된 지식을 Markdown 위키로 자동 큐레이션하고, 시각적 탐색이 가능한 진화하는 지식 그래프를 구축합니다
진화
Self-Evolution이 대화를 자동으로 검토하여 스킬을 개선하고, 미완료 작업을 후속 처리하며, 기억과 지식을 통합하여 일상적인 사용을 통해 성장합니다
스킬
Skill Hub, GitHub, ClawHub에서 원클릭 설치, 또는 자연어 대화로 커스텀 스킬 생성
도구
파일 I/O, 터미널, 브라우저, 스케줄러, 기억 검색, 웹 검색 등 10개 이상의 내장 도구 — 네이티브 MCP 통합 지원
채널
Web, WeChat, Feishu, DingTalk, WeCom, QQ, Official Accounts, Telegram, Slack과 통합
멀티모달
텍스트, 이미지, 음성, 파일에 대한 일급 지원 — 인식, 생성, 전달
모델
Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao 등 — Web 콘솔에서 원클릭으로 제공업체 전환
배포
원라인 설치 프로그램, 통합 Web 콘솔, 다양한 배포 모드(로컬, Docker, 서버)
🏗️ 아키텍처
CowAgent는 완전한 Agent Harness입니다: 메시지는 Channels를 통해 유입되고, Agent Core는 기억, 지식, 사용 가능한 도구와 스킬을 바탕으로 계획하고 추론하며, Models가 응답을 생성하여 원래 채널을 통해 다시 전송됩니다. 모든 계층은 분리되어 있으며 독립적으로 확장 가능합니다.
자세한 내용은 Architecture에서 확인하세요.
🚀 빠른 시작
원라인 설치 프로그램이 의존성, 구성, 시작을 처리합니다:
Linux / macOS:
bash <( curl -fsSL https://cdn.link-ai.tech/code/cow/run.sh )
Windows (PowerShell):
irm https: // cdn.link - ai.tech / code / cow / run.ps1 | iex
Docker:
curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml
docker compose up -d
시작 후 http://localhost:9899를 열어 Web 콘솔에 접속하세요 — 에이전트와 대화하고, 모델을 구성하고, 채널을 연결하고, 스킬을 설치하는 원스톱 허브입니다.
서버에 배포하시나요? config.json에서 web_host를 0.0.0.0으로 설정하여 외부에서 콘솔에 접근할 수 있게 하고, web_password를 설정하여 보호하세요. 방화벽이나 보안 그룹에서 포트 9899를 여는 것을 잊지 마세요.
📖 상세 가이드: 빠른 시작 · 소스에서 설치 · 업그레이드
설치 후 cow CLI로 서비스를 관리하세요:
cow start | stop | restart # 서비스 제어
cow status | logs # 상태 및 로그
cow update # 최신 코드 가져오기 및 재시작
cow skill install < name > # 스킬 설치
cow install-browser # 브라우저 자동화 설치
💻 데스크톱 클라이언트: CowAgent Desktop 클라이언트(macOS / Windows)를 다운로드하세요 — 백엔드가 번들로 제공되어 바로 사용할 수 있습니다.
👥 멀티 에이전트 팀
각자 고유한 기억, 역량, 지식, 워크스페이스를 가진 에이전트 팀을 만드세요. 각자는 자신의 도메인에 집중하거나, 공유 대화 내에서 협업하여 복잡한 작업을 함께 해결할 수 있습니다. 멀티 에이전트 팀은 Web, 데스크톱 클라이언트, IM 채널 통합에서 사용할 수 있습니다.
자세한 내용은 Agent Team을 참조하세요.
🤖 모델
CowAgent는 모든 주요 LLM 제공업체를 지원합니다. 채팅, 비전, 이미지 생성, ASR/TTS, 임베딩을 각각 다른 벤더로 라우팅할 수 있습니다. 제공업체는 Web 콘솔에서 직접 구성하므로 수동 파일 편집이 필요 없습니다.
제공업체
주요 모델
채팅
비전
이미지 생성
ASR
TTS
임베딩
DeepSeek
deepseek-flash (V4.1) / pro
✅
✅
Claude
claude-opus-5-5 / sonnet-5-5
✅
✅
OpenAI
gpt-6.1-terra / gpt-6.1-sol
✅
✅
✅
✅
✅
✅
Gemini
gemini-4-argon
✅
✅
✅
MiniMax
MiniMax-M3.1-Flash / M3
✅
✅
✅
✅
GLM
glm-5.3-flash, glm-5v-turbo
✅
✅
✅
✅
Qwen
qwen3.8-flash
✅
✅
✅
✅
✅
✅
Kimi
kimi-k3.1-pro / kimi-k3
✅
✅
Doubao
doubao-seed-2.1 series
✅
✅
✅
✅
ERNIE
ernie-5.1
✅
✅
MiMo
mimo-v2.6-pro / flash
✅
✅
✅
✅
LinkAI
100개 이상의 모델을 하나의 키로
✅
✅
✅
✅
✅
✅
커스텀
로컬 모델 / 서드파티 프록시
✅
각 제공업체에 대한 자세한 내용은 Models 개요를 참조하세요.
💬 채널
단일 Agent 인스턴스가 여러 채널을 병렬로 서비스할 수 있습니다. 대부분의 채널은 Web 콘솔에서 바로 온보딩할 수 있습니다.
채널
텍스트
이미지
파일
음성
그룹
Web Console (기본)
✅
✅
✅
✅
Telegram
✅
✅
✅
✅
✅
Slack
✅
✅
✅
✅
Discord
✅
✅
✅
✅
WeChat
✅
✅
✅
✅
Feishu / Lark
✅
✅
✅
✅
✅
DingTalk
✅
✅
✅
✅
✅
WeCom Bot
✅
✅
✅
✅
✅
QQ
✅
✅
✅
✅
WeCom App
✅
✅
✅
✅
WeChat Customer Service
✅
✅
✅
✅
WeChat Official Account
✅
✅
✅
설정 세부 사항은 Channels 개요를 참조하세요.
Web 콘솔은 기본 채널이자 모델, 채널, 스킬, 기억 등을 구성하는 통합 진입점입니다.
🧠 기억 & 지식 베이스
장기 기억은 3계층 아키텍처를 사용합니다: 대화 컨텍스트(단기) → 일일 기억(중기) → MEMORY.md(장기). 매일 밤 Deep Dream 패스가 흩어진 기억을 정제된 장기 항목과 서사형 저널로 증류합니다. Long-term Memory · Deep Dream을 참조하세요.
개인 지식 베이스는 시간 순서로 정리된 기억을 보완하여 구조화된 지식을 주제별로 조직합니다. Agent는 대화에서 가치 있는 정보를 자동으로 큐레이션하고 상호 참조와 인덱스를 유지하며, Web 콘솔은 인터랙티브 지식 그래프 뷰를 제공합니다. Personal Knowledge Base를 참조하세요.
장기 기억 · 3계층 아키텍처 + Deep Dream
지식 베이스 · 자동 큐레이션 Markdown 위키
🔧 도구 & 스킬
도구는 Agent가 시스템 리소스와 상호작용하는 데 사용하는 원자적 역량입니다. 스킬은 매니페스트 파일로 정의된 상위 수준 워크플로로, 여러 도구를 조합하여 복잡한 작업을 수행합니다.
도구 시스템
내장 도구는 파일 I/O(read / write / edit / ls), 터미널(bash), 파일 전송(send), 기억 검색(memory), 환경 변수(env_config), 웹 페칭(web_fetch), 스케줄링(scheduler), 웹 검색(web_search), 비전(vision), 브라우저 자동화(browser)를 포함합니다.
MCP 프로토콜은 Model Context Protocol 서버의 개방형 생태계를 통합합니다. mcp.json 하나면 충분합니다 — stdio / SSE 전송, 핫 리로드, 제로 코드 통합을 지원합니다.
자세히 알아보기: Tools 개요 · MCP 통합.
스킬 시스템
Skill Hub — 오픈 스킬 마켓플레이스: 탐색, 검색, 원클릭 설치
GitHub / ClawHub / URL 등 — 모든 소스에서 스킬 설치
대화형 제작 — skill-creator와의 대화를 통해 커스텀 스킬 생성; 모든 워크플로나 서드파티 API를 재사용 가능한 스킬로 전환
/skill list # 설치된 스킬 목록
/skill search < keyword > # 마켓플레이스 검색
/skill install < name > # 원클릭 설치
자세히 알아보기: Skills 개요 · 스킬 생성.
🏷 변경 로그
2026.10.30: v2.2.2 — 독립형 게스트 페이지 및 임베드 가능한 채팅 창, 커스텀 테마, 메인 모델의 네이티브 멀티모달 입력, 신규 모델, 도구·채널·보안 개선.
2026.10.14: v2.2.1 — Artifacts 센터 및 커스텀 메뉴, Agent Chat API 공개, 프롬프트 캐싱 및 컨텍스트 비용 절감, 도구·채널·보안 개선.
2026.09.30: v2.2.0 — 역량 센터, 멀티 에이전트 협업 개선, Web 콘솔 재구축, 모델 캐시 적중률 향상, 광범위한 안정성 및 보안 강화.
2026.09.14: v2.1.9 — 멀티 에이전트 협업 개선, 구성 가능한 모델 목록 및 다중 폴백 모델, 채널 통합 수정, 신규 이미지 모델(gpt-image-2.5), 음성 수정.
2026.09.10: v2.1.8 — 멀티 에이전트 팀, 수동 예약 작업 생성, 컨텍스트 사용량 시각화, 신규 모델 및 검색 제공업체, 워크스페이스 파일 편집.
2026.08.20: v2.1.7 — 다중 워크스페이스, 세션 수준 권한 모드, 작업 알림, 데스크톱 개선, 신규 모델 지원.
2026.08.12: v2.1.6 — 병렬 작업 위임을 위한 서브 에이전트, 추론 노력 설정, 플러그 가능한 기억 벡터 백엔드, 경험 및 보안 개선.
2026.07.29: v2.1.5 — 파일 미리보기가 있는 워크스페이스, 핵심 도구 개선(파일 검색, 쓰기 시 검증, 백그라운드 명령), 컨텍스트 압축(/compact), 원클릭 프롬프트 최적화, 보안 강화.
2026.07.20: v2.1.4 — 데스크톱 경험 개선, MCP OAuth 인증, Lark 채널 개선, 스케줄러 개선 및 데이터 백업, 신규 모델.
2026.07.08: v2.1.3 — macOS / Windows용 데스크톱 클라이언트, 지식 베이스 문서 관리, 온디맨드 MCP 도구 검색, 번체 중국어 지원, 신규 모델.
2026.06.18: v2.1.2 — Web 콘솔 업그레이드(예약 작업 관리, 지식 베이스 카테고리, 다중 커스텀 모델 제공업체), Self-Evolution 개선, 신규 모델(kimi-k2.7-code, glm-5.2), 보안 강화 및 개선.
2026.06.09: v2.1.1 — Self-Evolution, Web 콘솔 업그레이드(메시지 관리, 병렬 세션), 동시 호출을 지원하는 크로스 플랫폼 MCP 개선, 신규 모델(MiniMax-M3, qwen3.7-plus), Python 3.13 지원.
2026.06.01: v2.1.0 — 국제화, 신규 채널(Telegram, Discord, Slack, WeChat Customer Service), CLI 상호작용 업그레이드, 간소화된 원라인 설치, MCP Streamable HTTP 지원, 신규 모델(claude-opus-4-8, MiMo).
전체 이력: Release Notes
🤝 커뮤니티 & 지원
Discord 서버에 참여하여 질문하고, 스킬을 공유하고, 개발 소식을 팔로우하세요:
GitHub에 이슈를 제출하거나, 아래 QR 코드를 스캔하여 WeChat 그룹에 참여할 수도 있습니다:
🔗 관련 프로젝트
Cow Skill Hub — AI Agent를 위한 오픈 스킬 마켓플레이스; CowAgent, OpenClaw, Claude Code 등과 호환
bot-on-anything — Slack, Telegram, Discord, Gmail 등을 통합한 경량 LLM 애플리케이션 프레임워크
AgentMesh — 팀 협업을 통해 복잡한 문제를 해결하는 오픈소스 멀티 에이전트 프레임워크
🏢 엔터프라이즈 서비스
LinkAI는 기업과 개발자를 위한 올인원 AI Agent 플랫폼으로, CowAgent에 관리형 호스팅과 엔터프라이즈급 지원을 제공합니다:
🚀 제로 배포 호스팅 런타임 — 서버 없이 1분 이내에 CowAgent 온라인 어시스턴트를 시작
🧠 Agent 인프라 — LLM, 지식 베이스, 데이터베이스, 스킬, 워크플로에 대한 통합 액세스; CowAgent의 기능을 확장하는 플러그 앤 플레이 빌딩 블록
🏢 팀 & 엔터프라이즈 기능 — 워크스페이스, 역할 기반 액세스, 감사 로그, 프로덕션 사용 사례를 위한 프라이빗 배포
엔터프라이즈 문의: [email protected] 또는 QR 코드를 스캔하여 WeChat으로 팀에 연락하세요.
🛠️ 개발 & 기여
모든 종류의 기여를 환영합니다 — 새로운 기능, 버그 수정, 성능 개선, 문서, 또는 Skill Hub에 자신만의 스킬 공유. 시작하려면 CONTRIBUTING.md를 참조한 후, Issue를 열어 논의하거나 PR을 직접 보내주세요.
⭐ 프로젝트에 Star를 눌러 지원을 보여주시고, Watch → Custom → Releases로 새 버전 알림을 받으세요. PR과 Issue는 언제나 환영합니다.
🌟 기여자
⚠️ 면책 조항
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되며 기술 연구 및 학습을 목적으로 합니다. 귀하는 관할 지역의 적용 가능한 법률과 규정을 준수할 책임이 있으며, 유지 관리자는 이 프로젝트의 사용으로 인해 발생하는 어떠한 결과에 대해서도 책임을 지지 않습니다.
비용 & 안전: Agent…
No comments yet.
to comment.