사용가능한 도구

이 문서는 비서가 실제 업무에서 활용할 수 있는 도구와 사용 범위를 정리한 운영 안내서입니다. 비서는 단순 응답형 챗봇이 아니라, 파일 확인, 문서 수정, 검색, 메시지 전송, 자동화 실행, Google Workspace 연동 등 다양한 작업을 도구를 통해 수행할 수 있습니다.

• 비서는 추측보다 실제 확인을 우선합니다.
• 가능한 경우 도구를 사용해 근거를 확인한 뒤 답변합니다.
• 도구마다 역할과 강점이 다르므로 작업 목적에 맞게 선택해서 사용합니다.
• 외부 전송, 삭제, 되돌리기 어려운 변경은 신중하게 다룹니다.

아래 도구들은 비서가 기본적으로 사용할 수 있는 핵심 도구입니다.

도구 명칭: read

용도:

• 문서 내용 확인
• 설정 파일 점검
• 업무 메모 및 기록 확인
• 운영 문서, 가이드, 로그 확인

활용 예시:

• AGENTS.md, USER.md, MEMORY.md 같은 운영 문서 확인
• 저장된 보고서나 메모 파일 읽기

도구 명칭: write

용도:

• 새 문서 작성
• 결과 파일 저장
• 초안 문서 생성
• 정리본 작성

활용 예시:

• 새 운영 문서 작성
• 분석 결과를 파일로 저장

주의사항:

• 기존 내용을 전체 덮어쓸 수 있으므로 범위를 명확히 확인해야 합니다.

도구 명칭: edit

용도:

• 특정 문장 수정
• 링크 추가
• 문단 교체
• 오타 및 표현 정리

활용 예시:

• 위키 문서 하단에 새 항목 추가
• 기존 설명 문구만 부분 수정

도구 명칭: exec

용도:

• 시스템 상태 확인
• 파일/폴더 조회
• 위키 원문 가져오기
• 스크립트 실행
• 간단한 자동화 처리

활용 예시:

• 파이썬 스크립트 실행
• 시스템 점검 명령 수행
• 위키 페이지 원문 조회

주의사항:

• 강력한 도구이므로 파급효과가 있는 명령은 신중하게 다뤄야 합니다.

도구 명칭: process

용도:

• 실행 상태 확인
• 중간 로그 조회
• 작업 종료
• 추가 입력 전달

활용 예시:

• 오래 걸리는 백그라운드 작업 진행 상황 확인

도구 명칭: web_search

용도:

• 최신 정보 검색
• 기사, 블로그, 문서 탐색
• 공식 사이트 및 참고 자료 확인

활용 예시:

• 특정 서비스의 최신 변경사항 확인
• 공식 문서나 보도자료 탐색

도구 명칭: web_fetch

용도:

• 기사 본문 확인
• 안내 페이지 요약
• 문서 내용 추출
• 검색 결과 후속 확인

활용 예시:

• 검색 결과로 찾은 문서의 실제 본문 검토

도구 명칭: browser

용도:

• 웹페이지 열기
• 화면 상태 확인
• 버튼 클릭
• 입력칸 작성
• 스크린샷 확보

활용 예시:

• 웹 UI 구조 확인
• 로그인된 브라우저 화면 점검

도구 명칭: canvas

용도:

• 화면 표시
• 화면 내용 확인
• 시각적 상태 점검

도구 명칭: message

용도:

• 작업 결과 보고
• 안내 메시지 전송
• 이모지 반응 남기기
• 알림 발송

활용 예시:

• 채팅방에 완료 보고 전송
• 특정 메시지에 반응 추가

주의사항:

• 외부로 나가는 행동이므로 사용자를 대신한 의사 표현에는 주의가 필요합니다.

도구 명칭: tts

용도:

• 텍스트를 음성으로 변환
• 듣기용 안내 생성

도구 명칭: memory_search, memory_get

용도:

• 이전 결정사항 확인
• 사용자 선호 복기
• 과거 작업 맥락 확인

활용 예시:

• 예전에 정리해둔 기준이나 메모 다시 확인

도구 명칭: sessions_spawn, sessions_send, sessions_list, sessions_history, sessions_yield, subagents, agents_list

용도:

• 보조 세션 생성
• 별도 작업 위임
• 진행 상태 확인
• 필요 시 종료 또는 제어

활용 예시:

• 긴 조사 작업을 별도 세션에 맡기기
• 코딩 또는 분석 작업을 분리 실행

도구 명칭: session_status

용도:

• 현재 시간 확인
• 세션 상태 확인
• 모델 및 실행 환경 점검

비서는 OpenClaw 기본 도구 외에도 TOOLS.md에 정리된 외부 도구와 작업 방식을 활용할 수 있습니다.

도구 명칭: gog 또는 gogcli

설명:

• Google Workspace 작업을 명령줄에서 처리하는 도구입니다.
• Gmail, Calendar, Drive, Chat, Docs, Sheets 등을 다룰 수 있습니다.

주요 기능:

• Google Drive 파일 검색, 다운로드, 업로드, 공유
• Gmail 검색, 메일 발송, 스레드 조회
• Google Calendar 일정 조회, 생성, 응답
• Google Chat DM 및 스페이스 메시지 전송
• Google Docs 내용 읽기 및 내보내기
• Google Sheets 조회, 추가, 수정, 내보내기

활용 예시:

• 공유 드라이브에서 파일 찾아서 PDF로 내보내기
• 안 읽은 메일 확인
• 캘린더 일정 생성
• 스프레드시트 데이터 읽기 및 업데이트

주의사항:

• 인증이 필요한 도구이며, 에이전트별 설정 분리가 중요합니다.
• TOOLS.md에 적힌 환경변수와 인증 절차를 따라야 합니다.

도구 명칭: mysql

설명:

• 회사 내부 sales 데이터베이스를 조회할 때 사용하는 도구입니다.

주요 기능:

• 테이블 조회
• 조건 검색
• 집계 조회
• CSV 추출

중요 원칙:

• 읽기 전용으로 사용합니다.
• INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE 같은 변경 작업은 수행하지 않습니다.
• 쿼리 작성 전에는 반드시 스키마 문서를 확인합니다.

도구 명칭: python3

설명:

• 데이터 정리, 자동화, 간단한 프로그램 제작에 활용합니다.

주요 활용:

• 텍스트/CSV/엑셀 처리
• API 호출
• 자동화 스크립트 작성
• 데이터 변환 및 가공

관련 라이브러리 예시:

• pandas : 표 데이터 처리
• requests : 웹/API 요청
• bs4 (BeautifulSoup) : HTML 분석
• playwright : 브라우저 자동화

관련 도구 명칭: requests, BeautifulSoup, playwright

설명:

• 웹페이지 구조를 분석하고 필요한 데이터를 추출할 때 사용합니다.

주요 기능:

• HTML 구조 분석
• 반복 데이터 추출
• CSV 저장
• JS 렌더링 페이지 수집

주의사항:

• 고정 선택자를 무조건 신뢰하지 않고 매번 구조를 확인합니다.
• 과도한 요청은 피하고, robots.txt 및 정책을 고려합니다.

도구 명칭: instagrapi

설명:

• 인스타그램 게시물, 댓글, 계정 게시물 등을 수집할 때 활용할 수 있는 Python 기반 도구입니다.

주요 기능:

• 게시물 댓글 수집
• 특정 계정 게시물 수집
• 해시태그 게시물 수집

주의사항:

• 과도한 수집은 계정 제한 위험이 있으므로 속도와 양을 조절해야 합니다.

위 도구들을 조합하면 비서는 아래와 같은 업무를 안정적으로 지원할 수 있습니다.

• 문서 읽기 및 정리
• 위키 수정 및 초안 작성
• 인터넷 조사 및 자료 수집
• Google Workspace 문서/메일/시트 처리
• 파일 확인 및 기록 관리
• 운영 문서 업데이트
• 여러 자료를 기반으로 한 요약 정리
• 반복 작업의 부분 자동화
• 데이터 조회 및 정리

도구를 사용할 수 있다고 해서 모든 작업을 즉시 수행하는 것은 아닙니다. 특히 아래 유형은 더 신중하게 판단해야 합니다.

• 파일 삭제
• 외부인 대상 메시지 발송
• 사용자를 대신한 공식적 표현
• 민감 정보 처리
• 데이터 변경 작업
• 되돌리기 어려운 변경

비서는 read, write, edit, exec 같은 기본 도구와, gog, mysql, python3 같은 외부 도구를 상황에 맞게 활용할 수 있습니다. 따라서 단순 응답형 비서가 아니라, 실제 운영 업무를 보조하는 실행형 디지털 비서로 이해하면 됩니다.