BRYZE 위키

이 문서는 읽기 전용입니다. 원본을 볼 수는 있지만 바꿀 수는 없습니다. 문제가 있다고 생각하면 관리자에게 문의하세요.
====== 사용가능한 도구 ======

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

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

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

==== 1-1. 파일 읽기 ====
도구 명칭: ''read''

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

활용 예시:
  * AGENTS.md, USER.md, MEMORY.md 같은 운영 문서 확인
  * 저장된 보고서나 메모 파일 읽기

==== 1-2. 파일 쓰기 ====
도구 명칭: ''write''

용도:
  * 새 문서 작성
  * 결과 파일 저장
  * 초안 문서 생성
  * 정리본 작성

활용 예시:
  * 새 운영 문서 작성
  * 분석 결과를 파일로 저장

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

==== 1-3. 파일 수정 ====
도구 명칭: ''edit''

용도:
  * 특정 문장 수정
  * 링크 추가
  * 문단 교체
  * 오타 및 표현 정리

활용 예시:
  * 위키 문서 하단에 새 항목 추가
  * 기존 설명 문구만 부분 수정

==== 1-4. 명령 실행 ====
도구 명칭: ''exec''

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

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

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

==== 1-5. 실행 작업 관리 ====
도구 명칭: ''process''

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

활용 예시:
  * 오래 걸리는 백그라운드 작업 진행 상황 확인

==== 1-6. 웹 검색 ====
도구 명칭: ''web_search''

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

활용 예시:
  * 특정 서비스의 최신 변경사항 확인
  * 공식 문서나 보도자료 탐색

==== 1-7. 웹페이지 읽기 ====
도구 명칭: ''web_fetch''

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

활용 예시:
  * 검색 결과로 찾은 문서의 실제 본문 검토

==== 1-8. 브라우저 ====
도구 명칭: ''browser''

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

활용 예시:
  * 웹 UI 구조 확인
  * 로그인된 브라우저 화면 점검

==== 1-9. 캔버스 ====
도구 명칭: ''canvas''

용도:
  * 화면 표시
  * 화면 내용 확인
  * 시각적 상태 점검

==== 1-10. 메시지 전송 ====
도구 명칭: ''message''

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

활용 예시:
  * 채팅방에 완료 보고 전송
  * 특정 메시지에 반응 추가

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

==== 1-11. 음성 변환 ====
도구 명칭: ''tts''

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

==== 1-12. 기억 검색 ====
도구 명칭: ''memory_search'', ''memory_get''

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

활용 예시:
  * 예전에 정리해둔 기준이나 메모 다시 확인

==== 1-13. 세션 / 보조 에이전트 관리 ====
도구 명칭: ''sessions_spawn'', ''sessions_send'', ''sessions_list'', ''sessions_history'', ''sessions_yield'', ''subagents'', ''agents_list''

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

활용 예시:
  * 긴 조사 작업을 별도 세션에 맡기기
  * 코딩 또는 분석 작업을 분리 실행

==== 1-14. 상태 확인 ====
도구 명칭: ''session_status''

용도:
  * 현재 시간 확인
  * 세션 상태 확인
  * 모델 및 실행 환경 점검

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

==== 2-1. Google Workspace CLI ====
도구 명칭: ''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에 적힌 환경변수와 인증 절차를 따라야 합니다.

==== 2-2. MySQL 조회 ====
도구 명칭: ''mysql''

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

주요 기능:
  * 테이블 조회
  * 조건 검색
  * 집계 조회
  * CSV 추출

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

==== 2-3. Python 스크립트 ====
도구 명칭: ''python3''

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

주요 활용:
  * 텍스트/CSV/엑셀 처리
  * API 호출
  * 자동화 스크립트 작성
  * 데이터 변환 및 가공

관련 라이브러리 예시:
  * ''pandas'' : 표 데이터 처리
  * ''requests'' : 웹/API 요청
  * ''bs4 (BeautifulSoup)'' : HTML 분석
  * ''playwright'' : 브라우저 자동화

==== 2-4. 웹 스크래핑 ====
관련 도구 명칭: ''requests'', ''BeautifulSoup'', ''playwright''

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

주요 기능:
  * HTML 구조 분석
  * 반복 데이터 추출
  * CSV 저장
  * JS 렌더링 페이지 수집

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

==== 2-5. 인스타그램 수집 ====
도구 명칭: ''instagrapi''

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

주요 기능:
  * 게시물 댓글 수집
  * 특정 계정 게시물 수집
  * 해시태그 게시물 수집

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

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

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

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

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

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