내장 도구 참조

이 페이지는 Hermes의 내장 도구를 툴셋별로 정리합니다. 실제 사용 가능 여부는 플랫폼, 자격 증명, 활성화된 툴셋에 따라 달라집니다.

빠른 개수(현재 레지스트리 기준): 약 70개 도구 - core browser 도구 10개 + CDP-gated browser 도구 2개, file 도구 4개, RL 도구 10개, Home Assistant 도구 4개, terminal 도구 2개, web 도구 2개, Feishu 도구 5개, 번들 spotify 플러그인이 등록하는 Spotify 도구 7개, Yuanbao 도구 5개, Kanban dispatcher가 에이전트를 생성할 때 등록되는 Kanban 도구 7개, Discord 도구 2개, 그리고 memory, clarify, delegate_task, execute_code, cronjob, session_search, skill_view/skill_manage/skills_list, text_to_speech, image_generate, vision_analyze, video_analyze, mixture_of_agents, send_message, todo, computer_use, process 같은 독립 도구가 포함됩니다.

MCP 도구

내장 도구 외에도 Hermes는 MCP 서버에서 동적으로 도구를 로드할 수 있습니다. MCP 도구는 mcp_<server>_ 접두사로 표시됩니다. 예를 들어 github MCP 서버의 issue 생성 도구는 mcp_github_create_issue처럼 보입니다. 설정 방법은 MCP 통합을 참고하세요.

browser 툴셋

도구	설명	필요한 환경
browser_back	브라우저 기록에서 이전 페이지로 이동합니다. 먼저 browser_navigate가 호출되어 있어야 합니다.	-
browser_click	스냅샷의 ref ID(예: @e5)로 식별되는 요소를 클릭합니다. ref ID는 스냅샷 출력의 대괄호 안에 표시됩니다. 먼저 browser_navigate와 browser_snapshot이 호출되어 있어야 합니다.	-
browser_console	현재 페이지의 브라우저 콘솔 출력과 JavaScript 오류를 가져옵니다. console.log/warn/error/info 메시지와 잡히지 않은 JS 예외를 반환합니다. 조용히 발생하는 JavaScript 오류, 실패한 API 호출, 앱 경고를 찾을 때 사용합니다.	-
browser_get_images	현재 페이지의 모든 이미지 URL과 alt 텍스트를 나열합니다. vision 도구로 분석할 이미지를 찾을 때 유용합니다. 먼저 browser_navigate가 호출되어 있어야 합니다.	-
browser_navigate	브라우저를 URL로 이동시켜 세션을 초기화하고 페이지를 로드합니다. 다른 브라우저 도구보다 먼저 호출해야 합니다. 단순 정보 조회에는 더 빠르고 저렴한 web_search나 web_extract를 우선 사용하고, 실제 브라우저 상호작용이 필요할 때 browser 도구를 사용하세요.	-
browser_press	키보드 키를 누릅니다. 폼 제출(Enter), 이동(Tab), 키보드 단축키에 유용합니다. 먼저 browser_navigate가 호출되어 있어야 합니다.	-
browser_scroll	페이지를 스크롤합니다. 현재 뷰포트 위아래에 숨어 있는 내용을 드러낼 때 사용합니다. 먼저 browser_navigate가 호출되어 있어야 합니다.	-
browser_snapshot	현재 페이지 접근성 트리의 텍스트 스냅샷을 가져옵니다. browser_click, browser_type에서 사용할 @e1, @e2 같은 ref ID가 포함됩니다. full=false(기본값)는 상호작용 요소 중심의 간결한 보기이고, full=true는 더 완전한 스냅샷입니다.	-
browser_type	ref ID로 지정한 입력 필드에 텍스트를 입력합니다. 먼저 필드를 지우고 새 텍스트를 입력합니다. 먼저 browser_navigate와 browser_snapshot이 호출되어 있어야 합니다.	-
browser_vision	현재 페이지 스크린샷을 찍고 vision AI로 분석합니다. CAPTCHA, 시각 검증 문제, 복잡한 레이아웃, 텍스트 스냅샷만으로 부족한 화면을 이해해야 할 때 사용합니다.	-

browser 툴셋(CDP 게이트 도구)

다음 두 도구는 browser 툴셋에 속하지만, 세션 시작 시 Chrome DevTools Protocol 엔드포인트에 접근할 수 있을 때만 등록됩니다. /browser connect, browser.cdp_url 설정, Browserbase 세션, Camofox가 여기에 해당합니다.

도구	설명	필요한 환경
browser_cdp	원시 Chrome DevTools Protocol 명령을 보냅니다. 상위 수준의 browser_* 도구로 다룰 수 없는 브라우저 작업을 위한 탈출구입니다. https://chromedevtools.github.io/devtools-protocol/ 를 참고하세요.	CDP 엔드포인트
browser_dialog	네이티브 JavaScript dialog(alert / confirm / prompt / beforeunload)에 응답합니다. 먼저 browser_snapshot을 호출하세요. 대기 중인 dialog는 pending_dialogs 필드에 표시됩니다. 이후 browser_dialog(action='accept'|'dismiss')를 호출합니다.	CDP 엔드포인트

clarify 툴셋

도구	설명	필요한 환경
clarify	진행 전에 사용자의 확인, 피드백, 결정이 필요할 때 질문합니다. 두 모드를 지원합니다. 1. 객관식 - 최대 4개 선택지를 제공하고, 사용자는 하나를 고르거나 5번째 "Other" 옵션으로 직접 답할 수 있습니다. 2. 자유 응답 질문.	-

code_execution 툴셋

도구	설명	필요한 환경
execute_code	Hermes 도구를 프로그래밍 방식으로 호출할 수 있는 Python 스크립트를 실행합니다. 3개 이상의 도구 호출 사이에 처리 로직이 필요하거나, 큰 도구 출력을 컨텍스트에 넣기 전에 필터링/축약해야 하거나, 조건 분기가 필요할 때 사용합니다.	-

cronjob 툴셋

도구	설명	필요한 환경
cronjob	통합 예약 작업 관리자입니다. action="create", "list", "update", "pause", "resume", "run", "remove"로 작업을 관리합니다. 하나 이상의 스킬이 첨부된 스킬 기반 작업을 지원하며, update에서 skills=[]를 보내면 첨부 스킬을 지웁니다. cron run은 현재 채팅 컨텍스트 없이 새 세션에서 실행됩니다.	-

delegation 툴셋

도구	설명	필요한 환경
delegate_task	하나 이상의 서브에이전트를 생성해 격리된 컨텍스트에서 작업하게 합니다. 각 서브에이전트는 자신의 대화, 터미널 세션, 툴셋을 가집니다. 최종 요약만 반환되며, 중간 도구 결과는 부모 컨텍스트 창에 들어오지 않습니다.	-

feishu_doc 툴셋

Feishu 문서 댓글 지능형 응답 핸들러(gateway/platforms/feishu_comment.py)에만 범위가 제한됩니다. hermes-cli나 일반 Feishu 채팅 어댑터에는 노출되지 않습니다.

도구	설명	필요한 환경
feishu_doc_read	파일 유형과 토큰으로 Feishu/Lark 문서(Docx, Doc, Sheet)의 전체 텍스트 내용을 읽습니다.	Feishu 앱 자격 증명

feishu_drive 툴셋

Feishu 문서 댓글 핸들러에만 범위가 제한됩니다. Drive 파일의 댓글 읽기/쓰기 작업을 수행합니다.

도구	설명	필요한 환경
feishu_drive_add_comment	Feishu/Lark 문서 또는 파일에 최상위 댓글을 추가합니다.	Feishu 앱 자격 증명
feishu_drive_list_comments	Feishu/Lark 파일의 문서 전체 댓글을 최신순으로 나열합니다.	Feishu 앱 자격 증명
feishu_drive_list_comment_replies	특정 Feishu 댓글 스레드의 답글 목록을 나열합니다. 문서 전체 또는 로컬 선택 영역을 지원합니다.	Feishu 앱 자격 증명
feishu_drive_reply_comment	선택적 @ 멘션과 함께 Feishu 댓글 스레드에 답글을 게시합니다.	Feishu 앱 자격 증명

file 툴셋

도구	설명	필요한 환경
patch	파일에 대상 지정 find-and-replace 편집을 적용합니다. 터미널에서 sed/awk를 쓰는 대신 사용하세요. 퍼지 매칭 전략을 사용해 작은 공백/들여쓰기 차이로 실패하지 않도록 돕습니다. 편집 후 unified diff를 반환하고 구문 검사를 자동 실행합니다.	-
read_file	줄 번호와 페이지네이션이 포함된 텍스트 파일을 읽습니다. cat/head/tail 대신 사용하세요. 대용량 파일에는 offset과 limit을 사용합니다. 이미지는 읽을 수 없습니다.	-
search_files	파일 내용을 검색하거나 파일 이름으로 찾습니다. 터미널의 grep/rg/find/ls 대신 사용할 수 있습니다. ripgrep 기반이며, content 검색에서는 파일 내 regex 검색을 지원합니다.	-
write_file	파일 내용을 완전히 새로 씁니다. 터미널에서 echo/cat heredoc을 쓰는 대신 사용합니다. 부모 디렉터리를 자동 생성합니다. 전체 파일을 덮어쓰므로, 대상 지정 편집에는 patch를 사용하세요.	-

homeassistant 툴셋

도구	설명	필요한 환경
ha_call_service	Home Assistant service를 호출해 장치를 제어합니다. 먼저 ha_list_services로 사용 가능한 service와 매개변수를 확인하세요.	-
ha_get_state	밝기, 색상, 온도 설정, 센서 값 등 모든 attribute를 포함해 단일 Home Assistant entity의 상세 상태를 가져옵니다.	-
ha_list_entities	Home Assistant entity를 나열합니다. domain(light, switch, climate, sensor, binary_sensor, cover, fan 등) 또는 area name(거실, 부엌, 침실 등)으로 필터링할 수 있습니다.	-
ha_list_services	장치 제어에 사용할 수 있는 Home Assistant service(action)를 나열합니다. 각 장치 유형에서 가능한 action과 매개변수를 보여줍니다.	-

computer_use 툴셋

도구	설명	필요한 환경
computer_use	cua-driver를 통한 백그라운드 macOS 데스크톱 제어입니다. screenshot(SOM / vision / AX), click, drag, scroll, type, key, wait, list_apps, focus_app을 지원합니다. 사용자의 cursor나 keyboard focus를 훔치지 않습니다. 도구 사용 가능 모델이면 사용할 수 있습니다. macOS 전용입니다.	$PATH의 cua-driver(hermes tools로 설치)

노트

Honcho 도구(honcho_profile, honcho_search, honcho_context, honcho_reasoning, honcho_conclude)는 더 이상 내장 도구가 아닙니다. plugins/memory/honcho/의 Honcho memory provider plugin을 통해 사용할 수 있습니다. 설치와 사용법은 메모리 제공자를 참고하세요.

image_gen 툴셋

도구	설명	필요한 환경
image_generate	FAL.ai를 사용해 텍스트 프롬프트에서 고품질 이미지를 생성합니다. 실제 모델은 사용자 설정을 따르며(기본값: FLUX 2 Klein 9B, 1초 미만 생성), 에이전트가 선택하지 않습니다. 단일 이미지 URL을 반환합니다.	FAL_KEY

kanban 툴셋

Kanban 디스패처가 에이전트를 생성하고 HERMES_KANBAN_TASK 환경 변수가 설정된 경우에만 등록됩니다. 워커는 구조화된 인계 정보로 작업 완료를 표시하고, 사용자 입력을 기다리며, 긴 작업 중 하트비트를 보내고, 스레드에 댓글을 남길 수 있습니다. 오케스트레이터는 하위 작업을 생성할 수 있습니다. 전체 흐름은 Kanban Multi-Agent를 참고하세요.

도구	설명	필요한 환경
kanban_show	이 워커에게 할당된 활성 Kanban 작업(title, description, comments, dependencies)을 표시합니다.	HERMES_KANBAN_TASK
kanban_complete	results, artifacts, follow-ups가 포함된 구조화 인계 payload로 현재 작업을 완료 표시합니다.	HERMES_KANBAN_TASK
kanban_block	사용자 질문 때문에 현재 작업을 blocked 상태로 전환합니다. 디스패처가 일시 중지하고 질문을 표시한 뒤, 사람이 답하면 재개합니다.	HERMES_KANBAN_TASK
kanban_heartbeat	장시간 작업 중 진행 하트비트를 보내 디스패처가 워커가 살아 있음을 알 수 있게 합니다.	HERMES_KANBAN_TASK
kanban_comment	상태를 바꾸지 않고 작업 스레드에 댓글을 추가합니다. 중간 발견을 남길 때 유용합니다.	HERMES_KANBAN_TASK
kanban_create	오케스트레이터 전용. 현재 작업에서 하위 작업을 팬아웃합니다.	HERMES_KANBAN_TASK + 오케스트레이터 역할
kanban_link	오케스트레이터 전용. 관련 작업을 blocks/blocked-by/related 관계로 연결합니다.	HERMES_KANBAN_TASK + 오케스트레이터 역할

memory 툴셋

도구	설명	필요한 환경
memory	세션 사이에서도 유지되는 영구 메모리에 중요한 정보를 저장합니다. 메모리는 세션 시작 시 시스템 프롬프트에 포함되며, 사용자와 환경에 대한 장기 정보를 기억하는 방식입니다.	-

messaging 툴셋

도구	설명	필요한 환경
send_message	연결된 메시징 플랫폼으로 메시지를 보내거나 사용 가능한 대상 목록을 조회합니다. 사용자가 특정 채널/사람에게 보내라고 요청하면, 플랫폼 이름만 지정한 경우가 아니라면 먼저 send_message(action='list')로 유효한 대상을 확인하세요.	-

moa 툴셋

도구	설명	필요한 환경
mixture_of_agents	어려운 문제를 여러 frontier LLM이 협업해 풀도록 라우팅합니다. 최대 reasoning effort로 5번의 API 호출(참조 모델 4개 + 집계 모델 1개)을 사용하므로, 복잡한 수학이나 고급 알고리즘처럼 정말 어려운 문제에 제한적으로 사용하세요.	OPENROUTER_API_KEY

session_search 툴셋

도구	설명	필요한 환경
session_search	과거 대화의 장기 기억을 검색합니다. 이전 세션 전체를 검색할 수 있으며, 결과는 요약으로 제공됩니다. 사용자가 "전에 이거 했었지", "기억해?", "지난번에..."처럼 말할 때 적극적으로 사용합니다.	-

skills 툴셋

도구	설명	필요한 환경
skill_manage	스킬을 생성, 업데이트, 삭제합니다. 스킬은 반복 작업 유형을 위한 절차적 메모리입니다. 새 스킬은 ~/.hermes/skills/에 저장되고, 기존 스킬은 실제 위치에서 수정할 수 있습니다.	-
skill_view	특정 작업이나 워크플로에 대한 정보, scripts, templates를 포함한 스킬 내용을 로드합니다. 스킬 전체 또는 연결 파일(references, templates, scripts)에 접근할 수 있습니다.	-
skills_list	사용 가능한 스킬 목록을 이름과 설명으로 나열합니다. 전체 내용을 보려면 skill_view(name)을 사용합니다.	-

terminal 툴셋

도구	설명	필요한 환경
process	terminal(background=true)로 시작한 백그라운드 프로세스를 관리합니다. action은 list, poll, log, wait, kill, write를 지원합니다.	-
terminal	Linux 환경에서 셸 명령을 실행합니다. 파일 시스템은 호출 사이에 유지됩니다. 장시간 실행 서버에는 background=true를 설정하세요. background=true와 함께 notify_on_complete=true를 설정하면 프로세스 완료 시 자동 알림을 받을 수 있습니다. cat/head/tail 대신 read_file을, grep/rg/find 대신 search_files를 사용하는 것이 권장됩니다.	-

todo 툴셋

도구	설명	필요한 환경
todo	현재 세션의 작업 목록을 관리합니다. 3단계 이상의 복잡한 작업이나 사용자가 여러 작업을 제시한 경우 사용합니다. 인수 없이 호출하면 현재 목록을 읽고, todos 배열을 제공하면 생성/업데이트합니다.	-

vision 툴셋

도구	설명	필요한 환경
vision_analyze	AI vision으로 이미지를 분석합니다. 이미지 내용에 대한 포괄적 설명을 제공하고 특정 질문에 답합니다.	-

video 툴셋

옵트인 도구입니다. 기본 hermes-cli 세트에는 로드되지 않습니다. --toolsets video로 추가하거나 config의 toolsets:에 video를 포함하세요.

도구	설명	필요한 환경
video_analyze	URL 또는 파일 경로의 비디오 콘텐츠를 분석합니다. 캡션, 장면 분석, 주요 타임스탬프, 시각적 설명을 제공합니다.	-

web 툴셋

도구	설명	필요한 환경
web_search	웹 정보를 검색합니다. 기본적으로 title, URL, description이 포함된 결과를 최대 5개 반환합니다. 선택적 limit(1-100, 기본 5)을 받습니다. query는 설정된 백엔드로 전달되며, 백엔드가 지원하면 site:domain, filetype:pdf, intitle:word, -term, "exact phrase" 같은 연산자가 동작할 수 있습니다.	EXA_API_KEY 또는 PARALLEL_API_KEY 또는 FIRECRAWL_API_KEY 또는 TAVILY_API_KEY
web_extract	웹 페이지 URL에서 콘텐츠를 추출합니다. 페이지 내용을 Markdown 형식으로 반환합니다. PDF URL도 직접 전달할 수 있으며 Markdown 텍스트로 변환합니다. 5000자 미만 페이지는 전체 Markdown을 반환하고, 더 큰 페이지는 LLM 요약을 사용합니다.	EXA_API_KEY 또는 PARALLEL_API_KEY 또는 FIRECRAWL_API_KEY 또는 TAVILY_API_KEY

tts 툴셋

도구	설명	필요한 환경
text_to_speech	텍스트를 음성 오디오로 변환합니다. 플랫폼이 음성 메시지로 전달할 MEDIA: 경로를 반환합니다. Telegram에서는 음성 말풍선으로, Discord/WhatsApp에서는 오디오 첨부파일로 전달됩니다. CLI 모드에서는 ~/voice-memos/에 저장합니다.	-

discord 툴셋

hermes-discord 플랫폼 툴셋에 등록됩니다. 메시징 어댑터와 같은 봇 토큰을 사용합니다.

도구	설명	필요한 환경
discord	Discord 서버를 읽고 참여합니다. search_members, fetch_messages, send_message, react, fetch_channel, list_channels 등의 action을 포함합니다.	DISCORD_BOT_TOKEN

discord_admin 툴셋

hermes-discord 플랫폼 툴셋에 등록됩니다. 모더레이션 작업에는 봇이 해당 Discord 권한을 가지고 있어야 합니다.

도구	설명	필요한 환경
discord_admin	REST API로 Discord 서버를 관리합니다. guild/channel/role 목록 조회, channel 생성/수정/삭제, role grant 관리, timeout, kick, ban을 지원합니다.	DISCORD_BOT_TOKEN + 봇 권한

spotify 툴셋

번들 spotify 플러그인이 등록합니다. OAuth 토큰이 필요하며, 한 번 hermes spotify setup을 실행해 인증해야 합니다.

도구	설명	필요한 환경
spotify_playback	Spotify 재생을 제어하고, 활성 재생 상태를 확인하거나 최근 재생 트랙을 가져옵니다.	Spotify OAuth
spotify_devices	Spotify Connect 기기를 나열하거나 재생을 다른 기기로 전송합니다.	Spotify OAuth
spotify_queue	사용자의 Spotify 큐를 확인하거나 항목을 추가합니다.	Spotify OAuth
spotify_search	트랙, 앨범, 아티스트, 플레이리스트, 쇼, 에피소드를 Spotify 카탈로그에서 검색합니다.	Spotify OAuth
spotify_playlists	Spotify 플레이리스트를 나열, 검사, 생성, 업데이트, 수정합니다.	Spotify OAuth
spotify_albums	Spotify 앨범 메타데이터 또는 앨범 트랙을 가져옵니다.	Spotify OAuth
spotify_library	사용자의 저장된 Spotify 트랙 또는 앨범을 나열, 저장, 제거합니다.	Spotify OAuth

hermes-yuanbao 툴셋

hermes-yuanbao 플랫폼 툴셋에서만 등록됩니다. Yuanbao는 Tencent의 채팅 앱이며, 이 도구들은 DM/그룹/스티커 API를 다룹니다.

도구	설명	필요한 환경
yb_query_group_info	그룹의 기본 정보(앱에서는 "派/Pai"라고 부름)를 조회합니다. 이름, 소유자, 멤버 수를 포함합니다.	Yuanbao 자격 증명
yb_query_group_members	그룹 멤버를 조회합니다. @ 멘션, 이름으로 사용자 찾기, 봇 목록 확인에 사용합니다.	Yuanbao 자격 증명
yb_send_dm	그룹 안의 사용자에게 선택적 미디어 파일과 함께 비공개/직접 메시지를 보냅니다.	Yuanbao 자격 증명
yb_search_sticker	내장 Yuanbao 스티커(TIM face) 카탈로그를 키워드로 검색합니다.	Yuanbao 자격 증명
yb_send_sticker	현재 Yuanbao 채팅에 내장 스티커를 보냅니다.	Yuanbao 자격 증명