Wissensbasis

A step-by-step guide for getting your AI assistant up and running — no technical knowledge required.

Step 1 — Accessing the Configuration Portal

When your server is ready, you will receive an email from Cloud Acropolis with your Configuration Portal URL and your Password. It looks like this:

To log in, follow these steps:

Security note: Your session is protected by two-factor authentication. A new one-time code is sent to your email every time you log in. Your session ends automatically after 45 minutes of inactivity.

The Portal — A Quick Overview

Once inside, you will see three main parts:

Cloud Acropolis  oc-xxx.cloudacropolis.lt 2 pending changesApply Configuration
Configuration AI Brain Channels Email Calendar Social Agents Agents	Add AI Provider       Configured Providers

• Top bar — always visible. Shows your server address, pending changes, the Apply Configuration button, and Sign Out.
• Left sidebar — navigation menu. Click any item to go to that section.
• Main area — where you configure each section. Add form at the top, existing items listed below.

Important: Whenever you make a change, you must click Apply Configuration at the top to save it. Changes are not applied automatically.

Step 2 — Connect Your AI Brain

This is the most important step. Your AI Brain is the intelligence behind your assistant. Without it, nothing else works. You need to connect at least one AI provider and give it your API key.

What is an API key?

An API key is like a password that gives OpenClaw permission to use the AI service on your behalf. You get it from the AI provider's website. It usually costs a small amount based on how much you use it.

Which AI provider should I choose?

Claude (Anthropic) Best for natural, human-like conversations

OpenAI (ChatGPT) Most well-known, great all-rounder

Groq Extremely fast responses

Ollama Your own server — no API costs

Tip: If you are not sure, start with Claude Sonnet (Anthropic) or GPT-4o Mini (OpenAI). Both are fast, affordable, and excellent for business use.

How to connect an AI provider:

1. In the sidebar, click AI Brain
2. Click on your chosen provider from the grid
3. Paste your API key — click the help link next to it if you do not have one yet
4. Choose a model (the default is a good starting point)
5. Click Save Provider
6. Click Apply Configuration at the top

Step 3 — Connect Your Communication Channels

This is where you tell OpenClaw which platforms to listen on. Your AI assistant will automatically respond to messages received on the channels you connect.

WhatsApp

Telegram

Slack

Discord

Signal

MS Teams

You can connect as many channels as you like. Each channel can have multiple accounts — for example, a “sales” WhatsApp account and a “support” WhatsApp account.

How to connect a channel:

1. In the sidebar, click Channels
2. Click on the channel type you want to connect (e.g. WhatsApp)
3. Give the account a name (e.g. “default”, “sales”, “support”)
4. Fill in the required details — each channel has a help link explaining exactly where to find them
5. Click Connect Channel
6. Click Apply Configuration at the top

WhatsApp tip: You will need to scan a QR code after saving your number. Follow the on-screen instructions — it takes less than a minute.

Step 4 — Connect Your Email

Connecting email allows your AI assistant to read incoming emails and reply on your behalf. You can connect one email account or several — one for each department if you like.

How to connect an email account:

1. In the sidebar, click Email
2. Give the account a name (e.g. “default”, “sales”, “support”)
3. Fill in your IMAP and SMTP server details
4. Enter your email address and password
5. Click Save Email Account
6. Click Apply Configuration at the top

Gmail / Outlook users: If you use two-factor authentication, you need to create an App Password — a special password just for OpenClaw. The portal includes a direct guide link for both Gmail and Outlook.

Step 5 — Connect Your Calendar

Connecting a calendar lets your AI assistant check your availability, schedule meetings, and manage appointments automatically.

Supported calendar types:

• Google Calendar — connect via OAuth (one click)
• Outlook / Microsoft 365 — connect via OAuth (one click)
• Calendly — paste your API key
• CalDAV — for Nextcloud, Fastmail, and other self-hosted options

How to connect a calendar:

1. In the sidebar, click Calendar
2. Give the account a name (e.g. “work”, “personal”)
3. Select your calendar type
4. Follow the instructions for your chosen type
5. Click Save Calendar
6. Click Apply Configuration at the top

Step 6 — Connect Social Media (Postiz)

Your server comes with Postiz pre-installed — a social media scheduling platform that lets you publish content to LinkedIn, Instagram, Twitter/X, Facebook, and more. Once connected, your AI assistant can create and schedule posts directly from your conversations.

How to activate Postiz:

1. Open your Postiz URL (in your welcome email — looks like https://oc-pc-xxx.cloudacropolis.lt)
2. Register your account using your email and a password of your choice
3. Go to Settings → Developers → Public API and copy your API key
4. In the sidebar, click Social
5. Paste the API key into the field
6. Click Save & Connect
7. Click Apply Configuration at the top

Important: Register your Postiz account before sharing your server with anyone. Registration is only open for the first account — after that it closes automatically.

Step 7 — Set Up Your Agents

An Agent is a personalised AI persona. Think of it as a member of your team — each one has its own name, personality, communication channels, email account, and calendar.

You might set up one agent for customer support, another for sales, and a third just for handling emails. Or you can start with a single agent that does everything.

How to create an agent:

1. In the sidebar, click Agents
2. Enter an Agent ID (e.g. “support”, “sales”) and a Display Name (e.g. “Support Agent”)
3. Click Add Agent

How to configure an agent:

Once created, click Edit to open the agent editor. Here you can:

• Choose an AI model (only available after connecting an AI provider)
• Set a token budget (controls how much the agent can process per conversation)
• Bind the agent to one or more communication channels
• Assign a dedicated email account to the agent
• Assign a calendar to the agent
• Upload agent files — such as SOUL.md (the agent’s personality) and IDENTITY.md (who the agent presents itself as)

Tip: The SOUL.md file is the most important file. It defines how your agent behaves, what tone it uses, and what it can and cannot do. Write it as if you are briefing a new employee.

Monitoring — Check That Everything Is Working

The Monitoring section gives you a complete overview of your configuration at a glance. You can see which AI providers are connected, which channels are live, whether email and calendar are set up, and whether Postiz is connected. If anything is missing, each section has a direct link to go and fix it.

Recommended Setup Order

AI Brain

→

Channels

→

Email

→

Calendar

→

Social

→

Agents

You do not need to complete every section. For example, if you only need WhatsApp and email, just set those up and create your agent.

Need Help?

Our support agent Sina is available via WhatsApp and typically responds within 4 business hours.

Chat with Sina on WhatsApp

You can also:

• Visit our Knowledge Base for more guides
• Open a Support Ticket
• Email us at support@cloudacropolis.lt

Cloud Acropolis — OpenClaw Business Agency  ·  Security · Reliability · Performance