{
  "schemaVersion": "1.0",
  "item": {
    "slug": "raon-os",
    "name": "Raon OS",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/lifeissea/raon-os",
    "canonicalUrl": "https://clawhub.ai/lifeissea/raon-os",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/raon-os",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=raon-os",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/raon-os"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/raon-os",
    "agentPageUrl": "https://openagent3.xyz/skills/raon-os/agent",
    "manifestUrl": "https://openagent3.xyz/skills/raon-os/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/raon-os/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "설치 요구사항",
        "body": "Python 3.9+ (macOS 기본 내장, 별도 설치 불필요)\nNode.js 18+ (npx @yeomyeonggeori/raon-os 실행용)\nLLM API 키 (아래 중 하나, 우선순위 순):\n\n환경변수설명비고OPENROUTER_API_KEY1순위 — OpenClaw 지원 모든 모델추천GEMINI_API_KEY2순위 — Google Gemini + 임베딩ANTHROPIC_API_KEY3순위 — ClaudeOPENAI_API_KEY4순위 — GPT + 임베딩Ollama 로컬자동 감지 (키 없을 때)선택 — raon.sh install-model\n\n벡터 검색: GEMINI_API_KEY 또는 OPENAI_API_KEY 있으면 자동 활성화. 없으면 BM25 키워드 검색으로 동작."
      },
      {
        "title": "빠른 시작",
        "body": "# 1. OpenClaw 설치\nnpm install -g openclaw\n\n# 2. 스킬 설치\nopenclaw skill install @yeomyeonggeori/raon-os\n\n# 3. API 키 설정 (권장: OpenRouter)\necho \"OPENROUTER_API_KEY=your-openrouter-key\" >> ~/.openclaw/.env\nchmod 600 ~/.openclaw/.env  # 보안: 소유자만 읽기/쓰기\n\n# 4. 모델 override (선택) — 기본은 프로바이더별 최적 모델 자동 선택\necho \"RAON_MODEL=anthropic/claude-opus-4-5\" >> ~/.openclaw/.env\n\n# 5. 연결 테스트\npython3 scripts/raon_llm.py --detect"
      },
      {
        "title": "LLM 설정 (raon_llm.py)",
        "body": "모든 API 키는 ~/.openclaw/.env 에 저장 (환경변수 우선):\n\n# ~/.openclaw/.env 예시\nOPENROUTER_API_KEY=<your-key>   # 1순위 (추천)\nGEMINI_API_KEY=<your-key>          # 2순위 + 임베딩\nANTHROPIC_API_KEY=<your-key>       # 3순위\nOPENAI_API_KEY=<your-key>              # 4순위 + 임베딩\nRAON_MODEL=google/gemini-2.5-flash  # 모델 강제 지정 (선택)\nRAON_LLM_PROVIDER=openrouter       # 프로바이더 강제 지정 (선택)\n\n스타트업 파운더를 위한 AI 동료. 아이디어를 사업으로 만드는 전 과정을 지원한다."
      },
      {
        "title": "1. biz-plan — 사업계획서 평가",
        "body": "사업계획서(PDF/텍스트)를 분석하여 점수 + 개선안을 제공한다.\n\n# PDF 평가\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf\n\n# 텍스트 평가\n{baseDir}/scripts/raon.sh biz-plan evaluate --text \"사업 아이디어 설명...\"\n\n# JSON 형식 출력\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf --json\n\n# 결과를 파일로 저장\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf --output result.md\n\n# 두 사업계획서 비교 분석\n{baseDir}/scripts/raon.sh biz-plan evaluate --file plan_a.pdf --file plan_b.pdf\n\n# 개선안 생성\n{baseDir}/scripts/raon.sh biz-plan improve --file /path/to/plan.pdf\n\n# 평가 히스토리 조회\n{baseDir}/scripts/raon.sh history\n\n평가 항목:\n\n문제 정의 및 솔루션 적합성\n시장 규모 및 경쟁 분석\n비즈니스 모델 타당성\n팀 역량\n재무 계획\n기술 차별성\n\n출력: 100점 만점 종합 점수 + 항목별 점수 + 구체적 개선 제안"
      },
      {
        "title": "2. gov-funding — 정부 지원사업 매칭",
        "body": "스타트업 프로필 기반으로 적합한 정부 지원사업을 추천한다.\n\n# 매칭 (사업계획서 기반)\n{baseDir}/scripts/raon.sh gov-funding match --file /path/to/plan.pdf\n\n# 매칭 (키워드 기반)\n{baseDir}/scripts/raon.sh gov-funding match --industry \"AI/SaaS\" --stage \"early\" --region \"서울\"\n\n# 지원사업 상세 정보\n{baseDir}/scripts/raon.sh gov-funding info --program \"TIPS\"\n\n# 지원서 초안 생성\n{baseDir}/scripts/raon.sh gov-funding draft --program \"TIPS\" --file /path/to/plan.pdf\n\n# 지원 준비 체크리스트\n{baseDir}/scripts/raon.sh gov-funding checklist --program \"TIPS\" --file /path/to/plan.pdf\n\n지원 프로그램: TIPS, K-Startup 그랜드챌린지, 창업성장기술개발, 예비창업패키지, 초기창업패키지 등"
      },
      {
        "title": "3. investor-match — 투자자 매칭 (추후 연동)",
        "body": "스타트업 단계/산업에 맞는 투자자를 추천한다.\n\n# 투자자 추천\n{baseDir}/scripts/raon.sh investor-match --stage \"pre-a\" --industry \"AI\" --amount \"1M\""
      },
      {
        "title": "PDF 처리 (중요)",
        "body": "사용자가 PDF를 직접 보내면 바이너리가 프롬프트에 들어가 토큰 한도를 초과한다.\n반드시 텍스트 추출 후 평가해야 한다.\n\n# 방법 1: evaluate.py가 내부에서 PDF 텍스트 추출\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf\n\n# 방법 2: 전처리 스크립트\nscripts/pdf-evaluate.sh /path/to/plan.pdf\n\nOpenClaw에서 PDF 파일이 첨부된 경우:\n\nPDF가 media/inbound/에 저장됨\nPDF를 프롬프트에 인라인하지 말 것 (토큰 폭발)\nexec 도구로 evaluate.py --file <경로>를 실행하여 평가\n결과를 사용자에게 전달"
      },
      {
        "title": "사용 흐름",
        "body": "일반적인 파운더 여정:\n\n1. \"내 사업계획서 평가해줘\" → biz-plan evaluate\n2. \"어떻게 고치면 돼?\" → biz-plan improve\n3. \"이걸로 지원할 수 있는 정부사업 있어?\" → gov-funding match\n4. \"TIPS 지원서 초안 만들어줘\" → gov-funding draft\n5. \"투자자도 연결해줘\" → investor-match"
      },
      {
        "title": "Investor Match",
        "body": "raon.sh investor-match profile --file <pdf>\n# or\ncurl -X POST http://localhost:8400/v1/investor ...\n\n투자자 관점에서 사업계획서를 분석하고 매력도 프로필을 생성한다.\n\nDeal Summary (1분 요약)\n타겟 투자자 유형 (Seed/Pre-A, Sector)\nInvestment Highlights & Red Flags\n피칭 팁"
      },
      {
        "title": "HTTP API 서버",
        "body": "로컬 REST API 서버를 띄워 웹챗이나 외부 서비스에서 연동할 수 있다:\n\nraon.sh serve           # 기본 포트 8400\nraon.sh serve 9000      # 커스텀 포트\n\n엔드포인트:\n\nGET /health — 헬스체크\nGET /v1/modes — 지원 모드 목록\nPOST /v1/evaluate — 사업계획서 평가\nPOST /v1/improve — 사업계획서 개선\nPOST /v1/match — 정부 지원사업 매칭\nPOST /v1/draft — 지원서 초안 (program 필수)\nPOST /v1/checklist — 지원 준비 점검 (program 필수)\nPOST /v1/investor — 투자자 프로필 분석\n\n요청 예시:\n\ncurl -X POST http://localhost:8400/v1/evaluate \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"사업계획서 내용...\"}'\n\nCORS 지원됨 (웹 프론트엔드 연동 가능)."
      },
      {
        "title": "API 연동",
        "body": "현재 버전은 로컬 분석 (LLM 기반 RAG)으로 동작한다.\nK-Startup AI API 연동 시 환경변수 설정:\n\nexport RAON_API_URL=\"https://api.k-startup.ai\"\nexport RAON_API_KEY=\"your-api-key\"\n\nAPI가 설정되지 않으면 로컬 LLM + RAG 파이프라인으로 폴백한다."
      },
      {
        "title": "평가 기준 참고",
        "body": "정부 지원사업별 심사 기준은 references/ 디렉토리 참조:\n\nreferences/tips-criteria.md — TIPS 심사 기준\nreferences/gov-programs.md — 주요 정부 지원사업 목록 및 자격 요건"
      },
      {
        "title": "Credential Protection",
        "body": "모든 API 키는 ~/.openclaw/.env에 저장 (chmod 600 권장)\n패키지에 실제 키값은 절대 포함되지 않음"
      },
      {
        "title": "Data Transmission",
        "body": "기본 모드 (로컬): 모든 데이터가 로컬에서 처리됨 (Ollama LLM + 로컬 RAG)\nSaaS 모드 (RAON_API_URL 설정 시): 평가 요청/PDF 텍스트가 해당 서버로 전송됨\n\n⚠️ 신뢰할 수 있는 엔드포인트만 설정하세요\n\n\nSupabase (SUPABASE_URL 설정 시): 피드백/사용량 데이터가 저장됨\n\nSUPABASE_SERVICE_KEY는 고권한 키이므로 신중히 설정"
      },
      {
        "title": "Server Security",
        "body": "/api/keys/* 엔드포인트는 localhost 전용 (관리자 API)\n외부 노출 시 반드시 nginx 리버스 프록시 + 접근 제어 사용\n카카오 웹훅: HTTP 200 반환은 카카오 플랫폼 요구사항 (재시도 방지)"
      }
    ],
    "body": "Raon OS — Startup Companion (v0.7.10)\n설치 요구사항\nPython 3.9+ (macOS 기본 내장, 별도 설치 불필요)\nNode.js 18+ (npx @yeomyeonggeori/raon-os 실행용)\nLLM API 키 (아래 중 하나, 우선순위 순):\n환경변수\t설명\t비고\nOPENROUTER_API_KEY\t1순위 — OpenClaw 지원 모든 모델\t추천\nGEMINI_API_KEY\t2순위 — Google Gemini + 임베딩\t\nANTHROPIC_API_KEY\t3순위 — Claude\t\nOPENAI_API_KEY\t4순위 — GPT + 임베딩\t\nOllama 로컬\t자동 감지 (키 없을 때)\t선택 — raon.sh install-model\n벡터 검색: GEMINI_API_KEY 또는 OPENAI_API_KEY 있으면 자동 활성화. 없으면 BM25 키워드 검색으로 동작.\n빠른 시작\n# 1. OpenClaw 설치\nnpm install -g openclaw\n\n# 2. 스킬 설치\nopenclaw skill install @yeomyeonggeori/raon-os\n\n# 3. API 키 설정 (권장: OpenRouter)\necho \"OPENROUTER_API_KEY=your-openrouter-key\" >> ~/.openclaw/.env\nchmod 600 ~/.openclaw/.env  # 보안: 소유자만 읽기/쓰기\n\n# 4. 모델 override (선택) — 기본은 프로바이더별 최적 모델 자동 선택\necho \"RAON_MODEL=anthropic/claude-opus-4-5\" >> ~/.openclaw/.env\n\n# 5. 연결 테스트\npython3 scripts/raon_llm.py --detect\n\nLLM 설정 (raon_llm.py)\n\n모든 API 키는 ~/.openclaw/.env 에 저장 (환경변수 우선):\n\n# ~/.openclaw/.env 예시\nOPENROUTER_API_KEY=<your-key>   # 1순위 (추천)\nGEMINI_API_KEY=<your-key>          # 2순위 + 임베딩\nANTHROPIC_API_KEY=<your-key>       # 3순위\nOPENAI_API_KEY=<your-key>              # 4순위 + 임베딩\nRAON_MODEL=google/gemini-2.5-flash  # 모델 강제 지정 (선택)\nRAON_LLM_PROVIDER=openrouter       # 프로바이더 강제 지정 (선택)\n\n\n스타트업 파운더를 위한 AI 동료. 아이디어를 사업으로 만드는 전 과정을 지원한다.\n\n기능\n1. biz-plan — 사업계획서 평가\n\n사업계획서(PDF/텍스트)를 분석하여 점수 + 개선안을 제공한다.\n\n# PDF 평가\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf\n\n# 텍스트 평가\n{baseDir}/scripts/raon.sh biz-plan evaluate --text \"사업 아이디어 설명...\"\n\n# JSON 형식 출력\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf --json\n\n# 결과를 파일로 저장\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf --output result.md\n\n# 두 사업계획서 비교 분석\n{baseDir}/scripts/raon.sh biz-plan evaluate --file plan_a.pdf --file plan_b.pdf\n\n# 개선안 생성\n{baseDir}/scripts/raon.sh biz-plan improve --file /path/to/plan.pdf\n\n# 평가 히스토리 조회\n{baseDir}/scripts/raon.sh history\n\n\n평가 항목:\n\n문제 정의 및 솔루션 적합성\n시장 규모 및 경쟁 분석\n비즈니스 모델 타당성\n팀 역량\n재무 계획\n기술 차별성\n\n출력: 100점 만점 종합 점수 + 항목별 점수 + 구체적 개선 제안\n\n2. gov-funding — 정부 지원사업 매칭\n\n스타트업 프로필 기반으로 적합한 정부 지원사업을 추천한다.\n\n# 매칭 (사업계획서 기반)\n{baseDir}/scripts/raon.sh gov-funding match --file /path/to/plan.pdf\n\n# 매칭 (키워드 기반)\n{baseDir}/scripts/raon.sh gov-funding match --industry \"AI/SaaS\" --stage \"early\" --region \"서울\"\n\n# 지원사업 상세 정보\n{baseDir}/scripts/raon.sh gov-funding info --program \"TIPS\"\n\n# 지원서 초안 생성\n{baseDir}/scripts/raon.sh gov-funding draft --program \"TIPS\" --file /path/to/plan.pdf\n\n# 지원 준비 체크리스트\n{baseDir}/scripts/raon.sh gov-funding checklist --program \"TIPS\" --file /path/to/plan.pdf\n\n\n지원 프로그램: TIPS, K-Startup 그랜드챌린지, 창업성장기술개발, 예비창업패키지, 초기창업패키지 등\n\n3. investor-match — 투자자 매칭 (추후 연동)\n\n스타트업 단계/산업에 맞는 투자자를 추천한다.\n\n# 투자자 추천\n{baseDir}/scripts/raon.sh investor-match --stage \"pre-a\" --industry \"AI\" --amount \"1M\"\n\nPDF 처리 (중요)\n\n사용자가 PDF를 직접 보내면 바이너리가 프롬프트에 들어가 토큰 한도를 초과한다. 반드시 텍스트 추출 후 평가해야 한다.\n\n# 방법 1: evaluate.py가 내부에서 PDF 텍스트 추출\n{baseDir}/scripts/raon.sh biz-plan evaluate --file /path/to/plan.pdf\n\n# 방법 2: 전처리 스크립트\nscripts/pdf-evaluate.sh /path/to/plan.pdf\n\n\nOpenClaw에서 PDF 파일이 첨부된 경우:\n\nPDF가 media/inbound/에 저장됨\nPDF를 프롬프트에 인라인하지 말 것 (토큰 폭발)\nexec 도구로 evaluate.py --file <경로>를 실행하여 평가\n결과를 사용자에게 전달\n사용 흐름\n\n일반적인 파운더 여정:\n\n1. \"내 사업계획서 평가해줘\" → biz-plan evaluate\n2. \"어떻게 고치면 돼?\" → biz-plan improve\n3. \"이걸로 지원할 수 있는 정부사업 있어?\" → gov-funding match\n4. \"TIPS 지원서 초안 만들어줘\" → gov-funding draft\n5. \"투자자도 연결해줘\" → investor-match\n\nInvestor Match\nraon.sh investor-match profile --file <pdf>\n# or\ncurl -X POST http://localhost:8400/v1/investor ...\n\n\n투자자 관점에서 사업계획서를 분석하고 매력도 프로필을 생성한다.\n\nDeal Summary (1분 요약)\n타겟 투자자 유형 (Seed/Pre-A, Sector)\nInvestment Highlights & Red Flags\n피칭 팁\nHTTP API 서버\n\n로컬 REST API 서버를 띄워 웹챗이나 외부 서비스에서 연동할 수 있다:\n\nraon.sh serve           # 기본 포트 8400\nraon.sh serve 9000      # 커스텀 포트\n\n\n엔드포인트:\n\nGET /health — 헬스체크\nGET /v1/modes — 지원 모드 목록\nPOST /v1/evaluate — 사업계획서 평가\nPOST /v1/improve — 사업계획서 개선\nPOST /v1/match — 정부 지원사업 매칭\nPOST /v1/draft — 지원서 초안 (program 필수)\nPOST /v1/checklist — 지원 준비 점검 (program 필수)\nPOST /v1/investor — 투자자 프로필 분석\n\n요청 예시:\n\ncurl -X POST http://localhost:8400/v1/evaluate \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"사업계획서 내용...\"}'\n\n\nCORS 지원됨 (웹 프론트엔드 연동 가능).\n\nAPI 연동\n\n현재 버전은 로컬 분석 (LLM 기반 RAG)으로 동작한다. K-Startup AI API 연동 시 환경변수 설정:\n\nexport RAON_API_URL=\"https://api.k-startup.ai\"\nexport RAON_API_KEY=\"your-api-key\"\n\n\nAPI가 설정되지 않으면 로컬 LLM + RAG 파이프라인으로 폴백한다.\n\n평가 기준 참고\n\n정부 지원사업별 심사 기준은 references/ 디렉토리 참조:\n\nreferences/tips-criteria.md — TIPS 심사 기준\nreferences/gov-programs.md — 주요 정부 지원사업 목록 및 자격 요건\n⚠️ Security & Data Flow\nCredential Protection\n모든 API 키는 ~/.openclaw/.env에 저장 (chmod 600 권장)\n패키지에 실제 키값은 절대 포함되지 않음\nData Transmission\n기본 모드 (로컬): 모든 데이터가 로컬에서 처리됨 (Ollama LLM + 로컬 RAG)\nSaaS 모드 (RAON_API_URL 설정 시): 평가 요청/PDF 텍스트가 해당 서버로 전송됨\n⚠️ 신뢰할 수 있는 엔드포인트만 설정하세요\nSupabase (SUPABASE_URL 설정 시): 피드백/사용량 데이터가 저장됨\nSUPABASE_SERVICE_KEY는 고권한 키이므로 신중히 설정\nServer Security\n/api/keys/* 엔드포인트는 localhost 전용 (관리자 API)\n외부 노출 시 반드시 nginx 리버스 프록시 + 접근 제어 사용\n카카오 웹훅: HTTP 200 반환은 카카오 플랫폼 요구사항 (재시도 방지)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/lifeissea/raon-os",
    "publisherUrl": "https://clawhub.ai/lifeissea/raon-os",
    "owner": "lifeissea",
    "version": "0.7.27",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/raon-os",
    "downloadUrl": "https://openagent3.xyz/downloads/raon-os",
    "agentUrl": "https://openagent3.xyz/skills/raon-os/agent",
    "manifestUrl": "https://openagent3.xyz/skills/raon-os/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/raon-os/agent.md"
  }
}