Basic Configuration
FinClaw's runtime configuration is centralized in the .env file in the deployment directory (generated from .env.example by init-env.sh).
Required Items
| Variable | Description | Example |
|---|---|---|
LLM_PROVIDER | LLM provider | deepseek |
LLM_MODEL | Model name | deepseek-v4-flash |
LLM_API_KEY | API key | (required) |
LLM_BASE_URL | Custom base URL (as needed) | https://api.deepseek.com/v1 |
Common Optional Items
| Variable | Default | Description |
|---|---|---|
ADMIN_EMAILS | admin@example.com | Administrator emails (comma-separated); determines admin privileges |
AI_INFRA_RS_GLOBAL_CONCURRENCY | 64 | Global concurrency limit for the AI runtime |
AI_INFRA_RS_PER_USER_CONCURRENCY | 10 | Per-user concurrency limit |
AI_INFRA_RS_RPM_PER_USER | 120 | Per-user requests-per-minute limit |
For more configuration, see Business Configuration and Operations Configuration.
Customizing the External Port
By default, FinClaw exposes the API Gateway on host port 26100 (the api-gateway service in docker-compose.yml maps 26100:26100). If that port is taken or your environment requires a different ops port, change it as follows (example: switch to 28100).
Using docker-compose.override.yml
Leaves the original docker-compose.yml untouched, so upgrades do not overwrite your change.
bash
cd /data/chatkit-offline-release-<version>-linux-amd64/deploy
cat > docker-compose.override.yml <<'EOF'
services:
api-gateway:
ports:
- "28100:26100" # left = host port, right = container port (DO NOT change)
EOF
# Restart to apply
./scripts/fleet.sh basic down
./scripts/fleet.sh basic up -d