Getting Started with Your OpenClaw VM
Your OpenClaw VM is an Ubuntu 22.04 virtual machine with OpenClaw pre-installed and running. You have full SSH access and can manage OpenClaw via the command line interface (CLI). This guide will help you connect to your VM and get started with OpenClaw.
1. Connecting to Your VM
You will need an SSH client to connect to your VM.
- Windows users: We recommend PuTTY (https://www.putty.org/) or Windows Terminal.
- Mac/Linux users: Use the built-in Terminal app.
Your connection details were sent in your welcome email:
- Public IP: shown in your welcome email and client area
- Username: root
- Password: shown in your welcome email
- Port: 22
To connect via Terminal or Command Prompt:
ssh root@YOUR_PUBLIC_IP
To connect via PuTTY:
- Open PuTTY
- Enter your Public IP in the Host Name field
- Port: 22, Connection type: SSH
- Click Open
- Enter root as the username and your password when prompted
2. First Steps After Connecting
Change your root password immediately:
passwd
Check OpenClaw is running:
docker ps
You should see the OpenClaw container with status healthy.
3. OpenClaw CLI
OpenClaw is managed via the command line from inside the container. Use the following command structure:
cd /opt/openclaw && docker compose exec openclaw-gateway node dist/index.js COMMAND
|
Command |
Description |
|
... status |
Check gateway status |
|
... status --deep |
Full health check |
|
... logs --follow |
View live gateway logs |
|
... channels status |
Check configured channels |
|
... gateway restart |
Restart the gateway |
|
... devices list |
List connected devices |
Example - Check status:
cd /opt/openclaw && docker compose exec openclaw-gateway node dist/index.js status
4. Configuring Your LLM Provider
OpenClaw requires an LLM provider (such as OpenAI, Anthropic, or others) to function.
Step 1 - Configure your provider:
cd /opt/openclaw && docker compose exec openclaw-gateway node dist/index.js config set --batch-json '[{"path":"providers.openai.apiKey","value":"YOUR_API_KEY"}]'
Step 2 - Restart the gateway:
cd /opt/openclaw && docker compose restart
For a full list of supported providers: https://docs.openclaw.ai/providers
5. Managing the OpenClaw Container
|
Command |
Description |
|
cd /opt/openclaw && docker compose up -d |
Start OpenClaw |
|
cd /opt/openclaw && docker compose down |
Stop OpenClaw |
|
cd /opt/openclaw && docker compose restart |
Restart OpenClaw |
|
cd /opt/openclaw && docker compose logs -f |
View live logs |
|
cd /opt/openclaw && docker compose pull && docker compose up -d |
Update to latest |
6. Full Documentation
For complete OpenClaw documentation including channels, agents, tools and integrations:
https://docs.openclaw.ai
7. Need Help?
If you need assistance, please contact our support team:
- Email: support@cloudacropolis.lt
- Support Portal: Log in to your client area and open a support ticket
We thank you for your trust
Yours Truly,
Cloud Acropolis Team
