Hub Configuration

Configure adapters, integrations, and features

Configuration Files

SeaClip uses two configuration sources:

File Purpose
.env Environment variables (secrets, URLs)
~/.seaclip/config.json User preferences and feature flags

Environment Variables

Core Settings

.env
# Server
PORT=51842
NODE_ENV=production

# Deployment mode
# local_trusted: No auth required (development/home lab)
# authenticated: Requires API tokens
SEACLIP_DEPLOYMENT_MODE=local_trusted

# Edition
# simple: Base features
# enhanced: All features including Pixel Office, BMAD, etc.
SEACLIP_EDITION=simple

Database

.env
# SQLite (default - no config needed)
# Leave DATABASE_URL unset to use embedded SQLite

# PostgreSQL
DATABASE_URL=postgres://user:password@localhost:5432/seaclip

# Connection pool settings
DATABASE_POOL_MIN=2
DATABASE_POOL_MAX=10

Ollama Integration

.env
# Ollama API endpoint
OLLAMA_BASE_URL=http://localhost:11434

# Default model for agents
OLLAMA_DEFAULT_MODEL=llama3

# Request timeout (ms)
OLLAMA_TIMEOUT=120000

Telegram Bridge

.env
# Get from @BotFather on Telegram
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz

# Chat ID for notifications (use @userinfobot to find yours)
TELEGRAM_CHAT_ID=-1001234567890

# Enable/disable Telegram adapter
TELEGRAM_ENABLED=true

Edge Mesh Settings

.env
# Telemetry collection interval (seconds)
SEACLIP_TELEMETRY_INTERVAL=30

# Device offline threshold (seconds)
SEACLIP_OFFLINE_THRESHOLD=90

# Auto-reassign tasks when device goes offline
SEACLIP_AUTO_REASSIGN=true

Enhanced Features (v2)

.env — Enhanced edition only
# BMAD Agent Profiles
SEACLIP_FEATURE_BMAD=true

# Grammar Shield (prompt injection detection)
SEACLIP_FEATURE_GRAMMAR_SHIELD=true

# Secret filtering (AGENT_ prefix)
SEACLIP_FEATURE_SECRET_FILTER=true

# Vector memory / RAG
SEACLIP_FEATURE_VECTOR_MEMORY=true
OPENAI_API_KEY=sk-...  # For embeddings (optional, falls back to Ollama)

# Pixel Office visualization
SEACLIP_FEATURE_PIXEL_OFFICE=true

# GMeet-style agent calls
SEACLIP_FEATURE_GMEET=true

# Git-Agent workflow
SEACLIP_FEATURE_GIT_AGENT=true

Config File

The config file stores user preferences:

~/.seaclip/config.json
{
  "edition": "enhanced",
  "server": {
    "port": 51842,
    "deploymentMode": "local_trusted"
  },
  "database": {
    "mode": "embedded"
  },
  "ollama": {
    "baseUrl": "http://localhost:11434",
    "defaultModel": "llama3"
  },
  "features": {
    "bmadProfiles": true,
    "grammarShield": true,
    "secretFiltering": true,
    "vectorMemory": true,
    "pixelOffice": true,
    "gmeetInterface": true,
    "gitAgent": true
  },
  "ui": {
    "theme": "dark",
    "animationsEnabled": true
  }
}

Adapter Configuration

Available Adapters

Adapter Purpose Config Key
Ollama Local LLM inference OLLAMA_*
Agent Zero Autonomous agent sessions AGENT_ZERO_*
Telegram Bot commands & notifications TELEGRAM_*
SeaClaw SeaClaw agent integration SEACLAW_*
Webhook Custom HTTP callbacks WEBHOOK_*
Federation Multi-hub sync FEDERATION_*

Agent Zero Configuration

.env
# Agent Zero API endpoint
AGENT_ZERO_URL=http://localhost:5000

# Session persistence
AGENT_ZERO_PERSIST_SESSIONS=true

# Memory sync interval (seconds)
AGENT_ZERO_SYNC_INTERVAL=60

Federation Configuration

.env
# Enable federation
FEDERATION_ENABLED=true

# This hub's unique ID
FEDERATION_HUB_ID=hub-primary

# Peer hubs (comma-separated)
FEDERATION_PEERS=https://hub2.example.com:51842,https://hub3.example.com:51842

# Sync interval (seconds)
FEDERATION_SYNC_INTERVAL=300

# Shared secret for hub-to-hub auth
FEDERATION_SECRET=your-shared-secret

CLI Configuration Commands

bash
# View current config
pnpm cli config show

# Set a value
pnpm cli config set ollama.defaultModel mistral

# Reset to defaults
pnpm cli config reset

# Validate configuration
pnpm cli config validate

Security Best Practices

Production Checklist:
  • Never commit .env to version control
  • Use authenticated deployment mode in production
  • Rotate API tokens regularly
  • Use HTTPS for all external connections
  • Restrict database access to localhost or VPN