전체 글

OpenClaw Skills Review: Wacli 2026.02.18
OpenClaw Skills Review: Tavily Web Search 2026.02.18
OpenClaw Skills Review: ATXP 2026.02.18
OpenClaw Skills Review: self-improving-agent 2026.02.18
OpenClaw Skills Review: Gog 2026.02.18 1
Gemini CLI - 자주 묻는 질문(FAQ) 2026.02.17
Gemini CLI - 확장 기능 레퍼런스 2026.02.17
Gemini CLI - 신뢰할 수 있는 폴더 2026.02.17
Gemini CLI - 엔터프라이즈 가이드 2026.02.17
Gemini CLI - 후크(Hooks) 가이드 2026.02.17

OpenClaw Skills Review: Wacli

_moneylog 2026. 2. 18. 20:46

2026. 2. 18. 20:46

OpenClaw Skills Review: Wacli

Moneylog Tech Curation • @steipete

Openclaw 스킬 살펴보기 - Wacli

오늘은 Openclaw의 Wacli 스킬을 소개합니다.

기능 및 효용

Wacli 스킬은 Openclaw 환경에서 WhatsApp CLI(Command Line Interface) 도구인 wacli를 활용하여 WhatsApp 메시징을 자동화하고 관리하는 데 중점을 둡니다.

이 스킬을 통해 Openclaw는 특정 외부 연락처로 메시지를 보내거나, WhatsApp 대화 기록을 효율적으로 검색하고 동기화할 수 있게 됩니다.

이러한 기능은 반복적이고 번거로운 수동 메시징 작업을 줄여주고, 필요한 정보를 대화 기록에서 빠르게 찾아 업무 흐름을 훨씬 매끄럽게 만들어줍니다.

단순한 알림 전송부터 중요한 파일 공유, 대규모 대화 기록 분석에 이르기까지, 다양한 시나리오에서 WhatsApp 활용도를 높이는 구체적인 가치를 제공합니다.

상세 내용

Wacli란 무엇인가요?

Wacli는 WhatsApp을 명령줄에서 제어할 수 있도록 설계된 도구입니다.

Openclaw는 이 wacli CLI를 사용하여 사용자 대신 WhatsApp 작업을 수행합니다.

중요한 점은 이 스킬이 일반적인 WhatsApp 채팅을 대체하는 것이 아니라는 것입니다.

대신, 특정 자동화된 메시지 전송, 대화 기록 검색 및 동기화와 같은 목적에 특화되어 활용됩니다.

주요 기능 탐색

인증 및 동기화: wacli auth 명령어를 통해 QR 코드 스캔 방식으로 간단하게 WhatsApp 계정을 인증할 수 있습니다.한 번 인증되면, wacli sync --follow 명령으로 대화 기록을 지속적으로 동기화하여 최신 정보를 유지할 수 있습니다.
이는 Openclaw가 항상 최신 대화 맥락을 이해하고 작업을 수행하는 데 도움을 줍니다.
대화 및 메시지 검색: 특정 대화 상대를 찾거나 (wacli chats list), 대화 기록 내에서 특정 키워드를 검색하는 등 (wacli messages search)의 기능을 제공합니다.특정 날짜 범위를 지정하여 메시지를 검색할 수도 있어, 과거의 중요한 정보를 손쉽게 찾아낼 수 있습니다.
이는 정보 접근성을 높이고, 필요한 데이터를 빠르게 파악하는 데 유용합니다.
메시지 전송: 텍스트 메시지 전송, 그룹 메시지 전송, 그리고 파일 전송까지 가능합니다.예를 들어, 특정 사용자나 그룹에 정기적인 알림을 보내거나, 중요한 보고서 파일을 자동으로 공유하는 등의 작업을 Openclaw를 통해 자동화할 수 있습니다.
이 기능은 특히 반복적인 커뮤니케이션 업무에서 효율성을 더해줍니다.

안전하고 신뢰할 수 있는 사용

Wacli 스킬은 메시지를 전송하기 전에 명확한 수신자와 메시지 내용이 필요하며, 전송 전 사용자에게 확인을 요청하여 오작동을 방지합니다.

또한, WhatsApp 인증 및 대화 기록 데이터는 ~/.wacli 경로에 로컬로 저장되므로, 외부 API 키 없이도 개인 정보 보호를 유지하며 기능을 활용할 수 있습니다.

스킬을 설치하기 전에는 wacli CLI 도구의 설치 출처를 확인하는 것이 권장됩니다.

설치 및 시작

Wacli 스킬을 사용하기 위해서는 먼저 wacli CLI 도구가 시스템에 설치되어 있어야 합니다.

macOS 사용자라면 Homebrew를 통해 다음 명령으로 쉽게 설치할 수 있습니다:

brew install steipete/tap/wacli

Go 언어 환경이 설정되어 있다면 다음 명령으로 설치할 수 있습니다:

go install github.com/steipete/wacli/cmd/wacli@latest

맺음말

Wacli 스킬은 Openclaw와 연동하여 WhatsApp의 활용 범위를 넓혀주는 실용적인 도구입니다.

이 스킬을 통해 반복적인 메시징 작업을 자동화하고, 중요한 대화 기록을 효율적으로 관리하여 전반적인 디지털 소통 환경을 개선할 수 있습니다.

OpenClaw Skills Review: Tavily Web Search

_moneylog 2026. 2. 18. 20:19

2026. 2. 18. 20:19

OpenClaw Skills Review: Tavily Web Search

Moneylog Tech Curation • @arun-8687

Openclaw 스킬 살펴보기 - Tavily Web Search

오늘은 Tavily Web Search 스킬에 대해 소개하겠습니다.

기능 및 효용

Tavily Web Search 스킬은 인공지능 에이전트에 최적화된 웹 검색 기능을 제공합니다. 이 스킬을 활용하면 AI 에이전트가 인터넷에서 필요한 정보를 빠르고 효율적으로 찾을 수 있어, 수동 정보 검색의 번거로움이 줄어들고 업무 흐름이 훨씬 매끄러워집니다.

특히, AI 에이전트의 정보 습득 능력을 향상시켜 더욱 정확하고 유용한 결과물을 도출하는 데 크게 기여합니다.

상세 내용

Tavily Web Search는 Tavily API를 통해 작동하며, AI 에이전트가 필요로 하는 간결하고 관련성 높은 검색 결과를 반환하도록 설계되었습니다.

이는 일반적인 웹 검색 엔진과 달리, AI가 정보를 처리하고 활용하기에 용이한 형태로 최적화된 콘텐츠를 제공한다는 의미입니다.

이 스킬은 크게 두 가지 주요 기능을 제공합니다.

1. 웹 검색 (Search)

특정 쿼리에 대해 웹을 검색하고 결과를 얻을 수 있습니다.

기본 검색: node {baseDir}/scripts/search.mjs "쿼리" 명령어를 사용하여 기본적인 웹 검색을 수행할 수 있습니다.
결과 수 조절: -n <count> 옵션을 사용하여 반환되는 결과의 수를 조절할 수 있습니다 (기본값 5개, 최대 20개).
심층 검색: --deep 옵션을 추가하면 더욱 포괄적인 심층 조사를 수행할 수 있습니다. 이는 복잡하거나 광범위한 리서치에 유용합니다.
주제별 검색: --topic <topic> 옵션으로 검색 주제를 general (일반) 또는 news (뉴스)로 지정할 수 있습니다. news 주제의 경우, --days <n> 옵션을 사용하여 지난 n일 이내의 뉴스로 검색 범위를 제한할 수 있습니다.

2. URL에서 콘텐츠 추출 (Extract)

특정 웹페이지의 콘텐츠를 추출할 수 있습니다.

node {baseDir}/scripts/extract.mjs "https://example.com/article" 명령어를 사용하여 주어진 URL의 본문 내용을 추출할 수 있습니다.
이는 특정 기사나 웹페이지의 내용을 AI 에이전트가 분석해야 할 때 특히 유용합니다.

이 스킬을 사용하려면 Tavily 웹사이트(tavily.com)에서 발급받은 TAVILY_API_KEY가 필요합니다. 이 키는 환경 변수로 설정되어야 합니다.

Tavily Web Search 스킬은 AI 에이전트의 정보 탐색 능력을 한 단계 끌어올려 줄 것입니다.

맺음말

지금까지 Tavily Web Search 스킬에 대해 살펴보았습니다.

OpenClaw Skills Review: ATXP

_moneylog 2026. 2. 18. 20:08

2026. 2. 18. 20:08

OpenClaw Skills Review: ATXP

Moneylog Tech Curation • @emilioacc

Openclaw 스킬 살펴보기 - ATXP

오늘은 Openclaw의 ATXP 스킬을 소개합니다.

ATXP 스킬의 기능과 가치

ATXP 스킬은 실시간 웹 검색부터 AI를 활용한 이미지, 음악, 비디오 생성, 그리고 X(구 트위터) 검색에 이르는 다양한 기능을 제공합니다. 이 스킬을 통해 사용자는 여러 유료 API 도구에 접근하여 일상적인 작업 흐름을 개선하고, 창의적인 콘텐츠를 손쉽게 생성할 수 있습니다.

수동으로 여러 플랫폼을 오가며 정보를 찾거나 콘텐츠를 만드는 번거로움을 줄여주며, 필요한 도구를 하나의 인터페이스에서 통합적으로 활용함으로써 업무 효율성을 높여줍니다.

상세 내용

ATXP 스킬은 명령줄 인터페이스(CLI)를 통해 다양한 기능을 실행할 수 있도록 설계되었습니다. Openclaw 환경에서 npx atxp 명령어를 사용하여 각 기능에 접근할 수 있습니다.

실시간 웹 검색

정보를 빠르게 찾아야 할 때 유용합니다. npx atxp search <query> 명령어를 사용하면 실시간으로 웹을 검색하고 최신 정보를 얻을 수 있습니다. 복잡한 검색 엔진을 일일이 방문할 필요 없이 필요한 데이터를 즉시 확인할 수 있어 시간을 절약할 수 있습니다.

AI 이미지 생성

특정 주제나 아이디어를 시각화하고 싶을 때 AI 이미지 생성 기능을 활용할 수 있습니다. npx atxp image <prompt> 명령어를 통해 원하는 이미지를 텍스트 설명(프롬프트)으로 생성할 수 있습니다. 디자인 작업이나 블로그 콘텐츠 제작 등 시각 자료가 필요할 때 유용하게 활용될 수 있습니다.

AI 음악 생성

음악적 아이디어를 빠르게 현실화하고 싶다면 AI 음악 생성 기능을 사용해 보세요. npx atxp music <prompt> 명령어로 간단한 텍스트 프롬프트만으로 음악을 만들 수 있습니다. 개인 프로젝트나 배경 음악이 필요한 상황에서 새로운 창작의 기회를 제공합니다.

AI 비디오 생성

영상 콘텐츠 제작이 필요한 경우 AI 비디오 생성 기능이 큰 도움이 될 수 있습니다. npx atxp video <prompt>를 통해 텍스트 설명을 바탕으로 비디오를 생성할 수 있습니다. 마케팅 자료, 짧은 설명 영상 등 다양한 용도로 활용 가능하며, 영상 제작의 진입 장벽을 낮춰줍니다.

X/Twitter 검색

X(구 트위터)에서 특정 정보를 찾거나 트렌드를 파악할 때 유용합니다. npx atxp x <query> 명령어로 X/트위터의 실시간 데이터를 검색할 수 있습니다. 소셜 미디어 동향 분석이나 특정 주제에 대한 여론을 파악하는 데 도움이 될 수 있습니다.

이 스킬을 사용하기 위해서는 npx atxp login을 통해 인증 과정을 거쳐야 하며, $ATXP_CONNECTION 환경 변수가 설정되어 있는지 확인해야 합니다. 이는 ATXP 유료 API 도구에 안전하게 접근하기 위한 필수 단계입니다.

맺음말

ATXP 스킬은 다양한 생산성 및 콘텐츠 생성 도구를 통합하여 여러분의 디지털 작업 환경을 더욱 풍성하게 만들어 줄 것입니다. Openclaw와 함께 ATXP 스킬을 활용하여 여러분의 아이디어를 현실로 구현해 보세요.

OpenClaw Skills Review: self-improving-agent

_moneylog 2026. 2. 18. 19:42

2026. 2. 18. 19:42

OpenClaw Skills Review: self-improving-agent

Moneylog Tech Curation • @pskoett

오늘은 Self-Improvement Agent 스킬을 소개하겠습니다.

기능 및 효용

Self-Improvement Agent 스킬은 Openclaw 에이전트가 스스로 경험을 통해 배우고 발전하도록 돕는 핵심적인 기능입니다. 에이전트가 작업 중 겪는 오류, 사용자의 피드백, 새로운 지식 등을 체계적으로 기록하고 관리하여, 시간이 지남에 따라 에이전트의 성능과 문제 해결 능력을 향상시킵니다.

결과적으로 에이전트의 실수를 줄이고, 더 효율적으로 작업을 수행할 수 있도록 하여 사용자의 번거로움을 줄여주며 업무 흐름이 훨씬 매끄러워집니다.

상세 내용

에이전트의 학습 과정 기록

Self-Improvement Agent 스킬은 에이전트의 다양한 경험을 세 가지 유형의 마크다운 파일에 자동으로 기록합니다.

LEARNINGS.md: 사용자의 수정 피드백, 새로운 지식 습득, 더 나은 작업 방식 발견 등 긍정적인 학습 경험을 기록합니다.
ERRORS.md: 명령 실패, 예기치 않은 오류, 외부 도구 연동 문제 등 에이전트가 겪은 문제와 실패 사례를 기록합니다.
FEATURE_REQUESTS.md: 사용자가 요청했지만 현재 에이전트가 지원하지 않는 기능 아이디어 등을 기록하여 잠재적인 개선점을 파악합니다.

이러한 기록은 에이전트가 과거의 경험을 되짚어보고, 같은 실수를 반복하지 않도록 학습하는 데 중요한 기반이 됩니다. 마치 사람이 일기를 쓰며 반성하고 성장하는 것과 유사합니다.

학습 내용을 프로젝트 지식으로 승격

단순한 기록을 넘어, 이 스킬은 중요한 학습 내용을 프로젝트의 영구적인 지식으로 전환하는 기능을 제공합니다.

특정 학습이 여러 상황에 적용될 수 있거나, 모든 에이전트 또는 팀원이 알아야 할 중요한 내용이라고 판단될 때, 다음과 같은 워크스페이스 파일로 승격시킬 수 있습니다.

SOUL.md: 에이전트의 행동 원칙, 성격, 커뮤니케이션 스타일 등 기본적인 운영 지침을 담습니다.
AGENTS.md: 다중 에이전트 워크플로우, 작업 위임 방식 등 에이전트 운영에 관한 규칙을 명시합니다.
TOOLS.md: 도구의 기능, 사용 패턴, 통합 시 주의할 점 등 도구 활용에 대한 노하우를 정리합니다.

이를 통해 에이전트는 반복적으로 동일한 정보를 학습할 필요 없이, 이미 검증된 지식을 기반으로 더 빠르고 정확하게 작업을 수행할 수 있게 됩니다. 이는 팀 전체의 생산성 향상에도 기여합니다.

재사용 가능한 스킬로 추출

특정 문제 해결 방식이나 작업 흐름이 매우 유용하고, 다른 프로젝트에서도 활용될 수 있다고 판단될 경우, 이 스킬은 해당 학습 내용을 독립적인 Openclaw 스킬로 추출하는 기능을 제공합니다. 이는 에이전트가 새로운 지식을 습득하고, 그 지식을 바탕으로 새로운 능력을 만들어내는 것과 같습니다.

반복적인 문제: 여러 번 같은 문제가 발생하고 성공적으로 해결된 경우에 추출을 고려합니다.
검증된 해결책: 오류가 수정되고, 그 해결책이 효과적임이 입증된 경우에 적합합니다.
보편적 적용 가능성: 특정 프로젝트에 국한되지 않고, 여러 상황에서 유용하게 쓰일 수 있는 경우에 가치가 높습니다.

이러한 과정을 통해 에이전트의 지식은 단순한 기록을 넘어, 실제 작동하는 도구로 발전하여 Openclaw 생태계 전체를 풍부하게 만듭니다.

자동화된 학습 관리 (훅 기능)

Self-Improvement Agent 스킬은 Openclaw의 '훅(hook)' 기능을 활용하여 학습 과정을 더욱 자동화할 수 있습니다.

예를 들어, 에이전트가 도구를 사용한 후 오류가 발생했을 때 자동으로 이를 감지하여 ERRORS.md 파일에 기록하거나, 새로운 세션이 시작될 때 이전에 학습된 내용을 상기시켜주는 등의 기능을 설정할 수 있습니다. 이는 에이전트가 스스로 학습의 필요성을 인지하고, 적시에 필요한 조치를 취하도록 돕는 역할을 합니다.

맺음말

Self-Improvement Agent 스킬은 Openclaw 에이전트의 지능을 지속적으로 향상시키는 데 기여합니다. 이 스킬을 활용하여 여러분의 Openclaw 에이전트가 더욱 능숙하게 작업을 처리하도록 훈련해 보세요.

OpenClaw Skills Review: Gog

_moneylog 2026. 2. 18. 18:57

2026. 2. 18. 18:57

OpenClaw Skills Review: Gog

Moneylog Tech Curation • steipete

오늘은 Gog 스킬을 소개하겠습니다. 이 스킬은 Google Workspace의 다양한 서비스를 명령줄 인터페이스(CLI)를 통해 관리할 수 있도록 설계되었습니다. Gmail, Calendar, Drive, Contacts, Sheets, Docs 등 구글 워크스페이스의 핵심 기능들을 터미널에서 직접 제어하며, 반복적인 작업을 자동화하고 워크플로우를 간소화하는 데 유용합니다.

기능 및 효용

Gog 스킬은 Google Workspace의 여러 서비스를 통합적으로 관리하는 강력한 도구입니다. 이 스킬을 활용하면 복잡한 웹 인터페이스를 거치지 않고도 명령어를 통해 신속하게 작업을 처리할 수 있습니다. 예를 들어, 특정 조건의 이메일을 검색하거나, 캘린더 이벤트를 관리하고, 구글 드라이브 파일을 조작하며, 스프레드시트의 데이터를 읽고 쓰는 등 다양한 작업을 자동화할 수 있습니다. 이는 번거로운 반복 작업이 줄어들고, 업무 흐름이 훨씬 매끄러워지는 효과를 가져옵니다.

상세 내용

Gog 스킬을 사용하기 위해서는 먼저 몇 가지 설정 과정이 필요합니다. Google OAuth 자격 증명 파일인 client_secret.json을 사용하여 인증 절차를 완료해야 하며, 사용할 Google 계정과 서비스를 추가해야 합니다.

초기 설정

Gog 스킬을 처음 사용할 때는 다음 단계를 거쳐야 합니다.

gog auth credentials /path/to/client_secret.json

OAuth 자격 증명 파일을 등록합니다.

gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs

사용할 Google 계정과 연동할 서비스를 추가합니다.

```
gog auth list
```
현재 등록된 계정을 확인합니다.

주요 명령어 활용

설정이 완료되면 다양한 Google Workspace 서비스에서 Gog 스킬의 기능을 활용할 수 있습니다.

Gmail 관리

이메일 검색: 특정 조건에 맞는 이메일을 찾을 수 있습니다. 예:
```
gog gmail search 'newer_than:7d' --max 10
```
이메일 전송: 새로운 이메일을 보내거나 답장할 수 있습니다. 예:
```
gog gmail send --to a@b.com --subject "Hi" --body "Hello"
```

Calendar 이벤트 관리

이벤트 조회: 특정 기간의 캘린더 이벤트를 확인할 수 있습니다. 예:
```
gog calendar events <calendarId> --from <iso> --to <iso>
```

Drive 파일 관리

파일 검색: 구글 드라이브에서 특정 파일을 검색할 수 있습니다. 예:
```
gog drive search "query" --max 10
```

Contacts 연락처 관리

연락처 목록: 등록된 연락처 목록을 조회할 수 있습니다. 예:
```
gog contacts list --max 20
```

Sheets 스프레드시트 관리

데이터 가져오기: 스프레드시트의 특정 범위 데이터를 가져올 수 있습니다. 예:
```
gog sheets get <sheetId> "Tab!A1:D10" --json
```

데이터 업데이트: 스프레드시트의 데이터를 수정할 수 있습니다. 예:

gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED

데이터 추가: 스프레드시트에 새 데이터를 추가할 수 있습니다. 예:

gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS

데이터 지우기: 특정 범위의 데이터를 삭제할 수 있습니다. 예:
```
gog sheets clear <sheetId> "Tab!A2:Z"
```
메타데이터 확인: 스프레드시트의 메타데이터를 조회할 수 있습니다. 예:
```
gog sheets metadata <sheetId> --json
```

Docs 문서 관리

문서 내보내기: 구글 문서를 텍스트 파일 등으로 내보낼 수 있습니다. 예:
```
gog docs export <docId> --format txt --out /tmp/doc.txt
```
문서 내용 보기: 구글 문서의 내용을 터미널에서 확인할 수 있습니다. 예:
```
gog docs cat <docId>
```

사용 팁

GOG_ACCOUNT 환경 변수를 설정하면 --account 옵션을 반복적으로 입력할 필요가 없습니다.
스크립트 작성 시에는 --json 옵션과 --no-input 옵션을 함께 사용하여 출력을 쉽게 파싱하고 사용자 입력을 방지할 수 있습니다.

이 스킬은 로컬에 gog 바이너리가 설치되어 있어야 하며, OAuth 자격 증명과 Google 계정에 대한 접근 권한이 필요합니다. 따라서 설치 및 사용 전에 관련 프로젝트 문서를 충분히 검토하여 신뢰성을 확보하는 것이 중요합니다.

맺음말

Gog 스킬은 Google Workspace의 기능을 명령줄에서 효율적으로 활용하고자 하는 사용자에게 강력한 도구가 될 것입니다. 이러한 도구를 통해 업무 생산성을 높이고, 일상적인 작업을 더욱 간편하게 관리할 수 있기를 바랍니다.

Gemini CLI - 자주 묻는 질문(FAQ)

_moneylog 2026. 2. 17. 04:31

2026. 2. 17. 04:31

일반 이슈

Q: 'API error: 429 - Resource exhausted' 에러가 왜 발생하나요?

API 요청 제한을 초과했음을 의미합니다. Google AI Studio나 Google Cloud 대시보드에서 사용량을 확인하고, 프롬프트를 최적화하거나 요청 간격을 늘려보세요. 필요 시 Google에 쿼터 증설을 요청할 수 있습니다.

Q: 'ERR_REQUIRE_ESM' 에러가 발생합니다.

Node.js 프로젝트에서 CommonJS와 ES 모듈 간의 충돌로 발생합니다. package.json에 "type": "module" 설정이 있는지, tsconfig.json의 모듈 설정이 올바른지 확인하세요.

Q: 왜 통계 출력에 캐시된 토큰(Cached Token) 수가 표시되지 않나요?

캐시된 토큰 정보는 API 키 사용자(AI Studio 또는 Vertex AI)에게만 표시됩니다. OAuth 사용자(개인/기업 계정)는 Gemini Code Assist API 정책상 현재 캐시 기능을 지원하지 않기 때문입니다. 하지만 /stats 명령어로 전체 토큰 사용량은 확인 가능합니다.

플랫폼별 이슈

Q: 윈도우에서 'chmod' 같은 명령어를 실행하면 CLI가 충돌합니다.

chmod는 유닉스 계열(Linux, macOS) 전용 명령어입니다. 윈도우에서는 icacls 명령어를 사용하거나, Git Bash 또는 WSL(Windows Subsystem for Linux) 환경에서 실행하는 것을 권장합니다.

설정 가이드

Q: API 키를 가장 안전하게 저장하는 방법은 무엇인가요?

.env 파일 사용: 프로젝트의 .gemini/.env 파일에 저장하면 CLI가 자동으로 로드합니다.
시스템 키링 사용: macOS Keychain이나 Windows 자격 증명 관리자와 같은 OS 수준의 비밀 관리 도구를 사용하는 것이 가장 안전합니다.

Q: 설정 파일은 어디에 저장되나요?

1. 홈 디렉토리: ~/.gemini/settings.json (전역)
2. 프로젝트 루트: ./.gemini/settings.json (로컬)

Google AI Pro/Ultra 구독 관련

Q: 유료 구독을 하면 더 높은 제한(Limit)이 적용되나요?

네, Google AI Pro 또는 Ultra 구독 시 Gemini CLI 및 IDE 에이전트 모드에 자동으로 더 높은 쿼터가 적용됩니다.

Q: 구독을 하면 제 데이터가 학습에 사용되나요?

유료 플랜 사용자의 데이터는 모델 학습에 사용되지 않습니다. 무료 버전 사용자도 설정에서 데이터 사용 여부를 거부(Opt-out)할 수 있습니다.

답변을 찾지 못하셨나요?

GitHub의 Q&A 토론 게시판을 검색하거나 새로운 질문을 등록해 주세요.

'Ai > 제미나이 cli 메뉴얼' 카테고리의 다른 글

Gemini CLI - 확장 기능 레퍼런스 (0)	2026.02.17
Gemini CLI - 신뢰할 수 있는 폴더 (0)	2026.02.17
Gemini CLI - 엔터프라이즈 가이드 (0)	2026.02.17
Gemini CLI - 후크(Hooks) 가이드 (0)	2026.02.17
Gemini CLI - 에이전트 스킬 가이드 (0)	2026.02.17

Gemini CLI - 확장 기능 레퍼런스

_moneylog 2026. 2. 17. 04:07

2026. 2. 17. 04:07

확장 관리 (Extension Management)

gemini extensions 명령어를 사용하여 확장 기능을 관리할 수 있습니다.

참고: gemini extensions install과 같은 관리 명령어는 CLI의 대화형 모드(Interactive Mode) 내에서는 지원되지 않습니다. (설치된 목록 확인은 /extensions list 슬래시 명령어로 가능합니다.)

참고: 모든 관리 작업(슬래시 명령어 업데이트 포함)은 CLI 세션을 재시작해야 활성 세션에 반영됩니다.

확장 설치 (Installing)

GitHub URL 또는 로컬 경로를 사용하여 gemini extensions install로 설치할 수 있습니다. 설치 시 확장의 복사본이 생성되므로, 변경 사항을 반영하려면 update 명령어를 실행해야 합니다.

gemini extensions install <source> [--ref <ref>] [--auto-update] [--pre-release] [--consent]

<source>: 설치할 확장의 GitHub URL 또는 로컬 경로. (GitHub 설치 시 git 설치 필요)
--ref: 설치할 특정 git 참조(브랜치/태그/커밋).
--auto-update: 해당 확장의 자동 업데이트 활성화.
--pre-release: 시험판(pre-release) 버전 설치 허용.
--consent: 보안 위험을 확인하고 승인 프롬프트를 생략합니다.

기타 관리 명령어

동작	명령어
삭제 (Uninstall)	`gemini extensions uninstall <name...>`
비활성화 (Disable)	`gemini extensions disable <name> [--scope <scope>]`
활성화 (Enable)	`gemini extensions enable <name> [--scope <scope>]`
업데이트 (Update)	`gemini extensions update <name>` (또는 `--all`)
새 확장 생성 (New)	`gemini extensions new <path> [template]`
로컬 링크 (Link)	`gemini extensions link <path>` (심볼릭 링크 생성)

확장 형식 (Extension Format)

Gemini CLI는 시작 시 <home>/.gemini/extensions 디렉토리에서 확장을 찾습니다. 각 확장은 gemini-extension.json 파일을 포함하는 디렉토리여야 합니다.

gemini-extension.json

{
  "name": "my-extension",
  "version": "1.0.0",
  "description": "My awesome extension",
  "mcpServers": {
    "my-server": { "command": "node my-server.js" }
  },
  "contextFileName": "GEMINI.md",
  "excludeTools": ["run_shell_command"]
}

name: 고유 식별자. 디렉토리 이름과 일치해야 하며 사용자가 CLI에서 참조할 이름입니다.
version: 확장의 버전.
description: 확장 갤러리에 표시될 짧은 설명.
mcpServers: 시작 시 로드될 MCP 서버 설정 맵. settings.json에 동일한 이름의 서버가 있으면 settings.json이 우선합니다. (trust 옵션 미지원)
contextFileName: 컨텍스트 마크다운 파일명. 미지정 시 GEMINI.md를 로드합니다.
excludeTools: 모델에서 제외할 도구 목록. 인자 수준의 제한도 지원합니다.

설정 (Settings) 실험적 기능

사용자에게 API 키 등 필요한 설정을 입력받아 .env 파일에 저장할 수 있습니다.

{
  "settings": [
    {
      "name": "API Key",
      "description": "서비스를 위한 API 키",
      "envVar": "MY_API_KEY",
      "sensitive": true
    }
  ]
}

구성 요소 번들링

커스텀 명령어: commands/ 폴더 내의 TOML 파일.
후크 (Hooks): hooks/hooks.json 파일에 정의.
에이전트 스킬: skills/ 폴더 내의 SKILL.md 파일.
하위 에이전트 실험적: agents/ 폴더 내의 .md 파일.

충돌 해결 (Conflict Resolution)

확장 명령어는 가장 낮은 우선순위를 가집니다. 프로젝트/사용자 명령어와 충돌 시 확장명 접두어가 붙습니다 (예: /gcp.deploy).

변수 (Variables)

변수	설명
`${extensionPath}`	확장이 설치된 실제 전체 경로 (심볼릭 링크 미해제)
`${workspacePath}`	현재 워크스페이스의 전체 경로
`${/}` 또는 `${pathSeparator}`	운영체제별 경로 구분자

'Ai > 제미나이 cli 메뉴얼' 카테고리의 다른 글

Gemini CLI - 자주 묻는 질문(FAQ) (0)	2026.02.17
Gemini CLI - 신뢰할 수 있는 폴더 (0)	2026.02.17
Gemini CLI - 엔터프라이즈 가이드 (0)	2026.02.17
Gemini CLI - 후크(Hooks) 가이드 (0)	2026.02.17
Gemini CLI - 에이전트 스킬 가이드 (0)	2026.02.17

Gemini CLI - 신뢰할 수 있는 폴더

_moneylog 2026. 2. 17. 03:46

2026. 2. 17. 03:46

기능 활성화하기

이 기능은 기본적으로 비활성화되어 있습니다. 사용하려면 전역 settings.json 파일에 다음 설정을 추가해야 합니다.

{
  "security": {
    "folderTrust": {
      "enabled": true
    }
  }
}

작동 방식: 신뢰 다이얼로그

기능이 활성화된 후, 특정 폴더에서 처음 Gemini CLI를 실행하면 다음과 같은 선택지가 포함된 다이얼로그가 나타납니다.

폴더 신뢰 (Trust folder)

현재 폴더에 대해 모든 권한을 부여합니다.

상위 폴더 신뢰 (Trust parent folder)

상위 디렉토리를 신뢰하며, 그 아래의 모든 하위 디렉토리를 자동으로 신뢰합니다.

신뢰하지 않음 (Don't trust)

폴더를 신뢰하지 않음으로 표시하고 제한된 "안전 모드"로 실행합니다.

💡 선택 결과는 ~/.gemini/trustedFolders.json에 저장되므로 폴더당 한 번만 질문합니다.

신뢰되지 않은 워크스페이스의 영향

폴더를 신뢰하지 않을 경우, Gemini CLI는 사용자를 보호하기 위해 강력한 제한 모드로 작동합니다.

🚫 비활성화되는 기능들:

워크스페이스 설정 무시: 프로젝트 내의 .gemini/settings.json을 로드하지 않습니다.
환경 변수 무시: 프로젝트 폴더의 .env 파일을 로드하지 않습니다.
확장 프로그램 관리 제한: 확장을 설치, 업데이트 또는 삭제할 수 없습니다.
도구 자동 승인 비활성화: 전역 설정과 관계없이 모든 도구 실행 시 승인 프롬프트가 나타납니다.
자동 메모리 로드 중단: 로컬 설정에 지정된 디렉토리의 파일을 컨텍스트로 로드하지 않습니다.
MCP 서버 연결 차단: 모든 MCP 서버 연결 시도를 중단합니다.
커스텀 명령어 로드 중단: 프로젝트 및 전역 사용자 명령어를 포함한 모든 .toml 명령어를 로드하지 않습니다.

설정 관리하기

현재 폴더 권한 변경: CLI 내에서 /permissions 명령어를 실행하여 다이얼로그를 다시 띄울 수 있습니다.
전체 규칙 확인: ~/.gemini/trustedFolders.json 파일을 열어 신뢰/비신뢰 폴더 목록을 직접 확인할 수 있습니다.

신뢰 확인 프로세스 (고급)

신뢰 여부는 다음 우선순위에 따라 결정됩니다:

IDE 신뢰 신호: IDE 연동 기능을 사용하는 경우, IDE의 워크스페이스 신뢰 여부를 가장 먼저 확인합니다.
로컬 신뢰 파일: IDE가 연결되지 않은 경우 중앙 관리 파일(trustedFolders.json)을 확인합니다.

'Ai > 제미나이 cli 메뉴얼' 카테고리의 다른 글

Gemini CLI - 자주 묻는 질문(FAQ) (0)	2026.02.17
Gemini CLI - 확장 기능 레퍼런스 (0)	2026.02.17
Gemini CLI - 엔터프라이즈 가이드 (0)	2026.02.17
Gemini CLI - 후크(Hooks) 가이드 (0)	2026.02.17
Gemini CLI - 에이전트 스킬 가이드 (0)	2026.02.17

Gemini CLI - 엔터프라이즈 가이드

_moneylog 2026. 2. 17. 03:24

2026. 2. 17. 03:24

🔒 보안 참고사항: 이 가이드의 설정은 관리되는 환경에서 실수에 의한 오용을 방지하고 기업 정책을 준수하기 위한 것입니다. 로컬 관리자 권한을 가진 사용자는 이러한 설정을 우회할 수 있으므로, 완전한 보안 장벽으로 간주해서는 안 됩니다.

중앙 집중식 설정: 시스템 설정 파일

시스템 수준의 설정 파일을 통해 모든 사용자에게 적용되는 기본값과 강제 정책을 정의할 수 있습니다. 설정은 다음 4가지 파일에서 병합됩니다.

우선순위 (높은 순서대로)

시스템 오버라이드 (System Overrides) - settings.json (시스템 경로)

워크스페이스 설정 (Workspace) - <project>/.gemini/settings.json

사용자 설정 (User) - ~/.gemini/settings.json

시스템 기본값 (System Defaults) - system-defaults.json

💡 시스템 오버라이드 파일이 최종 결정권을 가집니다. 배열이나 객체(예: MCP 서버)는 병합됩니다.

도구 접근 제한 (Restricting Tools)

모델이 사용할 수 있는 도구를 허용 목록(Allowlist) 방식으로 관리하는 것이 가장 안전합니다.

권장 사항: 허용 목록(coreTools) 사용

{
  "tools": {
    "core": ["ReadFileTool", "GlobTool", "ShellTool(ls)"]
  }
}

YOLO 모드 비활성화

사용자가 승인 없이 도구를 실행하는 것을 방지하기 위해 YOLO 모드를 강제로 끌 수 있습니다.

{
  "security": {
    "disableYoloMode": true
  }
}

커스텀 도구 관리 (MCP Servers)

관리자는 승인된 서버 목록만 사용하도록 강제할 수 있습니다.

{
  "mcp": {
    "allowed": ["corp-data-api", "security-scanner"]
  },
  "mcpServers": {
    "corp-data-api": {
      "command": "/usr/local/bin/start-corp-api.sh",
      "timeout": 5000
    }
  }
}

텔레메트리 및 감사

도구 사용량을 추적하고 감사를 위해 데이터를 중앙 OTLP 컬렉터로 보낼 수 있습니다.

{
  "telemetry": {
    "enabled": true,
    "target": "gcp",
    "logPrompts": false
  }
}

※ logPrompts를 false로 설정하여 민감한 질문 내용이 수집되지 않도록 주의하세요.

인증 제어

특정 인증 방식을 강제하거나 기업 도메인으로만 로그인을 제한할 수 있습니다.

{
  "enforcedAuthType": "oauth-personal"
}

최종 예시: 시스템 settings.json

{
  "tools": {
    "sandbox": "docker",
    "core": ["ReadFileTool", "GlobTool", "ShellTool(ls)", "ShellTool(grep)"]
  },
  "mcp": { "allowed": ["corp-tools"] },
  "telemetry": {
    "enabled": true,
    "logPrompts": false
  },
  "privacy": {
    "usageStatisticsEnabled": false
  }
}

'Ai > 제미나이 cli 메뉴얼' 카테고리의 다른 글

Gemini CLI - 확장 기능 레퍼런스 (0)	2026.02.17
Gemini CLI - 신뢰할 수 있는 폴더 (0)	2026.02.17
Gemini CLI - 후크(Hooks) 가이드 (0)	2026.02.17
Gemini CLI - 에이전트 스킬 가이드 (0)	2026.02.17
Gemini CLI - 확장 기능 배포 가이드 (0)	2026.02.17

Gemini CLI - 후크(Hooks) 가이드

_moneylog 2026. 2. 17. 03:02

2026. 2. 17. 03:02

후크란 무엇인가요?

후크는 에이전트 루프의 일부로 동기적으로 실행됩니다. 특정 후크 이벤트가 발생하면 Gemini CLI는 해당되는 모든 후크가 완료될 때까지 기다린 후 다음 단계를 진행합니다.

문맥 추가: 모델이 요청을 처리하기 전 Git 히스토리 등 관련 정보를 주입합니다.
동작 검증: 도구의 인자를 검토하고 위험한 작업을 차단합니다.
정책 강제: 보안 스캐너나 규정 준수 체크를 구현합니다.
상호작용 로깅: 감사를 위해 도구 사용 내역과 모델의 응답을 추적합니다.

핵심 개념

후크 이벤트 (Lifecycle Events)

이벤트명	발생 시점	영향
`SessionStart`	세션 시작 시 (기동, 재개, 초기화)	문맥 주입
`BeforeAgent`	사용자 입력 후, 계획 수립 전	턴 차단 / 문맥 추가
`BeforeModel`	LLM에 요청을 보내기 직전	프롬프트 수정 / 모델 교체
`AfterModel`	LLM 응답을 받은 직후	응답 필터링 / 편집
`BeforeTool`	도구가 실행되기 직전	도구 차단 / 인자 수정
`AfterTool`	도구 실행이 완료된 직후	결과 처리 / 테스트 실행

⚠️ 황금률: 엄격한 JSON 요구사항

후크는 stdin(입력)과 stdout(출력)을 통해 통신합니다.

침묵은 필수: 스크립트는 최종 JSON 객체 외에 어떠한 텍스트도 stdout에 출력해서는 안 됩니다. 단 하나의 echo나 print만 있어도 파싱이 실패합니다.
디버깅은 Stderr로: 모든 로그와 디버깅 메시지는 반드시 stderr를 사용하세요 (예: echo "로그" >&2).

설정 방법 (settings.json)

후크는 settings.json의 hooks 필드에 구성합니다.

{
  "hooks": {
    "BeforeTool": [
      {
        "matcher": "write_file|replace",
        "hooks": [
          {
            "name": "security-check",
            "type": "command",
            "command": "$GEMINI_PROJECT_DIR/.gemini/hooks/security.sh"
          }
        ]
      }
    ]
  }
}

보안 및 위험 요소

경고: 후크는 사용자의 권한으로 임의의 코드를 실행합니다. 후크를 설정함으로써 스크립트가 로컬 머신에서 쉘 명령을 실행하도록 허용하게 됩니다.

Gemini CLI는 프로젝트 수준의 후크를 **지문(Fingerprint)**으로 관리합니다. 후크의 이름이나 명령어가 변경되면(예: git pull 이후) 새로운 미인증 후크로 간주하고 실행 전 경고를 표시합니다.

후크 관리 명령어

후크 상태 확인: /hooks panel
전체 활성화/비활성화: /hooks enable-all / disable-all
개별 제어: /hooks enable <name> / disable <name>

'Ai > 제미나이 cli 메뉴얼' 카테고리의 다른 글

Gemini CLI - 신뢰할 수 있는 폴더 (0)	2026.02.17
Gemini CLI - 엔터프라이즈 가이드 (0)	2026.02.17
Gemini CLI - 에이전트 스킬 가이드 (0)	2026.02.17
Gemini CLI - 확장 기능 배포 가이드 (0)	2026.02.17
Gemini CLI - 단축키 가이드 (0)	2026.02.17

PREV 이전 1 2 3 4 ···7 NEXT 다음