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
.envto version control - Use
authenticateddeployment mode in production - Rotate API tokens regularly
- Use HTTPS for all external connections
- Restrict database access to localhost or VPN