docker-moltbot-open: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Docker Moltbot is a Docker-based deployment of Moltbot (formerly Clawdbot), an AI personal assistant that runs locally with security hardening built-in. This repository provides a production-ready Docker setup with:

• Security hardening by default (non-root user, loopback binding, pairing-based authentication)
• Multi-channel support (Telegram, WhatsApp, Discord, Slack, Webchat)
• Multi-LLM support (Claude, GPT, Gemini, OpenRouter)
• Persistent storage with Docker volumes
• Automated configuration via environment variables

Build and Run Commands

Basic Commands

# Build and start container
docker compose up -d

# Rebuild from scratch (pulls latest moltbot)
docker compose build --no-cache
docker compose up -d

# View logs
docker compose logs -f              # Follow logs
docker compose logs --tail 100      # Last 100 lines

# Container lifecycle
docker compose restart              # Restart container
docker compose stop                 # Stop without removing
docker compose down                 # Stop and remove container
docker compose down -v              # Remove container + volumes (deletes all data)

# Access container shell
docker compose exec moltbot bash

Moltbot CLI Commands

# Configuration and status
docker compose exec moltbot moltbot status          # Show gateway status
docker compose exec -it moltbot moltbot configure   # Interactive setup wizard
docker compose exec moltbot moltbot doctor --fix    # Auto-detect and fix config issues
docker compose exec moltbot moltbot doctor          # Check issues without fixing

# Security
docker compose exec moltbot moltbot security audit  # Run security audit

# Channel management
docker compose exec -it moltbot moltbot channels login whatsapp   # Login to WhatsApp
docker compose exec moltbot moltbot pairing approve telegram <code>  # Approve Telegram pairing

# Note: The CLI uses 'moltbot' commands, but the actual runtime currently uses 'clawdbot'
# This is due to the ongoing rebrand. Both work interchangeably.