OpenClaw에서 Muapi 사용

OpenClaw에 Muapi를 OpenAI 호환 사용자 지정 공급자로 연결하면 에이전트와 연결된 채널에서 Muapi 텍스트 모델을 쓸 수 있습니다.

1. 키 생성 및 모델 선택

Muapi 대시보드에서 API 키를 만들고 텍스트 모델을 조회합니다.

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

OpenClaw 도구를 사용하려면 capabilities.tools: true인 모델을 선택하세요.

2. 사용자 지정 공급자 설정

OpenClaw gateway 실행 환경에서 MUAPI_API_KEY를 설정하고, 보통 ~/.openclaw/openclaw.json에 공급자와 기본 모델을 추가합니다.

{
  models: {
    mode: "merge",
    providers: {
      muapi: {
        baseUrl: "https://api.muapi.ai/v1",
        apiKey: "${MUAPI_API_KEY}",
        api: "openai-completions",
        models: [{ id: "YOUR_MODEL_ID", name: "Muapi text model" }],
      },
    },
  },
  agents: { defaults: { model: { primary: "muapi/YOUR_MODEL_ID" } } },
}

두 곳의 YOUR_MODEL_ID를 Muapi 목록의 정확한 ID로 바꾸세요. 공유 프로젝트 파일에 키를 저장하지 마세요. OpenClaw를 서비스로 실행한다면 서비스 환경에서 MUAPI_API_KEY를 사용할 수 있어야 합니다.

3. 시작 및 확인

openclaw models list
openclaw tui

작업 공간의 파일 요약처럼 도구를 사용하는 작은 작업을 시험하세요. 터미널에서 모델이 작동한 뒤 메시징 채널을 연결하세요.

문제 해결

• 모델이 표시되지 않으면 공급자 ID, 모델 ID, JSON5 문법을 확인하세요.
• 인증 오류가 나면 gateway 프로세스가 MUAPI_API_KEY를 읽을 수 있는지 확인하세요.
• 도구를 사용하지 못하면 capabilities.tools: true인 모델을 선택하세요.
• 작은 작업부터 시작하고 대시보드에서 사용량을 확인하세요.

현재 설정은 OpenClaw 사용자 지정 공급자 문서와 모델 설정 가이드를 참조하세요.