한 프로세스에서 여러 Slack/Discord/IRC 봇을 동시에 실행합니다.

• Slack: 멘션/스레드/DM 대응
• Discord: 멘션/DM 대응
• IRC: 채널 멘션/DM 대응
• AI 호출 인증은 CODEX_REFRESH_TOKEN 기반이며, 필요하면 회전된 토큰을 파일로 영속화할 수 있습니다.

npm install
# 방법 A: Codex CLI를 이미 쓰고 있다면 별도 env 없이 바로 실행
#         (`~/.codex/auth.json`의 refresh_token을 자동으로 사용하고,
#          rotation 결과도 같은 파일로 sync-back)
npm run chat

# 방법 B: auth.json이 없거나 환경변수로 직접 주입하고 싶은 경우
export CODEX_REFRESH_TOKEN=your_codex_refresh_token
npm run chat

CLI 설정(config/services.json의 cli 섹션, required):

{
  "cli": {
    "name": "dev",
    "model": "gpt-5.3-codex",
    "systemPrompt": "You are a helpful CLI assistant.",
    "webSearch": false,
    "imageGeneration": true
  }
}

CLI 명령:

• /reset: 문맥 초기화
• /exit: 종료

인증:

• 우선순위: ~/.codex/auth.json → CODEX_REFRESH_TOKEN 환경변수
• ~/.codex/auth.json이 존재하면 tokens.refresh_token을 사용하고, rotation 시 같은 파일로 자동 back-sync
• auth.json이 없을 때는 CODEX_REFRESH_TOKEN 환경변수 + CODEX_REFRESH_TOKEN_FILE(optional) 로 동작
• account id 헤더는 refresh 응답의 토큰 클레임에서 자동 추출

Kubernetes처럼 재시작이 발생하는 환경에서는 refresh token이 1회 사용 후 회전되므로, 기본 Helm 차트는 /app/data/codex-refresh-token 경로를 PVC에 저장하도록 구성되어 있습니다. 직접 실행할 때도 CODEX_REFRESH_TOKEN_FILE을 writable persistent volume 경로로 맞추면 이전 토큰 재사용 오류를 피할 수 있습니다.

기본 경로: config/services.json

{
  "slack": [
    {
      "name": "main",
      "botToken": "xoxb-your-bot-token",
      "appToken": "xapp-your-app-level-token",
      "model": "gpt-5.3-codex",
      "systemPrompt": "You are a helpful Slack assistant.",
      "webSearch": false
    }
  ],
  "discord": [
    {
      "name": "main",
      "botToken": "your-discord-bot-token",
      "model": "gpt-5.3-codex",
      "systemPrompt": "You are a helpful Discord assistant.",
      "webSearch": false
    }
  ],
  "irc": [
    {
      "name": "libera",
      "server": "irc.libera.chat",
      "port": 6697,
      "ssl": true,
      "nick": "codexbot",
      "username": "codexbot",
      "realname": "Codex Bot",
      "channels": ["#your-channel"],
      "sasl": {
        "enabled": true,
        "mechanism": "PLAIN",
        "username": "codexbot",
        "password": "your-sasl-password"
      },
      "model": "gpt-5.3-codex",
      "systemPrompt": "You are a helpful IRC assistant.",
      "webSearch": false
    }
  ]
}

config/services.example.json 예시 파일도 함께 제공합니다. 각 서비스 항목의 model은 필수이며, IRC는 server, nick, channels도 필수입니다. 서비스별 systemPrompt를 넣으면 해당 서비스에만 적용됩니다.

• OAuth Scopes (Bot Token Scopes)
  • app_mentions:read
  • chat:write
  • reactions:write
  • channels:history
  • im:history
  • files:write (이미지 생성 기능 사용 시 필수 — 없으면 missing_scope 에러)
• Event Subscriptions
  • app_mention
  • message.channels
  • message.im
• Socket Mode
  • App-Level Token 발급 (connections:write)

• Bot 계정 생성 후 토큰 발급
• Privileged Gateway Intents:
  • MESSAGE CONTENT 활성화
• OAuth2에서 봇을 서버에 초대

Slack / Discord / CLI 봇은 Codex의 image_generation 내장 툴을 사용해 이미지를 생성할 수 있습니다. 봇별 설정에 imageGeneration: true를 추가하면 모델이 대화 맥락에 따라 이미지 생성 여부를 직접 결정합니다. 예를 들어 "고양이 그려줘" 같은 요청에는:

• Slack / Discord: 스트리밍이 끝난 뒤 같은 스레드/채널에 PNG 파일을 새 메시지로 첨부하고, revised_prompt를 메시지 본문으로 노출합니다.
• CLI: 현재 작업 디렉토리에 image-<YYYYMMDD>-<HHMMSS>[-<index>].png 형식으로 저장하고 경로를 stdout에 출력합니다.

주의 사항:

• Slack에서 이미지 첨부를 사용하려면 files:write OAuth scope가 Bot Token Scopes에 추가되어 있어야 합니다. 없으면 업로드 시 missing_scope 에러가 발생합니다.
• imageGeneration은 Boolean literal(true / false)만 받습니다. 문자열 "true"는 false로 처리됩니다(strict === true 비교).
• 생략하거나 false이면 기존 텍스트 응답 페이로드와 바이트 레벨로 동일하게 동작합니다(회귀 없음).
• IRC는 파일 첨부가 불가능하여 이 플래그를 설정해도 무시됩니다.
• Anthropic provider 경로에서는 플래그가 무시되며 기동 시 [ai] imageGeneration ignored for anthropic provider ... 형태의 warn 로그가 한 번 남습니다.

예시(config/services.json):

{
  "slack": [
    {
      "name": "main",
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "model": "gpt-5.3-codex",
      "imageGeneration": true
    }
  ]
}

• IRC 서버 주소/포트와 봇 계정(nick) 준비
• SSL/TLS 서버면 ssl: true와 port: 6697 사용 (tls 키도 호환)
• SASL 사용 시 sasl.enabled: true, sasl.mechanism: PLAIN, sasl.username/password 설정
• 응답할 채널 목록을 channels에 설정

export CODEX_REFRESH_TOKEN=your_codex_refresh_token
npm run start

docker build -t slack-openai-bot .
docker run --rm \
  -e CODEX_REFRESH_TOKEN=your_codex_refresh_token \
  -v "$(pwd)/config/services.json:/app/config/services.json:ro" \
  slack-openai-bot

차트 경로: helm/slack-openai-bot

helm upgrade --install bot ./helm/slack-openai-bot \
  --set image.repository=your-repo/slack-openai-bot \
  --set image.tag=latest \
  --set auth.refreshToken=your_codex_refresh_token

민감정보 관리를 위해 auth.existingSecret, config.servicesExistingSecret 사용을 권장합니다.

• src/index.js: 멀티 서비스 런처
• src/connectors/slack.js: Slack 연결
• src/connectors/discord.js: Discord 연결
• src/connectors/irc.js: IRC 연결
• src/ai.js: Codex auth 기반 AI 호출
• src/cli.js: 로컬 테스트 CLI
• Dockerfile: 컨테이너 이미지 빌드
• helm/slack-openai-bot: Kubernetes Helm 차트
• config/services.json: 서비스 구성
• config/services.example.json: 서비스 구성 예시