Satisfactory Bridge

Lightweight HTTP bridge between OpenClaw AI and Satisfactory (via FicsIt-Networks).

Architecture

OpenClaw ──POST /command──► Bridge ◄──GET /command── FicsIt Computer
              │                            │
         (push commands)             (poll & execute)
              │                            │
         GET /responses ◄── POST /response ─┘
              │                   (report results)
         (check results)

Endpoints

Method	Endpoint	Auth	Description
POST	/command	✓	Push command to queue
GET	/command	✓	Poll & consume next command
GET	/queue	✓	View queue (non-destructive)
DELETE	/queue	✓	Clear all pending commands
POST	/response	✓	Game reports command result
GET	/response	✓	Game reports result (Linux server workaround)
GET	/responses	✓	Get all responses (last 100)
GET	/status	✗	Health check

Auth

Pass API key via:

• Header: X-API-Key: your-key
• Query: ?key=your-key

Command Format

{
  "id": "optional-unique-id",
  "action": "set_production",
  "target": "constructor_01",
  "params": {
    "recipe": "iron_plate",
    "enabled": true
  }
}

Configuration

Environment variables:

Variable	Default	Description
BRIDGE_API_KEY	change-me-in-production	API key for authentication
BRIDGE_PORT	:8080	Port to listen on

Setup on Alpine LXC

# 1. Install Go
apk add go git

# 2. Clone and build
git clone https://github.com/YOUR-USER/satisfactory-bridge.git
cd satisfactory-bridge
go build -o bridge main.go

# 3. Run with custom API key
export BRIDGE_API_KEY="your-secure-key"
./bridge

Systemd Service (OpenRC for Alpine)

See bridge.initd for Alpine init script.

Example Usage

# Push a command
curl -X POST http://YOUR_SERVER_IP:8080/command \
  -H "X-API-Key: satisfactory-lexis-2026" \
  -H "Content-Type: application/json" \
  -d '{"action": "get_status", "target": "factory"}'

# Check status
curl http://YOUR_SERVER_IP:8080/status

# View queue
curl -H "X-API-Key: satisfactory-lexis-2026" \
  http://YOUR_SERVER_IP:8080/queue