OpenClaw + Lumecoder Complete Installation Guide
Complete OpenClaw installation and Lumecoder Provider integration on a fresh Ubuntu server, preparing for Telegram/Discord Bot usage.
Goals
- Install the latest version of OpenClaw
- Install and enable the Lumecoder Provider plugin
- Configure Lumecoder API Key
- Successfully call Gemini models via OpenClaw through Lumecoder
- Prepare for Telegram/Discord Bot integration
1. Environment Setup
System Requirements
- Ubuntu 20.04 / 22.04 / 24.04
- Internet access
- Regular user (non-root, use sudo when necessary)
2. Install Node.js (using nvm)
Install nvm
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Load nvm (or reopen terminal):
export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
Verify:
nvm -v
Install Node.js (OpenClaw recommends LTS)
nvm install --lts nvm use --lts
Verify:
node -v npm -v
3. Install OpenClaw
Use the official installation script (recommended):
curl -fsSL https://clawd.bot/install.sh | bash
Verify after installation:
openclaw --version
4. OpenClaw Initial Onboarding Recommendations
After installation, you'll enter an interactive guide. Recommended choices:
- Security prompt：
Yes - Onboarding mode：
QuickStart - Model/Auth provider：
Skip for now - Default model：
Keep current - Hatch mode：
Hatch in TUI - Web search：
Skip - Shell completion：
Yes (optional)
After completion, you'll automatically enter the OpenClaw TUI.
5. Install and Enable Lumecoder Provider Plugin
Install plugin
openclaw plugins install openclaw-lumecoder-auth
Enable plugin
openclaw plugins enable openclaw-lumecoder-auth
Restart Gateway (very important)
openclaw gateway restart
Important: You must restart the gateway after any plugin or Provider configuration changes!
6. Configure Lumecoder API Key
Login and configure API Key
openclaw models auth login --provider lumecoder
Enter your Lumecoder API Key when prompted.
On success, you'll see similar output:
- Auth profile:
lumecoder:default - Default model available:
lumecoder/gemini-2.5-flash
Set default model
openclaw models set lumecoder/gemini-2.5-flash
7. Verify Successful Connection (Key Step)
openclaw agent --local --session-id test -m "你好"
If you receive a normal response, it means:
- OpenClaw is working properly
- Requests are successfully routed to Lumecoder
- Gemini model calls are successful
8. Common Troubleshooting
Changes to plugin or Provider not taking effect
Make sure to restart gateway:
openclaw gateway restart
Error messages from official Anthropic
This means requests are not going through Lumecoder. Check:
- Is openclaw-lumecoder-auth properly enabled
- Is default model set to lumecoder/*
- Has gateway been restarted
9. Next Steps (Optional)
- Configure Telegram Bot / Discord Bot
- Use OpenClaw Gateway to expose services externally
- Implement quotas, auditing, and billing on Lumecoder server
Complete
You have successfully completed OpenClaw installation, Lumecoder Provider integration, and Gemini model calls. You can now proceed to Bot or commercial integration.