온보딩 마법사
prx onboard 명령은 프로바이더 선택, API 키 입력, 모델 선택, 메모리 백엔드 설정을 안내하여 초기 설정 파일을 생성합니다. PRX를 처음 구성할 때 권장되는 방법입니다.
온보딩이 수행하는 작업
prx onboard를 실행하면 마법사가 다음 단계를 수행합니다:
- LLM 프로바이더 선택 -- 9개 지원 프로바이더(Anthropic, OpenAI, Google Gemini, Ollama, OpenRouter 등) 중에서 선택하도록 안내합니다
- API 키 저장 -- 프로바이더 자격 증명을 설정 파일에 안전하게 기록합니다
- 사용 가능한 모델 가져오기 -- 프로바이더 API를 조회하여 접근 가능한 모델 목록을 표시합니다
- 기본 모델 설정 -- 기본적으로 사용할 모델을 선택합니다
- 메모리 백엔드 구성 -- Markdown(파일 기반), SQLite 또는 PostgreSQL 중에서 선택합니다
- 설정 파일 작성 --
~/.config/openprx/openprx.toml에 설정을 생성합니다
온보딩 후 prx daemon 또는 prx chat으로 PRX를 실행할 수 있습니다.
대화형 모드
기본 온보딩 경험은 필수 질문만 묻는 빠른 설정입니다. 모든 설정 섹션을 안내하는 전체 대화형 마법사를 사용하려면 --interactive 플래그를 사용하세요:
prx onboard --interactive대화형 마법사에는 다음에 대한 추가 구성이 포함됩니다:
- 게이트웨이 호스트 및 포트 설정
- 채널 사전 구성 (Telegram, Discord 등)
- 보안 및 자율성 수준
- 워크스페이스 디렉터리
- 관측성 설정
빠른 설정 (기본)
기본 prx onboard는 간소화된 빠른 설정을 실행합니다:
prx onboard프로바이더, API 키, 모델만 묻고 그 외 모든 설정은 합리적인 기본값을 사용합니다.
플래그를 사용한 빠른 설정
플래그를 전달하여 대화형 프롬프트를 완전히 건너뛸 수 있습니다:
prx onboard \
--provider anthropic \
--api-key sk-ant-api03-xxxxxxxxxxxx \
--model claude-sonnet-4-20250514사용 가능한 플래그:
| 플래그 | 설명 | 예시 |
|---|---|---|
--provider | LLM 프로바이더 이름 | anthropic, openai, ollama, openrouter |
--api-key | 프로바이더 API 키 또는 자격 증명 | sk-ant-..., sk-... |
--model | 기본 모델 식별자 | claude-sonnet-4-20250514, gpt-4o |
--memory | 메모리 백엔드 | markdown, sqlite, postgres |
--interactive | 전체 대화형 마법사 실행 | (값 없음) |
--channels-only | 채널 복구 마법사만 다시 실행 | (값 없음) |
예시
Anthropic Claude 기본 설정:
prx onboard --provider anthropic --api-key "$ANTHROPIC_API_KEY"로컬 Ollama (API 키 불필요):
prx onboard --provider ollama --model llama3.2OpenRouter에서 특정 모델 사용:
prx onboard --provider openrouter --api-key "$OPENROUTER_API_KEY" --model anthropic/claude-sonnet-4-20250514SQLite 메모리를 사용하는 OpenAI:
prx onboard --provider openai --api-key "$OPENAI_API_KEY" --model gpt-4o --memory sqlite설정 파일
온보딩 마법사는 다음 위치에 설정을 저장합니다:
~/.config/openprx/openprx.tomlLinux에서는 XDG Base Directory 사양을 따릅니다. macOS에서는 XDG_CONFIG_HOME이 설정되지 않은 경우 ~/Library/Application Support/openprx/openprx.toml을 사용합니다.
생성된 설정 예시
prx onboard --provider anthropic --model claude-sonnet-4-20250514 실행 후 생성되는 설정은 다음과 같습니다:
# OpenPRX Configuration
# Generated by: prx onboard
# ── Provider ──────────────────────────────────────────────
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"
default_temperature = 0.7
api_key = "sk-ant-api03-xxxxxxxxxxxx"
# ── Workspace ─────────────────────────────────────────────
workspace_dir = "~/.local/share/openprx"
# ── Memory ────────────────────────────────────────────────
[memory]
backend = "markdown"
# path defaults to workspace_dir/memory
# ── Gateway ───────────────────────────────────────────────
[gateway]
host = "127.0.0.1"
port = 3120
# ── Channels ──────────────────────────────────────────────
[channels]
cli = true
# ── Security ──────────────────────────────────────────────
[security]
autonomy = "supervised"이 파일은 언제든지 편집할 수 있습니다. PRX는 핫 리로드를 지원하여 대부분의 변경 사항이 데몬 재시작 없이 적용됩니다.
설정 섹션
설정 파일은 다음과 같은 최상위 섹션을 지원합니다:
| 섹션 | 용도 |
|---|---|
default_provider | 기본 LLM 프로바이더 |
default_model | 기본 모델 |
api_key | 프로바이더 API 자격 증명 |
[memory] | 메모리 백엔드 및 저장 설정 |
[gateway] | HTTP/WebSocket 게이트웨이 구성 |
[channels] | 메시징 채널 구성 |
[channels.telegram] | Telegram 봇 설정 |
[channels.discord] | Discord 봇 설정 |
[security] | 자율성 수준, 샌드박스, 정책 |
[router] | LLM 라우팅 전략 |
[self_system] | 자기 진화 파이프라인 설정 |
[observability] | 메트릭, 추적, 로깅 |
[cron] | 스케줄된 작업 구성 |
[plugins] | WASM 플러그인 경로 및 설정 |
모든 사용 가능한 옵션은 전체 설정 레퍼런스를 참조하세요.
온보딩 후 확인
온보딩 후 진단 명령을 실행하여 모든 것이 올바르게 구성되었는지 확인합니다:
prx doctordoctor가 확인하는 항목:
- 설정 파일 -- TOML 구문 및 필수 필드 유효성 검사
- 프로바이더 연결 -- API 키를 사용하여 프로바이더를 조회하여 테스트
- 모델 가용성 -- 선택한 모델에 접근 가능한지 확인
- 메모리 백엔드 -- 저장 백엔드가 쓰기 가능한지 확인
- 시스템 의존성 -- 선택적 도구(git, docker 등) 확인
- 네트워크 -- 구성된 서비스에 대한 연결 테스트
출력 예시:
PRX Doctor
Config file .............. OK (~/.config/openprx/openprx.toml)
Provider (anthropic) ..... OK (authenticated)
Model .................... OK (claude-sonnet-4-20250514)
Memory (markdown) ........ OK (writable)
Gateway port (3120) ...... OK (available)
Git ...................... OK (2.43.0)
Docker ................... WARN (not installed -- sandbox features limited)
All critical checks passed.Doctor 하위 명령
doctor에는 대상을 지정한 진단을 위한 하위 명령도 있습니다:
# 모든 프로바이더의 모델 카탈로그 조회
prx doctor models
# 특정 프로바이더의 모델 조회
prx doctor models --provider anthropic채널 복구 마법사
이미 온보딩을 완료했고 채널 구성을 추가하거나 수정하려면 --channels-only 플래그를 사용하세요:
prx onboard --channels-only프로바이더 및 모델 설정을 건너뛰고 채널 구성으로 바로 이동합니다.
온보딩 다시 실행
언제든지 prx onboard를 다시 실행할 수 있습니다. 마법사가 기존 설정을 감지하고 처음부터 덮어쓰는 대신 업데이트하도록 제안합니다. 기존 채널 구성, 메모리 데이터, 사용자 지정 설정은 보존됩니다.