Files
EJClaw/docs/configuration.md
Codex 60ff19177a refactor: remove Mixture of Agents and Kimi usage
MOA_* was never configured, so enrichArbiterPromptWithMoa always
returned the prompt unchanged and the Kimi usage fetch only produced an
empty dashboard row. Remove src/moa.ts, src/kimi-usage.ts, the arbiter
prompt enrichment, MoA config/schema, the Kimi row and MoA line in the
Discord status dashboard, and the MOA_* / unused FALLBACK_* provider
examples from the docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 19:10:19 +09:00

5.3 KiB

설정

EJClaw의 설정 기준은 .env 하나입니다. 프로젝트 루트의 ../.env.example를 기본 예시로 보고, 이 문서는 현재 런타임에서 의미가 있는 키만 추려 설명합니다.

기본 원칙

  • Discord 토큰은 role-fixed canonical 키만 사용합니다
  • reviewer 기본 provider는 claude-code
  • owner 기본 provider는 codex
  • room-level override는 provider 단위(claudeModel, codexModel)만 지원합니다
  • CLAUDE_CODE_OAUTH_TOKENS가 canonical이고, CLAUDE_CODE_OAUTH_TOKEN은 legacy fallback입니다

Discord 봇

DISCORD_OWNER_BOT_TOKEN=
DISCORD_REVIEWER_BOT_TOKEN=
DISCORD_ARBITER_BOT_TOKEN=

예전 service-based alias는 더 이상 허용되지 않습니다.

역할 / 모델 설정

# 역할별 provider
OWNER_AGENT_TYPE=codex
REVIEWER_AGENT_TYPE=claude-code
ARBITER_AGENT_TYPE=codex

# provider 기본 모델
# 공식 Claude API 모델 ID입니다.
CLAUDE_MODEL=claude-opus-5-5
CLAUDE_EFFORT=high
CLAUDE_THINKING=adaptive
CODEX_MODEL=gpt-5.5
CODEX_EFFORT=xhigh

# 역할별 override
OWNER_MODEL=gpt-5.5
OWNER_EFFORT=xhigh
OWNER_FALLBACK_ENABLED=true

REVIEWER_MODEL=claude-opus-5-5
REVIEWER_EFFORT=high
REVIEWER_FALLBACK_ENABLED=true

ARBITER_MODEL=gpt-5.5
ARBITER_EFFORT=xhigh
ARBITER_FALLBACK_ENABLED=true

설명:

  • reviewer / arbiter provider는 전역 REVIEWER_AGENT_TYPE / ARBITER_AGENT_TYPE이 기본값이고, 방마다 assign_room의 reviewer_agent_type / arbiter_agent_type으로 덮어쓸 수 있습니다
  • 역할별 *_MODEL은 해당 역할의 provider에 맞춰 주입됩니다. codex 역할에는 Codex 모델을, claude-code 역할에는 Claude 모델을 넣어야 합니다.
  • 예를 들어 ARBITER_AGENT_TYPE=claude-code로 바꾸면 그때 ARBITER_MODEL=claude-opus-5-5를 사용할 수 있습니다.
  • 모델 ID는 추측하지 말고 GET https://api.anthropic.com/v1/models로 확인하세요(claude-opus-5-0 같은 표기는 존재하지 않음). 새 모델은 더 높은 Claude Code CLI 버전을 요구할 수 있으므로(예: Opus 5.5는 CLI 2.1.280 이상), .env를 바꾸기 전에 runner SDK로 실제 호출해 보고 적용하세요. Opus/Sonnet 5.x는 CLAUDE_THINKING=adaptive만 지원합니다.
  • room-level agentConfig의 claudeModel, codexModel은 역할별이 아니라 provider별 override
  • ARBITER_AGENT_TYPE은 옵션이며, 설정하지 않으면 arbiter는 비활성 상태입니다

인증

# Claude Code OAuth
CLAUDE_CODE_OAUTH_TOKENS=
CLAUDE_CODE_OAUTH_TOKEN=

# Claude host env (선택)
ANTHROPIC_API_KEY=
ANTHROPIC_AUTH_TOKEN=
ANTHROPIC_BASE_URL=

설명:

  • CLAUDE_CODE_OAUTH_TOKENS: canonical, 쉼표 구분
  • CLAUDE_CODE_OAUTH_TOKEN: 단일 토큰 legacy fallback
  • 실제 runner에는 현재 선택된 Claude 토큰 하나만 주입됩니다

Codex 쪽은 현재 OAuth 세션 파일 기준으로 동작합니다. OPENAI_API_KEY를 Codex child process에 넘겨서 빌링하는 구조는 사용하지 않습니다.

음성 전사

GROQ_API_KEY=
  • 기본은 Groq Whisper(whisper-large-v3-turbo)
  • GROQ_API_KEY가 없고 OPENAI_API_KEY가 있으면 OpenAI Whisper(whisper-1)로 자동 대체됩니다(src/channels/discord.ts)

운영 / 배포 관련 설정

ASSISTANT_NAME=claude
STATUS_CHANNEL_ID=
SESSION_COMMAND_ALLOWED_SENDERS=
MAX_CONCURRENT_AGENTS=5

Discord 이미지 첨부 allowlist

EJCLAW_ATTACHMENT_ALLOWED_DIRS=~/Pictures/Screenshots,~/Downloads/ejclaw-images
  • 콤마 또는 플랫폼 path delimiter(Linux는 :)로 여러 폴더를 지정합니다.

  • 기본 허용 폴더는 data/attachments와 Codex generated_images이며, 이 설정은 그 외 폴더를 추가합니다.

  • 첨부 가능 형식: PNG/JPEG/GIF/WebP/BMP, MP4/MOV/WebM, MP3/WAV/OGG/M4A/FLAC, PDF, ZIP, TXT/Markdown/CSV/JSON (SVG 불가). 파일당 최대 8MB.

  • realpath, 이미지 signature, size cap 검증은 그대로 적용됩니다.

  • /home/** 전체보다 자주 쓰는 스크린샷/이미지 출력 폴더만 추가하는 것을 권장합니다.

  • ASSISTANT_NAME은 owner trigger 기본 이름을 만듭니다

  • paired room에서도 사용자 진입점은 owner가 기준입니다

  • status dashboard와 session command는 선택 설정입니다

디버깅 경로

항목 경로 / 명령
DB store/messages.db
서비스 로그 journalctl --user -u ejclaw -f
room 로그 groups/{folder}/logs/
owner/reviewer 세션 data/sessions/{folder}*
owner worktree data/workspaces/{folder}/owner
Claude 플랫폼 프롬프트 prompts/claude-platform.md
reviewer 프롬프트 prompts/claude-paired-room.md
arbiter 프롬프트 prompts/arbiter-paired-room.md
Codex 플랫폼 프롬프트 prompts/codex-platform.md
글로벌 메모리 groups/global/CLAUDE.md

문서와 실제 코드의 우선순위

문서보다 실제 동작이 우선입니다. 동작 기준을 확인할 때는 아래를 먼저 봅니다.

  1. .env.example
  2. src/config/load-config.ts
  3. src/agent-runner-environment.ts
  4. src/paired-execution-context.ts