Custom Domains
Use your own domain to access your OpenClaw instance, like ai.yourcompany.com.
Custom domains apply to the public web path only. If you switch a bot to tailnet-only web chat, it uses the private *.ts.net URL on your customer-owned tailnet instead of a custom domain.
Setting Up a Custom Domain
Step 1: Add Your Domain
- Log in to your Customer Portal
- Scroll to the Custom Domain section
- Enter your desired domain (e.g.,
ai.yourcompany.com) - Click Set Domain
Step 2: Configure DNS
After setting your domain, you’ll see DNS configuration instructions:
- Log in to your DNS provider (Cloudflare, GoDaddy, Namecheap, etc.)
- Add a CNAME record:
- Name/Host: The subdomain part (e.g.,
aiforai.yourcompany.com) - Target/Points to: The CNAME target shown in your portal
- TTL: Auto or 300
- Name/Host: The subdomain part (e.g.,
Step 3: Wait for Verification
- DNS changes can take up to 48 hours to propagate
- We automatically verify your DNS configuration
- Status will change to Active once verified
DNS Provider Examples
Cloudflare
- Go to DNS settings for your domain
- Click Add record
- Type: CNAME
- Name:
ai(or your chosen subdomain) - Target: (the CNAME target from your portal)
- Proxy status: DNS only (gray cloud)
GoDaddy
- Go to DNS Management
- Click Add
- Type: CNAME
- Host:
ai - Points to: (the CNAME target from your portal)
- TTL: 1 Hour
Namecheap
- Go to Advanced DNS
- Click Add New Record
- Type: CNAME Record
- Host:
ai - Value: (the CNAME target from your portal)
- TTL: Automatic
Troubleshooting
Domain shows “Pending”
- DNS changes haven’t propagated yet
- Wait up to 48 hours
- Verify your CNAME record is correct
Domain shows “Failed”
- Check that the CNAME record points to the correct target
- Ensure there’s no conflicting A record for the same subdomain
- Contact support if the issue persists
SSL Certificate Issues
- SSL certificates are automatically provisioned
- Allow up to 24 hours after DNS verification
- Clear your browser cache if you see certificate warnings
Removing a Custom Domain
- Go to your Customer Portal
- Click Remove next to your custom domain
- Your instance will be accessible via the default URL
Need Help?
Contact [email protected] if you need assistance with custom domain setup.