OpenClaw + Lumecoder Complete Installation Guide
Complete OpenClaw installation and Lumecoder Provider configuration on a fresh Ubuntu server, connecting Claude / Codex models, preparing for Telegram/Discord Bot usage.
Lumecoder provides third-party compatible API access and is not an official product of Anthropic, OpenAI, or any other model provider. Use it in compliance with local laws, provider terms, and your team's data requirements.
Goals
- Install the latest version of OpenClaw (requires Node.js >= 22)
- Configure Lumecoder Provider in openclaw.json
- Configure Lumecoder API Key
- Successfully call models via OpenClaw through Lumecoder
- Prepare for Telegram/Discord Bot integration
1. Environment Setup
System Requirements
- Ubuntu 20.04 / 22.04 / 24.04
- Node.js >= 22 (recommend installing LTS via nvm)
- 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 >= 22 (OpenClaw minimum requirement)
nvm install --lts nvm use --lts
Verify:
node -v npm -v
3. Install OpenClaw
Install globally via npm (recommended):
curl -fsSL https://openclaw.ai/install.sh | bash
After installation, run the onboarding wizard:
openclaw onboard --install-daemon
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. Configure Lumecoder Provider (Choose Models)
After OpenClaw installation, configure Lumecoder as a Provider in openclaw.json. Choose the guide based on the models you want to use:
Claude Models (Anthropic Messages API)
Claude Sonnet 4.6 / Opus 4.8 / Haiku 4.5
View Claude Setup Guide →Codex Models (OpenAI Responses API)
GPT-5.3 Codex / GPT-5.2 Codex / GPT-5.2, etc.
View Codex Setup Guide →Both Providers can be configured simultaneously — add them side by side under models.providers in openclaw.json.
6. Configure Lumecoder API Key
Get API Key
Log in to the Lumecoder dashboard, create a new key under "API Keys" (starts with sk-).
Enter the key in the apiKey field of the corresponding Provider in openclaw.json:
"apiKey": "sk-xxx" // 替换为你的真实密钥
Restart Gateway
openclaw gateway restart
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
- Model calls are successful, credits billing is working
8. Common Troubleshooting
Config changes not taking effect
Make sure to restart gateway:
openclaw gateway restart
Requests not going through Lumecoder
This means configuration is not effective. Check:
- Is the providers config in openclaw.json correct
- Does the apiKey start with sk- and is it valid
- Is default model set to lumecoder/* or lumecoder-openai/*
- 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 and Lumecoder Provider configuration. You can now proceed to Bot or commercial integration.