빠른 답변
OpenClaw에 웹페이지 리더 API를 추가하려면 어떻게 하나요?
WebReaderAPI MCP 서버를 저장한 다음 openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=…로 등록하고 openclaw mcp doctor --probe로 확인하세요. 에이전트는 내장 web_fetch 옆에 read_url 툴을 갖게 되어 JavaScript를 렌더링하고 PDF를 읽을 수 있습니다. 페이지당 1크레딧이며, 2026년 10월 기준 US$0.07/1K 페이지부터 시작합니다. KYC 없이, 암호화폐로 결제합니다.
OpenClaw의 web_fetch와 read_url 비교
| web_fetch (내장) | 로컬에서 실행되며 Readability로 본문을 추출하고 Markdown 또는 텍스트를 반환 |
|---|---|
| web_fetch 제한 | JavaScript 실행 없음, 기본 및 상한 maxChars 20,000자 (OpenClaw 문서) |
| read_url (저희 MCP 툴) | 필요 시 JavaScript 렌더링, 최대 100페이지 PDF, 최대 500,000자 |
| read_url 비용 | 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다 |
| 저희 크롤러 | WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), robots.txt 준수 |
| 도구 프로필 | MCP 도구는 coding 및 messaging 프로필에 나타나며 minimal에는 나타나지 않습니다 |
OpenClaw에 web_fetch가 있는데 왜 리더를 추가해야 하나요?
서로 다른 페이지를 다루기 때문입니다. OpenClaw 문서에 따르면 web_fetch는 항상 로컬에서 실행되고, 본문 추출에 Readability를 사용하며, JavaScript를 실행하지 않습니다. JavaScript가 많은 사이트나 로그인이 필요한 사이트에는 Web Browser 도구를 사용하라고 안내합니다. maxChars 설정의 기본값은 20,000자이며 그 이상은 제한됩니다.
빠르고 가벼운 페이지에는 web_fetch를 그대로 사용하세요. JavaScript로 콘텐츠를 만드는 페이지, PDF, 20,000자보다 긴 문서에는 read_url를 추가하세요. OpenClaw 문서는 또한 공식 Firecrawl 플러그인이 현재 web_fetch가 대체(fallback)로 사용할 수 있는 유일한 번들 제공자라고 언급합니다.
OpenClaw에 MCP 서버를 어떻게 등록하나요?
먼저 MCP 페이지에서 Python 서버를 설정하세요. 파일 하나에 mcp과 httpx 패키지가 필요합니다. 그다음 OpenClaw에 openclaw mcp add로 저장하세요. OpenClaw의 레지스트리 문서에는 stdio 플래그 --command, --arg, --env, --cwd이 설명되어 있으며, 저장된 정의는 설정의 mcp.servers 아래에 보관됩니다.
이후 openclaw mcp doctor --probe를 실행하세요. --probe 없이는 doctor가 저장된 설정만 확인하지만, 함께 사용하면 활성화된 서버가 연결되는지도 확인합니다.
openclaw mcp add webreaderapi \
--command /home/you/webreader/.venv/bin/python \
--arg /home/you/webreader/webreader_mcp.py \
--env WEBREADER_API_KEY=your-key
openclaw mcp doctor webreaderapi --probe에이전트가 read_url을 볼 수 있나요?
일반적인 프로필에서는 볼 수 있습니다. OpenClaw의 레지스트리 문서에 따르면 내장 OpenClaw는 설정된 MCP 도구를 coding 및 messaging 프로필에서 노출합니다. minimal 프로필은 이 도구를 숨기고 tools.deny: ["bundle-mcp"]는 비활성화하므로, 도구가 나타나지 않으면 이 두 설정을 확인하세요.
도구 설명은 모델에게 언제 이 도구를 우선할지 알려줍니다. JavaScript가 필요한 페이지, PDF, 긴 문서가 그 경우입니다. 그 외에는 모델이 web_fetch를 계속 사용할 수 있습니다.
read_url은 읽는 사이트를 어떻게 처리하나요?
우리 API에 대한 모든 호출과 동일한 방식입니다. 우리는 robots.txt를 준수합니다. 크롤러는 WebReaderAPI로 자신을 식별하고, 자신 또는 모든 로봇을 위해 작성된 규칙을 따르며, 사이트가 허용하지 않은 페이지는 읽지 않습니다. 거부된 페이지는 과금되지 않습니다. 사이트가 robots.txt에 Content-Signal: ai-input=no를 선언하면, 해당 페이지를 대신 읽지 않습니다. 사이트가 우리 요청을 거부하면 그 응답을 그대로 반환합니다. 우리는 CAPTCHA를 풀거나, 계정에 로그인하거나, 차단이나 페이월을 우회하려 시도하지 않습니다.
따라서 로그인 뒤에 있는 페이지는 read_url의 범위 밖입니다. 로그인한 사이트에는 세션과 함께 실행되는 OpenClaw 자체 브라우저 도구가 적합합니다.
OpenClaw를 통해 페이지를 읽으면 비용이 얼마인가요?
콘텐츠가 반환된 페이지 하나당 1크레딧, 브라우저가 필요하면 2크레딧, 거부와 오류에는 비용이 없습니다. 채팅 채널 전반에서 하루 30페이지를 읽는 어시스턴트는 월 약 900크레딧을 사용합니다. 10,000페이지(US$3.75)이면 거의 1년 동안 사용할 수 있습니다. 선불 크레딧은 만료되지 않습니다. 사용하지 않은 페이지는 사용할 때까지 계정에 남아 있습니다.
OpenClaw에 별도의 API 키를 부여하여 다른 프로젝트와 사용량이 구분되게 하세요.
OpenClaw: 자주 묻는 질문
WebReaderAPI는 OpenClaw의 내장 제공자인가요?
아닙니다. 플러그인 코드 없이도 OpenClaw가 지원하는 MCP 서버로 연결됩니다. MCP 서버는 MCP 페이지의 짧은 Python 파일입니다.
web_fetch를 비활성화해야 하나요?
그럴 필요 없습니다. 두 도구 모두 켜 둘 수 있으며, 설명이 모델에게 어느 것이 적합한지 알려줍니다. 모든 읽기를 한 곳에서 로깅하려는 경우에만 web_fetch를 비활성화하세요.
OpenClaw 웹 인터페이스에서 서버를 관리할 수 있나요?
OpenClaw 문서에는 Control UI의 MCP 설정이 설명되어 있으며, 이는 명령 줄과 동일한 저장된 정의를 편집합니다. 편한 방법을 사용하세요.
샌드박스된 OpenClaw 환경에서도 작동하나요?
MCP 서버는 https://webreaderapi.com/api/v1/read에 접속하려면 인터넷 접근이 필요한 로컬 프로세스입니다. 샌드박스가 이 프로세스를 시작하고 해당 HTTPS 호출을 허용하는지 확인하세요.
출처 (4)
- 웹 도구 — OpenClaw docs (read 2026-10-22)
- Web Fetch — OpenClaw docs (read 2026-10-22)
- 저장된 MCP 서버 관리 — OpenClaw docs (read 2026-10-22)
- Control UI의 MCP — OpenClaw docs (read 2026-10-22)