Agno는 도구가 쉬울수록 빨라지고 원격 Mac에는 OpenClaw로 화이트리스트·타임아웃·서킷·실패 요약 JSON 신뢰 경계를 먼저 닫아야 합니다.
바로가기: 통증 · 매트릭스 · 선검사 · JSON · 절차 · 트러블 · 수치 · FAQ
Agno·OpenAI Agents SDK M4·PydanticAI 게이트·Strands 게이트웨이와 교차 참고하세요. 공개: 문서·요금·구매.
통증 세 줄
1 로컬만 새 도구 이름이면 감사 단선. 2 거대 HTTP 한 줄이면 어디가 멈췄는지 불명. 3 서킷 없으면 재시도가 통합 메모리를 찍습니다.
배치 매트릭스
| 층 | Agno | 게이트웨이 |
|---|---|---|
| 도구 | 콜러블·인자 가공 | 허용 이름·인증·초안 등록 |
| 시간 | 클라이언트 데드라인을 퓨즈보다 김 | 검증·실행·대기 상한·쿨다운 |
| 실패 | 봉투로 분기 | 상관·단계·코드·힌트 |
선검사: openclaw doctor
연결 전 openclaw doctor --json을 관문으로 삼고 출력을 버전 옆에 아카이브하세요. 경로·토큰 권한·선택 구성을 비우고 맥OS·venv·홈브류 변경 뒤에는 원격 Mac에서 다시 돌려 매니페스트와 불일치 시 배포를 막습니다.
운영 컷오버 직전에 한 번 더 돌려 경고가 남아 있으면 Agno 베이스 URL을 붙이지 말고 티켓으로 되돌리세요. 살아 있는 트래픽에서 반쪽 허용 목록을 고치는 비용이 훨씬 큽니다.
JSON 조각(비밀은 저장소 밖)
베어러는 chmod 600 또는 시크릿 매니저·환경 변수만. 형태 예시입니다.
허용 도구와 초안 핸들
{
"version": 1,
"tools": [
{ "name": "read_repo_file", "argsSchemaRef": "schemas/read_repo_file.json" },
{ "name": "append_audit_log", "argsSchemaRef": "schemas/append_audit_log.json" }
],
"denyUnknownToolNames": true
}타임아웃 퓨즈와 서킷 정책
{
"validateTimeoutMs": 8000,
"executeTimeoutMs": 52000,
"clientHintTimeoutMs": 60000,
"breaker": { "openAfterFailures": 3, "cooldownSeconds": 30 }
}Agno로 돌려보내는 실패 요약 봉투
{
"ok": false,
"correlationId": "req_01hzzexample",
"stage": "validate",
"code": "schema_timeout",
"pointer": "/items/0/title",
"hint": "페이로드를 줄이거나 도구 배치를 나누세요."
}재현 절차
- 노드·파이썬 venv 핀과 SSD 스크래치 경로를 기록합니다.
openclaw doctor --json후 경고 없이127.0.0.1·저장소 밖 토큰으로 게이트웨이를 띄웁니다.- 역터널만 허용하고 공인 인그레스·대시보드 토큰을 저장소에 두지 않습니다.
- 기동 시 Agno 레지스트리와 JSON 허용 목록을 비교해 불일치면 비영 종료합니다.
- Agno HTTP 데드라인을 실행 퓨즈보다 길게 잡고 JSONL을 켭니다.
- 전송·검증·서킷·오류를 짧은 봉투 JSON으로 매핑합니다.
- 정상·스키마 위반·느린 상류 스모크로 퓨즈 순서와 카운터를 확인합니다.
트러블슈팅
- 스트리밍 중 서킷: 구조화 실패도 집계되니 검증 끄지 말고 스키마를 조정합니다.
- 업그레이드 후 도구 소실: 매니페스트를 새 기본값과 diff합니다.
인용 수치
- 분 단위 클라이언트면 검증 퓨즈 여덟 초 이하가 현실적입니다.
- 연속 세 번 실패 후 서킷·삼십 초 쿨다운 후 반개 프로브.
- JSONL 샤드 이백 메가 넘으면 압축합니다.
FAQ
로컬 검증? 속도용으로 두되 권위는 게이트웨이입니다.
재시도? 필드 수선은 한두 번, 백오프는 OpenClaw.
요약: doctor·허용 목록·계단 타임아웃·서킷·봉투로 원격 Mac Agno를 고정합니다.