Configuration

Basic Configuration

Configure Clawdbot's essential settings to match your preferences and requirements. Learn about user accounts, networking, notifications, and security.

Before You Begin

Make sure Clawdbot is installed and running. Run clawdbot status to verify the service is active.

Quick Configuration Wizard

Use the interactive wizard for guided setup of basic settings.

Terminal

bash

# Launch configuration wizard
clawdbot configure

# The wizard will guide you through:
# • User account setup
# • Network preferences
# • Notification settings
# • Security options
# • Skill selection

User Account Setup

Configure user accounts and permissions for Clawdbot access.

Create Admin User

Terminal

bash

# Create admin account
clawdbot user create \
  --username admin \
  --email admin@example.com \
  --role admin

# Set password for admin
clawdbot user password admin --interactive

Store admin credentials securely. There's no password recovery feature yet.

Create Standard User

Terminal

bash

# Create standard user with limited permissions
clawdbot user create \
  --username family \
  --email family@example.com \
  --role standard

# Grant specific permissions
clawdbot user permissions grant family \
  --skills voice,calendar \
  --allow-commands "schedule.*,calendar.*"

Standard users can only access permitted skills and commands.

Network Configuration

Set up network preferences and connectivity options.

Configure Network Interface

Terminal

bash

# Prefer Ethernet over Wi-Fi
clawdbot config set network.interface en0

# Set static IP (optional)
clawdbot config set network.static-ip 192.168.1.100
clawdbot config set network.gateway 192.168.1.1
clawdbot config set network.dns 8.8.8.8,8.8.4.4

# Test network connectivity
clawdbot network test

Ethernet is recommended for stability and lower latency.

Configure Port Settings

Terminal

bash

# Change web dashboard port (default: 3000)
clawdbot config set server.port 8080

# Enable HTTPS
clawdbot config set server.https true
clawdbot config set server.ssl-cert /path/to/cert.pem
clawdbot config set server.ssl-key /path/to/key.pem

# Restart service to apply changes
clawdbot service restart

Ports below 1024 require admin privileges.

Notification Settings

Configure how Clawdbot sends alerts and notifications.

Enable Desktop Notifications

Terminal

bash

# Enable native macOS notifications
clawdbot config set notifications.desktop true

# Set notification sound
clawdbot config set notifications.sound "Glass"

Grant notification permissions when prompted by macOS.

Configure Email Alerts

Terminal

bash

# Set up email notifications
clawdbot notifications email enable \
  --smtp smtp.gmail.com \
  --port 587 \
  --from your-email@gmail.com \
  --user your-email@gmail.com \
  --password "app-password"

# Test email notification
clawdbot notifications email test \
  --to recipient@example.com

Use app-specific passwords for Gmail. Don't use your account password.

Security Settings

Secure your Clawdbot installation with best practices.

Enable Authentication

Terminal

bash

# Require authentication for web interface
clawdbot config set security.auth-required true

# Set session timeout (minutes)
clawdbot config set security.session-timeout 60

# Enable two-factor authentication
clawdbot security 2fa enable

2FA requires an authenticator app on your mobile device.

Configure Firewall

Terminal

bash

# Allow Clawdbot through macOS firewall
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/local/bin/clawdbot
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --unblock /usr/local/bin/clawdbot

# Restrict access to local network only
clawdbot config set security.allowed-hosts "192.168.1.*,127.0.0.1"

Limiting access to local network prevents external connections.

Quick Settings Reference

Common Configuration Commands

Frequently used settings for quick customization

Wake Word

clawdbot config set voice.wake-word "Hey Clawdbot"

Custom voice trigger for assistant activation

Default Language

clawdbot config set voice.language "en-US"

Set default language for voice interactions

Auto-Start

clawdbot service enable

Automatically start Clawdbot on boot

Log Level

clawdbot config set logs.level "info"

Control verbosity of logs (debug, info, warn, error)

Configuration Complete!

Your basic settings are configured. View current settings with clawdbot config list.

Next Steps

Now that basic configuration is complete, explore advanced options or start using Clawdbot.

Configure Advanced Settings Browse Skills View API Documentation Get Help