clarvis-ai

OpenClaw X Jarvis = "Clarvis"

---

3D Printing Made Easy

Open-source 3D printing assistant powered by AI. Talk to it from Telegram, Discord, or WhatsApp — send a sketch, photo, or describe what you want, and it will create or find a 3D model, slice it, and send it to your printer.

For a ready-to-use, anything-to-3D-print workflow without the setup, check out clarv.is.

Demo

3D Search — find → preview → slice → print	AI Replication — photo → 3D model → slice → print
demo_bike_bottle.mp4	demo_clamp.mp4

Sketch / Image → 3D	Modify 3D Models	Multiply, Slice & Print

What it does

• Video/image/text → 3D model — AI-powered 3D generation and 3D editing pipeline
• Search existing models — Finds matching 3D models on 3D Libraries
• Slice to G-code — CuraEngine with configurable profiles
• Print — Sends G-code to your printer via Moonraker (Klipper) or PrusaLink (Prusa)
• All from chat — Works through any available OpenClaw channel (Telegram, Discord, WhatsApp, etc)

Quick start

Prerequisites

• Docker Desktop (or Docker Engine + Compose V2)
• A Google API key (free) for the AI agent brain
• A Telegram bot token (from @BotFather) or Discord bot token

Install

git clone --recursive https://github.com/makermate/clarvis-ai.git
cd clarvis-ai
./setup.sh

The setup script will:

1. Build Docker images (OpenClaw + claw3d CLI, CuraEngine slicer)
2. Run OpenClaw's setup wizard (gateway, messaging channels, auth)
3. Run claw3d setup (capabilities, providers, API keys, skill modules)
4. Start all services

That's it. Open Telegram and message your bot.

Manual setup

If you prefer to configure things yourself:

cp env.example .env
# Edit .env with your API keys

docker compose up -d

Architecture

You (Telegram/Discord/WhatsApp)
        │
        ▼
   ┌─────────┐
   │ Gateway  │  OpenClaw + claw3d CLI + AI skill instructions
   └────┬─────┘
        │
        ▼
   ┌─────────┐
   │ Slicer   │  CuraEngine REST API (3D model → G-code)
   └────┬─────┘
        │
        ▼
   3D Printer (on your WiFi network)

Services:

• gateway — OpenClaw agent with claw3d CLI and skill instructions
• slicer — CuraEngine 5.6.0 HTTP API for slicing models to G-code

Configuration

Default API keys

Key	Required	Purpose	Get it at
GOOGLE_API_KEY	Yes	Agent brain (Gemini 2.5 Flash)	aistudio.google.com/apikey
FAL_API_KEY	For AI creation	Image/text → 3D model	fal.ai/dashboard/keys
THINGIVERSE_ACCESS_TOKEN	For search	Find existing models	thingiverse.com/apps/create

Printer setup

Once Clarvis is running, tell it about your printer from chat:

"I have a Creality K2 SE at 192.168.1.100 on port 4408"

Or configure via CLI:

docker compose exec gateway claw3d printer add \
  --name "My Printer" \
  --backend moonraker \
  --host 192.168.1.100 \
  --port 7125

Creating a printer profile for slicing

In Cura → File → Export Universal Cura Project (.3mf) Send the .3mf file to the agent in chat Provide your printer's IP address and port The agent extracts everything from the .3mf automatically — build volume, nozzle size, material settings, and all print profiles.

Commands

All interaction happens through chat. Just describe what you want:

• "Make me a phone stand" — searches Thingiverse or creates via AI
• Send a photo of a sketch — converts it to a 3D model
• "Print it at 60% strength" — slices and sends to printer
• "Rotate it 90 degrees" — adjusts the model orientation
• "Show me options for a vase" — searches and shows alternatives

Built on

      

OpenClaw — AI agent platform with Telegram, Discord & WhatsApp   ·   claw3d — 3D printing CLI & skills

How it's built

Clarvis AI is a distribution that combines three open-source projects into a single, ready-to-run stack:

Component	Repo	What it does
OpenClaw	openclaw/openclaw	AI agent platform — gateway, messaging channels (Telegram, Discord, WhatsApp), authentication, and skill execution engine
claw3d	makermate/claw3d	Python CLI that powers the whole workflow — AI model generation (FAL.ai), Thingiverse search, slicing, preview rendering, and printer control (Moonraker/PrusaLink)
claw3d-skill	makermate/claw3d-skill	Modular AI agent instructions that teach the OpenClaw agent how to understand user intent, route requests, and orchestrate the 3D printing workflow
curaengine-slicer-api	makermate/curaengine-slicer-api	FastAPI service wrapping CuraEngine 5.6.0 — handles slicing, mesh conversion (GLB/STL/USDZ), and printer profile management

This repo (clarvis-ai) adds the Docker Compose orchestration, the interactive setup script, and the Dockerfile that layers everything on top of OpenClaw. Each component can also be used independently.

Useful commands

# View logs
docker compose logs -f gateway

# Stop everything
docker compose down

# Rebuild after pulling updates
git pull --recurse-submodules
docker compose build
docker compose up -d

# Run claw3d CLI directly
docker compose exec gateway claw3d doctor

# Access the interactive CLI
docker compose --profile cli run cli

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines. Each component has its own repo — open PRs there for component-specific work, or here for setup/integration issues.

License

MIT