Files
EJClaw/.claude/skills/setup/SKILL.md
Eyejoker fd3145e2a7 feat: refresh dashboard settings UX and Codex feature toggles (#153)
* feat: refresh dashboard settings UX and Codex feature toggles

Improve settings/tasks mobile layout, model effort validation by agent type, and preset models for GPT 5.5 and Opus 4.7. Store Codex fast mode and goals in config.toml with Claude fastMode session sync and updated docs for Codex 0.133.

Co-authored-by: Cursor <cursoragent@cursor.com>

* style: apply pre-commit formatting after dashboard settings commit

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-23 12:18:42 +09:00

4.1 KiB

name, description
name description
setup Run initial EJClaw setup for the unified single-service Discord architecture.

EJClaw Setup

설치는 bash setup.sh로 부트스트랩하고, 나머지는 bun run setup -- --step <name>으로 진행합니다. 현재 기준 채널은 디스코드만 지원합니다.

EJClaw는 현재 단일 서비스로 동작합니다:

  • ejclaw — 통합 런타임 서비스

Claude가 기본 봇으로 동작하고, Codex는 별도 서비스가 아니라 필요 시 내부 러너/역할 라우팅으로 사용됩니다.

1. 부트스트랩

bash setup.sh
  • Node 20 이상과 의존성이 준비되어야 합니다.
  • 실패하면 logs/setup.log를 먼저 봅니다.

2. 현재 상태 확인

bun run setup -- --step environment

여기서 확인할 것:

  • .env 존재 여부
  • 기존 등록 그룹 존재 여부
  • 이미 초기화된 설치인지 여부

3. 필수 환경 변수

기본 환경 변수 (.env)

.env에 최소한 아래 값이 있어야 합니다.

DISCORD_BOT_TOKEN=...                # Claude 봇 토큰
CLAUDE_CODE_OAUTH_TOKEN=...          # 또는 ANTHROPIC_API_KEY=...
ASSISTANT_NAME=claude                # 트리거 이름 (@claude)

권장:

CLAUDE_CODE_OAUTH_TOKENS=token1,token2   # 다중 계정 자동 로테이션
GROQ_API_KEY=...                          # Discord 음성 전사 (Groq Whisper)

Codex 관련 선택 설정은 별도 서비스 파일이 아니라 같은 .env 또는 서비스 환경 변수에 넣습니다:

# 같은 .env 또는 서비스 Environment=에 추가 가능
CODEX_MODEL=gpt-5.5
CODEX_EFFORT=xhigh
OPENAI_API_KEY=...

선택 환경 변수

# 사용량 대시보드
STATUS_CHANNEL_ID=...                # 상태 업데이트 디스코드 채널
USAGE_DASHBOARD=true

# 고급 설정
MAX_CONCURRENT_AGENTS=5
SESSION_COMMAND_ALLOWED_SENDERS=...  # 세션 명령 허용 유저 ID (쉼표 구분)

4. 러너 빌드

bun run setup -- --step runners

이 단계는 아래 두 러너를 빌드합니다.

  • runners/agent-runner (Claude Code)
  • runners/codex-runner (Codex)

서비스는 하나지만, 내부 역할 라우팅과 paired 흐름에서 두 러너를 모두 쓸 수 있어서 둘 다 빌드합니다.

실패하면 보통 bun run build:runners 출력과 각 러너의 package.json 의존성을 같이 보면 됩니다.

5. 디스코드 채널 등록

먼저 디스코드에서 개발자 모드를 켜고 채널 ID를 복사합니다. 등록 JID는 dc:<channel_id> 형식입니다.

채널 등록은 기본적으로 한 번 하면 됩니다.

예시:

bun run setup -- --step register -- \
  --jid dc:123456789012345678 \
  --name "My Server #general" \
  --folder discord_main \
  --trigger @claude \
  --is-main \
  --no-trigger-required

보조 채널 예시:

bun run setup -- --step register -- \
  --jid dc:123456789012345678 \
  --name "My Server #ops" \
  --folder discord_ops \
  --trigger @claude

6. 서비스 시작

bun run setup -- --step service

이 명령은:

  • ejclaw 서비스를 설치하고 시작합니다

플랫폼별:

  • Linux (systemd): ~/.config/systemd/user/ejclaw.service
  • macOS: ~/Library/LaunchAgents/com.ejclaw.plist
  • WSL (no systemd): start-ejclaw.sh

수동으로 서비스 관리:

# Linux (systemd)
systemctl --user status ejclaw
systemctl --user restart ejclaw

# 로그
journalctl --user -u ejclaw -f

7. 최종 검증

bun run setup -- --step verify

성공 기준:

  • ejclaw 서비스가 running
  • Claude 인증이 configured
  • CHANNEL_AUTHdiscord
  • 등록 그룹 수가 1 이상

빠른 문제 해결

  • 빌드 문제: bun run typecheck, bun test, bun run build:runners
  • Claude 서비스 문제: logs/ejclaw.error.log 또는 journalctl --user -u ejclaw -f
  • Codex 실행 문제: 같은 ejclaw 서비스 로그에서 CODEX_MODEL, CODEX_EFFORT, OPENAI_API_KEY 설정을 같이 확인
  • 디스코드 연결 문제: .envDISCORD_BOT_TOKEN과 등록된 dc:* JID 확인
  • 응답 문제: tail -f logs/ejclaw.log