Self-hosted means you run LemonClaw directly on your own VPS or machine. You only pay for AI model usage through your LemonData balance — no instance fees.
Prefer a hosted setup? Create a Claw instance to get the same LemonClaw runtime and WebUI without managing servers yourself. Quick Install Linux / macOS
Non-interactive
curl -fsSL https://raw.githubusercontent.com/hedging8563/lemonclaw/main/deploy/self-hosted/install.sh | bash
The installer will prompt you for your LemonData API Key . Get one from your Dashboard .
What Gets Installed
Node.js 22+
Automatically installed if missing (via NodeSource on Linux, Homebrew on macOS)
LemonClaw
LemonClaw package pre-configured with LemonData API
15 AI Models
Claude, GPT-5, Gemini, DeepSeek, and more — ready to use
IM Plugins
DingTalk, WeCom, and QQ plugins pre-installed
System Service
Auto-starts on boot (systemd on Linux, launchd on macOS)
Requirements Requirement Details OS Linux (Ubuntu/Debian/CentOS/RHEL) or macOS Architecture x64 or arm64 RAM 1 GB minimum, 2 GB recommended API Key Get one here
After Installation The installer outputs your access credentials:
✓ LemonClaw installed successfully! WebUI: http://your-ip:18789 Token: your-gateway-token Auto-login: http://your-ip:18789?token=your-gateway-token Model: claude-sonnet-4-6
Save your token! You need it to access the WebUI and connect messaging platforms.
Access the WebUI at http://your-ip:18789 with your token, then follow the platform-specific guides:
The platform guides in this section cover the same LemonClaw WebUI used by both hosted Claw instances and self-hosted LemonClaw installs. If a guide mentions the Claw Dashboard, self-hosted users should open their own WebUI directly instead.
Management Commands systemctl --user status lemonclaw # Check status journalctl --user -u lemonclaw -f # View logs systemctl --user restart lemonclaw # Restart systemctl --user stop lemonclaw # Stop
tail -f ~/.lemonclaw/lemonclaw.log # View logs launchctl stop cc.lemondata.lemonclaw && launchctl start cc.lemondata.lemonclaw # Restart launchctl stop cc.lemondata.lemonclaw # Stop
Configuration Config file location: ~/.lemonclaw/config.json
After editing, restart the service to apply changes.
Change Default Model { "agents" : { "defaults" : { "model" : { "primary" : "lemondata-claude/claude-opus-4-6" } } } }
Available model prefixes (depending on which providers you enabled in LemonData Provider Setup ):
lemondata/ — OpenAI-compatible route (openai-completions)lemondata-responses/ — OpenAI Responses route (openai-responses)lemondata-claude/ — Claude native route (anthropic-messages)lemondata-gemini/ — Gemini native route (google-generative-ai)lemondata-minimax/ — MiniMax native route (anthropic-messages)
Upgrade # Re-run the installer to upgrade to the latest version curl -fsSL https://raw.githubusercontent.com/hedging8563/lemonclaw/main/deploy/self-hosted/install.sh | bash # Then restart the service systemctl --user restart lemonclaw # Linux # or launchctl stop cc.lemondata.lemonclaw && launchctl start cc.lemondata.lemonclaw # macOS
Uninstall # Stop and disable service systemctl --user stop lemonclaw && systemctl --user disable lemonclaw # Linux launchctl unload ~/Library/LaunchAgents/cc.lemondata.lemonclaw.plist # macOS # Remove LemonClaw rm -rf ~/.lemonclaw
Self-Hosted vs Managed Self-Hosted Managed (Claw) Instance cost Free $20 / 30 days AI usage Pay-per-use Pay-per-use Infrastructure Your server We manage everything Updates Manual (re-run installer) Automatic Support Community Priority
