한 프로세스에서 여러 Slack/Discord/IRC 봇을 동시에 실행합니다.
- Slack: 멘션/스레드/DM 대응
- Discord: 멘션/DM 대응
- IRC: 채널 멘션/DM 대응
- Codex 인증은 access/refresh token을 함께 담은 JSON 번들을 사용하며, refresh 직후 최신 번들을 원자적으로 영속화합니다.
npm install
# Codex CLI로 먼저 로그인한 뒤 실행
codex login
npm run chatnpm run chat은 기본적으로 ~/.codex/auth.json을 직접 사용합니다. 파일의 access token이
30초보다 오래 유효하면 refresh 없이 재사용하고, 만료가 임박했거나 API가 인증을 거부할
때만 refresh합니다. 갱신된 access/refresh token은 요청을 재시도하기 전에 같은 JSON 파일에
원자적으로 저장됩니다.
공식 Codex CLI와 npm run chat을 동시에 실행하지 마세요. 두 프로세스가 같은
~/.codex/auth.json의 refresh-token chain을 동시에 갱신하면 한쪽 token이 무효화될 수
있습니다. 인증을 다시 발급해야 한다면 두 프로세스를 모두 종료한 뒤 codex logout,
codex login 순서로 로그인하고 한 프로세스만 실행합니다.
CLI 설정(config/services.json의 cli 섹션, required):
{
"cli": {
"name": "dev",
"model": "gpt-5.3-codex",
"reasoningEffort": "medium",
"systemPrompt": "You are a helpful CLI assistant.",
"webSearch": false,
"imageGeneration": true,
"imageGenerationModel": "gpt-image-2.6-sunburst"
}
}CLI 명령:
/reset: 문맥 초기화/exit: 종료
인증:
- CLI 기본 인증 파일:
~/.codex/auth.json - 서버 기본 인증 파일:
<현재 작업 디렉터리>/data/codex-auth.json - 서버/Docker에서 경로를 바꾸려면
CODEX_AUTH_FILE에 writable persistent 경로를 지정 - 인증 파일이 없을 때만
CODEX_ACCESS_TOKEN과CODEX_REFRESH_TOKEN환경변수 쌍으로 최초 JSON 번들을 생성 - 인증 파일이 존재하면 그 파일이 항상 우선하며, 환경변수의 seed token은 덮어쓰거나 자동 복구에 사용하지 않음
- account ID는 인증 번들과 token claim에서 자동 추출
인증 파일에는 access/refresh token이 모두 들어 있으므로 파일과 상위 디렉터리를 비공개로
보호해야 합니다. 새 파일은 POSIX 환경에서 mode 0600으로 생성됩니다.
기본 경로: 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를 넣으면 해당 서비스에만 적용됩니다.
CLI와 Slack/Discord/IRC의 각 설정에 "reasoningEffort": "high"를 추가하면 Codex 요청의
reasoning.effort로 전달됩니다. 생략하면 모델 기본값을 사용하며, Anthropic 요청에는
적용하지 않습니다. 설정값은 none, minimal, low, medium, high, xhigh, max 중
하나여야 합니다. 실제 지원값은 모델마다 다르므로 fallback용 models 배열을 사용하는 경우
각 Codex 모델이 지원하는 값을 선택하세요. 지원값과 기본값은
OpenAI 공식 문서를 참고하세요.
Helm에서도 config.services.slack[], discord[], irc[]의 각 항목에 같은 필드를 넣습니다.
- OAuth Scopes (Bot Token Scopes)
app_mentions:readchat:writereactions:writechannels:historyim:historyfiles:write(이미지 생성 기능 사용 시 필수 — 없으면missing_scope에러)
- Event Subscriptions
app_mentionmessage.channelsmessage.im
- Socket Mode
- App-Level Token 발급 (
connections:write)
- App-Level Token 발급 (
- Bot 계정 생성 후 토큰 발급
- Privileged Gateway Intents:
MESSAGE CONTENT활성화
- OAuth2에서 봇을 서버에 초대
Slack / Discord / CLI 봇은 Codex 이미지 API를 호출하는 generate_image 함수 도구로 정지 이미지와 움직이는 GIF 생성을 요청할 수 있습니다. 봇별 설정에 imageGeneration: true를 추가하면 모델이 대화 맥락에 따라 이미지 생성 여부와 GIF 사용 여부를 결정합니다. "고양이 그려줘" 또는 "고양이가 손을 흔드는 움직이는 GIF를 만들어 줘"처럼 요청할 수 있으며, 대화에 첨부한 정지 이미지를 참고해 편집할 수도 있습니다.
imageGenerationModel로 이미지 생성·편집 모델을 지정할 수 있습니다. 생략하면 gpt-image-2.6-sunburst를 사용하며, 대화를 처리하는 model / models 설정과는 별개입니다. Helm에서는 각 Slack / Discord / CLI 서비스 항목에 같은 필드를 지정합니다.
- Slack / Discord: 응답이 끝난 뒤 같은 스레드/채널에 PNG 또는 GIF 파일을 새 메시지로 첨부하고, 이미지 생성에 사용한 프롬프트를 함께 표시합니다.
- CLI: 현재 작업 디렉토리에
image-<YYYYMMDD>-<HHMMSS>[-<index>].png또는.gif형식으로 저장하고 경로를 stdout에 출력합니다. - GIF는 2~16프레임의 간단한 반복 애니메이션을 지원하며, 생성된 파일을 변환하지 않고 그대로 전달합니다.
주의 사항:
- GIF 생성은 Codex 백엔드에서 해당 요청에 GIF 출력을 허용해야 사용할 수 있습니다. 허용되지 않으면
GIF output is not enabled for this request.라는 지원 제한 사유를 모델에 전달합니다. - Slack에서 이미지 첨부를 사용하려면
files:writeOAuth 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,
"imageGenerationModel": "gpt-image-2.6-sunburst"
}
]
}- IRC 서버 주소/포트와 봇 계정(nick) 준비
- SSL/TLS 서버면
ssl: true와port: 6697사용 (tls키도 호환) - SASL 사용 시
sasl.enabled: true,sasl.mechanism: PLAIN,sasl.username/password설정 - 응답할 채널 목록을
channels에 설정
서버 실행 시 CODEX_AUTH_FILE을 영속적이고 쓰기 가능한 JSON 경로로 지정합니다. 해당 파일이
아직 없을 때에만 CODEX_ACCESS_TOKEN과 CODEX_REFRESH_TOKEN을 함께 seed로 제공합니다.
토큰은 셸 명령에 직접 입력하지 말고 process supervisor나 secret manager의 보호된 환경변수
주입 기능을 사용하세요. 첫 기동에서 JSON 파일이 만들어진 뒤에는 그 파일이 최신 인증
상태의 원본입니다.
npm run start는 시작 시 인증 번들을 초기화한 다음 connector를 시작합니다. Anthropic만
사용하는 구성이라면 Codex token 없이도 기동할 수 있습니다.
docker build -t slack-openai-bot .
install -d -m 700 ./data
docker run --rm \
--env-file ./bot-auth.env \
-e CODEX_AUTH_FILE=/app/data/codex-auth.json \
-v "$(pwd)/config/services.json:/app/config/services.json:ro" \
-v "$(pwd)/data:/app/data" \
slack-openai-botbot-auth.env는 secret manager 또는 보호된 편집기로 만들고 mode 0600을 적용합니다. 최초
기동에는 CODEX_ACCESS_TOKEN과 CODEX_REFRESH_TOKEN 두 항목이 모두 있어야 합니다.
파일 내용을 출력하거나 저장소에 추가하지 마세요. ./data는 컨테이너의 UID 1000이 쓸 수
있어야 하며 백업과 접근 제어가 필요합니다.
차트 경로: helm/bot
Kubernetes에서는 Secret과 PVC를 함께 사용합니다.
- Secret: 인증 파일이 없는 최초 pod에 access/refresh token 쌍을 제공하는 seed
- PVC의
/app/data/codex-auth.json: refresh 후 계속 갱신되는 최신 인증 번들
auth.persistence.mountPath를 변경하면 CODEX_AUTH_FILE은 정규화된 같은 mount 아래의
codex-auth.json으로 자동 설정됩니다.
Secret은 token rotation 때마다 갱신되는 저장소가 아닙니다. pod가 재시작되면 PVC 파일을
먼저 읽으므로 Secret에 남은 최초 seed는 무시됩니다. 하나의 refresh-token chain을 한
프로세스만 소유하도록 차트는 replica 1개와 Recreate 전략만 허용합니다.
토큰을 Helm values나 helm --set 인자에 넣지 말고 auth.existingSecret을 사용하는 구성을
권장합니다. 예를 들어 보호된 로컬 파일 <protected-auth-env-file>에 아래 두 key를 준비합니다.
CODEX_ACCESS_TOKEN=<fresh access token>
CODEX_REFRESH_TOKEN=<matching fresh refresh token>
해당 파일은 mode 0600으로 보호하고 다음처럼 Secret을 생성하거나 갱신합니다. token 값은
명령 인자나 출력에 포함되지 않습니다.
kubectl -n <namespace> create secret generic <auth-secret> \
--from-env-file=<protected-auth-env-file> \
--dry-run=client -o yaml | kubectl apply -f -
helm upgrade --install bot ./helm/bot \
--set image.repository=your-repo/slack-openai-bot \
--set image.tag=latest \
--set-string auth.existingSecret=<auth-secret>운영 환경에서는 가능하면 외부 secret manager/operator로 <auth-secret>을 관리하세요.
서비스 설정도 config.servicesExistingSecret으로 별도 Secret을 참조할 수 있습니다.
기존 /app/data/codex-refresh-token 단일 파일과 refresh token 하나만 든 Secret은 새 버전에서
읽거나 자동 변환하지 않습니다. 이 변경은 무중단 업그레이드가 아니며, 기존 pod와 새 pod가
같은 refresh-token chain을 동시에 사용하지 않도록 다음 순서를 지켜야 합니다.
- 기존 Deployment를 replica 0으로 내리고 구 pod가 모두 종료됐는지 확인합니다.
- 다른 환경에서
codex login으로 서로 짝이 맞는 새 access/refresh token을 발급하고, 공식 Codex 프로세스를 종료합니다. - 보호된 env 파일 또는 secret manager를 이용해 Secret에 새
CODEX_ACCESS_TOKEN과CODEX_REFRESH_TOKEN쌍을 함께 반영합니다. - PVC의 기존
/app/data/codex-refresh-token은 삭제하지 말고 별도 이름으로 이동해 격리합니다. - 새
/app/data/codex-auth.json이 존재하지 않는지 확인합니다. 이미 있다면 덮어쓰지 말고 아래 인증 복구 절차에 따라 먼저 격리합니다. - Deployment를 정확히 replica 1로 올려 새 JSON 번들을 생성하고 인증 성공을 확인합니다.
새 번들과 실제 요청이 정상임을 확인하기 전에는 격리한 기존 파일을 제거하지 마세요. token 값을 Helm 인자, 셸 기록, 로그 또는 명령 출력에 노출하지 않는 원칙은 신규 설치와 같습니다.
PVC 인증 파일이 손상되었거나 refresh token이 무효화된 경우 오래된 Secret로 자동 fallback하지 않습니다. 다음 순서를 지켜 수동으로 재시드합니다.
- Deployment를 replica 0으로 내리고 관련 pod가 모두 종료됐는지 확인합니다.
- PVC를 단독으로 마운트한 maintenance pod에서 기존
codex-auth.json을 삭제하지 말고 별도 이름으로 이동해 격리합니다. - 다른 환경에서
codex login으로 서로 짝이 맞는 새 access/refresh token을 발급합니다. 공식 Codex 프로세스는 다시 종료해 이 token chain을 동시에 refresh하지 않게 합니다. - 위의 보호된 env 파일과
kubectl create secret ... --from-env-file방식으로<auth-secret>을 새 쌍으로 갱신합니다. /app/data/codex-auth.json이 없는 상태임을 확인하고 Deployment를 정확히 replica 1로 올립니다. 둘 이상의 pod를 동시에 시작하지 마세요.- 새
/app/data/codex-auth.json이 생성되었고 mode가600인지 확인한 뒤 실제 요청으로 인증 성공을 검증합니다. 성공을 확인한 뒤에만 격리 파일을 보존 정책에 따라 정리합니다.
namespace, Deployment, PVC 이름은 설치 환경에서 먼저 조회해 실제 값을 사용하세요. Secret, 인증 파일 또는 pod 로그의 token 내용을 출력하지 마세요.
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/codex-auth.js: Codex 인증 번들 로드·refresh·원자 저장src/cli.js: 로컬 테스트 CLIDockerfile: 컨테이너 이미지 빌드helm/bot: Kubernetes Helm 차트config/services.json: 서비스 구성config/services.example.json: 서비스 구성 예시