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.

UbuntuOpenClawLumecoder

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.6 / 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

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.