Starian Portal

Settings

Passcode 접속 비밀번호 변경

⚠️ 이것은 로그인 비밀번호가 아닙니다. 에이전트·타 머신 포탈·webhook 이 쓰는 통신 토큰(Authorization: Bearer)이며, 바꾸면 그 경로들을 함께 갱신해야 합니다. 로그인 비밀번호는 위 [내 비밀번호]에서 변경하세요.

New Passcode

Confirm

🔵 바꾸면 옵시디언 금고 _secrets/금고.md «포털 passcode» 절과 ~/.claude/harness.env 의 PORTAL_PASSCODE 도 같은 값으로 고친다 — 안 고치면 에이전트가 옛 값을 쓴다.

알림음 작업 완료·입력 대기 때 나는 소리

🔵 정본은 옵시디언 — 관제/seoul/starian-portal/알림음/설정.md 의 완료:·대기: 를 고치면 모든 머신 포털이 따른다. 아래는 이 브라우저만 따로 바꿀 때 쓴다(비워 두면 옵시디언 설정).

작업 완료

입력 대기

Passkey passkey/FIDO2 device 등록 (생체 인증·hardware key)

passkey를 등록하면 passcode 없이 device 인증(Touch ID·Face ID·yubikey 등)으로 로그인 가능합니다. brute force·timing attack 면역.

카드 상태 알림 상태가 바뀌면 음성으로 알림

터미널 카드가 작업중(active) → 입력 대기(waiting) 또는 작업 완료(idle) 로 바뀌면, 그리고 오류(error) 가 나면 "카드이름 + 상태"를 음성으로 알립니다. 작업중 진입은 알리지 않습니다(계속 울려서 알림이 무의미해짐).

상태 변경 시 음성 알림

내 비밀번호 로그인 비밀번호 변경

마스터 계정의 로그인 비밀번호를 변경합니다. 에이전트 통신 토큰(Passcode)과는 별개입니다.

현재 비밀번호

새 비밀번호 (8자 이상)

새 비밀번호 확인

계정 아이디/비번 계정 · 등급 · 공개 카드

계정마다 보이는 카드를 지정합니다. [공개 카드 선택]에서 카드를 체크로 여러 개 고르고, 목록에 없는 건 edu-* 같은 패턴으로 추가할 수 있습니다. 등급: viewer 화면만 · operator 입력 가능 · admin 모든 카드 + 계정 관리 · owner 제한 없음(마스터).

UI 옵션 화면 표시 설정

Portal UI 표시 방식을 설정합니다. 구성요소 라벨은 디버깅/스크린샷용으로, data-label 속성을 화면에 표시합니다.

구성요소 라벨 표시

Auto Update 새 commit 자동 git pull + restart

GitHub origin/main에 새 commit이 올라오면 5분마다 자동으로 git pull → npm install → systemctl restart 실행. 이 서버에 sudo NOPASSWD 또는 user systemd 권한이 있어야 합니다.

자동 업데이트 활성화

Portal Base URL 외부 공개 URL (webhook + identity injection)

peer webhook URL 및 ACP self-identity 주입에 사용되는 portal 외부 공개 URL. 우선순위: PORTAL_BASE_URL env > portal.baseUrl setting > 폴백(https://portal-seoul.starian.us). env가 설정되어 있으면 이 입력은 무시됩니다.

Portal Base URL

프로젝트 목록 (project_titles) vault·dashboard 합성 대상

vault 동기화 + Dashboard.md 자동 합성 대상이 되는 활성 프로젝트 키 목록입니다. 칩의 × 를 누르면 해당 프로젝트가 제거되며, 동시에 아래 project_reps 매핑에서도 제거됩니다. 추가/삭제 즉시 PUT /api/settings 로 저장되고 그 아래 대표 에이전트 패널이 재렌더됩니다. SSOT: portal-settings.json → aoe_default_categories.project_titles. (v1.27.21.0)

프로젝트 대표 에이전트 (project_reps) vault-snapshot 04/08/15/22 KST

각 프로젝트의 대표 에이전트를 드롭다운에서 선택합니다 (v1.27.20.0 — seoul/zalman/macmini 라이브 피어 통합 목록). portal cron이 04/08/15/22 KST마다 이 에이전트에게 vault 스냅샷(현황/일일작업기록/상태/할일) 작성 요청을 webhook으로 보냅니다. SSOT: portal-settings.json → aoe_default_categories.project_reps. 저장 값 형식: <machine>:<id>.

Terminal Order 터미널 사이드바 순서 조정

사이드바에 표시되는 터미널의 순서를 드래그로 조정합니다. 변경 후 저장하면 portal-settings.json의 terminalOrder 배열에 반영됩니다.

Quick Commands 단축 명령 등록

터미널 툴바에 표시되는 단축 명령 버튼을 등록합니다. 버튼 클릭 시 해당 명령이 현재 터미널에 자동 입력됩니다. portal-settings.json의 quickCommands 배열에 저장됩니다.

Remote Servers 원격 포탈 연결

다른 머신의 Portal 인스턴스를 등록합니다. 등록된 서버는 사이드바에서 빠르게 전환할 수 있으며, peer-to-peer 메시지 라우팅에도 활용됩니다.

AI 설정 인플루언서별 Gemini 계정·API 키

각 인플루언서가 사용할 Google 계정과 Gemini API 키를 따로 등록합니다. 저장된 키 원문은 목록/API 응답에 표시되지 않습니다.

인플루언서 목록을 불러오는 중...

아래 전역 키는 인플루언서와 무관한 기존 Portal 기능용입니다.

Portal 전역 Gemini API Key

봇 페어링 토큰 저장 & 게이트웨이 연결

Discord 봇 토큰을 입력하면 Portal이 게이트웨이에 연결되어 모든 Discord 메시지를 수신/송신합니다. 토큰은 AES-256-CBC로 암호화되어 저장되며, lib/discord-token.js를 통해 모든 Portal 코드(api-discord-bot, github-events, telegram, api-openai-bridge)와 channel-mcp(lib/portal-discord-token.ts)가 단일 source-of-truth로 사용합니다.

봇 토큰

채널 매핑 에이전트 ↔ Discord 채널 1:1 연결

각 에이전트(role)와 Discord 채널을 1:1 매핑합니다. 예: starian → #starian, eno → #eno. 매핑은 lib/discord-gateway.js의 inbound 라우팅(Discord → 에이전트), lib/discord-broadcast.js의 outbound 라우팅(에이전트 → Discord)에 사용됩니다. 봇 토큰·config·시스템채널은 모두 단일 진리원천 lib/discord-token.js를 통해 읽습니다.

기본 채널 (매핑 없을 때 fallback)

채널 관리 Discord 서버 채널 생성/수정/삭제

Discord 서버의 채널/카테고리를 직접 생성·수정·삭제합니다. Portal이 봇 권한으로 Discord REST API를 호출합니다. 채널 추가 후 채널 매핑 또는 Channel Routing에 등록해야 라우팅이 작동합니다.

채널 목록 불러오기 버튼을 누르거나 새로고침을 클릭하세요.

System Channels 시스템 메시지 전용 채널 ID

시스템 메시지가 전송되는 특수 채널입니다. status_board: server.ts의 상태 보드, main: github-events 알림, log: github-events 로그, pokeclaw: api-openai-bridge mirror, general: master/general fallback. 모두 lib/portal-discord-mappings.ts의 getSystemChannel()로 조회됩니다.

Status Board

Main

Log

Pokeclaw

General

Channel Routing 채널별 role + machine 라우팅 규칙

멀티 머신 라우팅 — 각 채널을 어느 role의 어느 machine(seoul/gcp-us/zalman/macmini/dongdong)에서 처리할지 명시합니다. discord-inbound.ts가 channel_id로 role+machine 조회 후 해당 머신의 peer로 라우팅합니다. terminal_mappings와 함께 inbound 메시지 destination 결정에 사용됩니다.

Channel ID	Role	Machine

상태 모니터링 게이트웨이 연결 상태 확인

Discord 게이트웨이 연결 상태, 최근 1시간 수신 건수, 최근 에러 로그를 확인합니다. 재연결 버튼은 disconnect()+connect() 호출(lib/discord-gateway.js).

채널 MCP: --

게이트웨이: --

최근 메시지: --

최근 1시간 수신: --건

Infrastructure 통합 대시보드

—

5 URL 헬스 (마스터 지정)

상태	URL	HTTP	응답(ms)	연속실패	마지막 전이

Tailscale 머신 (실시간)

상태	머신	OS	Tailscale IP	마지막 접속

Cloudflare Tunnel (server-seoul · cloudflared)

다운 시 자동 systemctl restart (60s 쿨다운)

알림 로그 (최근 20개)

tmux 관리

💡 Portal 표시명·그룹 → Terminal 탭 좌측 사이드바 카드에 즉시 반영됨

머신	tmux 세션명	tmux ID	Portal 표시명	그룹	윈도우	생성일	AoE	고정	작업
로딩…

Resource Lease Manager

Android·iOS·GPU 작업 충돌을 막는 중앙 자원 대여소

머신

포털이 떠 있는 머신 목록(정본: vault 초기세팅/harness/nodes.json) · 새 머신 추가

새 머신에 포털 설치

폰 알림

기기별 알림 스레드 · 유형별 처리규칙 · 라우팅 설정