Introduction
Imagine having a personal AI assistant that can automate tasks, answer queries, and engage in conversations on platforms you use daily, like Telegram and Discord. With OpenClaw, this is not just a dream but a reality that can be set up in under a minute. But why OpenClaw? This powerful open-source framework integrates with leading LLMs (like Claude, GPT, and Gemini), enabling seamless automations and skills that can improve productivity and engagement.
This guide will walk you through the essential steps to set up OpenClaw on EaseClaw, a hosted deployment platform that simplifies the process for non-technical users. Let's dive in!
Key Benefits
- ●Quick Setup: Deploy your assistant on Telegram or Discord in under 1 minute with EaseClaw.
- ●User-Friendly Interface: No coding or technical skills required; the onboarding wizard guides you through the setup.
- ●Integration with LLMs: Choose from Claude, GPT, or Gemini for your AI model.
- ●24/7 Availability: Host your assistant on a VPS for uninterrupted service.
- ●Extensive Functionality: Utilize skills for automations, tasks, and integrations with Google Workspace.
How It Works
- 1.OpenClaw Installation: Use a one-liner script to install OpenClaw tailored for your operating system.
- 1.Configuration: During onboarding, input your LLM API key and choose your messaging platform.
- 1.Service Initialization: Start the necessary services to enable communication between your assistant and users.
- 1.Channel Setup: Follow prompts to set up the Telegram or Discord bot and establish communication.
- 1.Skill Integration: Enhance your assistant with automations and skills to maximize its capabilities.
Step-by-Step Guide
Step 1: Install OpenClaw
To begin, you need to install OpenClaw on your machine. Here’s how to do it:
- ●For macOS/Linux: Open your terminal and run:
- ● ```bash
- ● curl -fsSL https://openclaw.sh/install | bash
- ● ```
- ●For Windows: Open PowerShell and run:
- ● ```powershell
- ● irm https://openclaw.sh/install.ps1 | iex
- ● ```
- ●This will launch an interactive onboarding wizard to guide you through the setup process.
Step 2: Configure During Onboarding
During the setup, you’ll need to provide some key information:
- ●LLM API Key: Enter your key from OpenAI, Anthropic (Claude), or Google Gemini.
- ●Communication Channels: Select whether you want to set up for Telegram or Discord (skip others for now).
- ●Skills & Hooks: Enable these features to allow your assistant to perform tasks and automations.
Step 3: Start Services
Once the configuration is complete, you need to start the services:
- ●Run the gateway with the following command:
- ● ```bash
- ● openclaw gateway --port 18789
- ● ```
- ●Open the dashboard by executing:
- ● ```bash
- ● openclaw dashboard
- ● ```
- ●This will automatically open the dashboard in your browser at `http://127.0.0.1:18789`.
Step 4: Set Up Telegram or Discord
For Telegram, follow these steps:
- ●In the dashboard chat, type "Let's set up Telegram."
- ●OpenClaw will provide instructions to use BotFather for bot creation. Create your bot and get the API token and pairing code.
- ●Paste the token and code back into the dashboard chat.
- ●Test the setup by sending a message to your bot in Telegram; it should respond accordingly.
For Discord, you’ll follow similar prompts for bot invitation and token retrieval.
Step 5: Configure for Security
To enhance security, edit the `~/.openclaw/openclaw.json` file:
- ●Add an allowlist to restrict access:
- ● ```json
- ● channels: { telegram: { allowFrom: ["your_user_id"] } }
- ● ```
- ●Set mention patterns (like `"@openclaw"`) and configure session resets (e.g., daily at 4 AM).
- ●Check logs for any errors or activity at `/tmp/openclaw/` or in log files named `openclaw-YYYY-MM-DD.log`.
Step 6: Access Interfaces
You can manage your assistant through various interfaces:
- ●Dashboard: Use `openclaw dashboard` to manage chats, skills, and logs.
- ●Terminal UI: Access with `openclaw tui` for commands like `/status` and `/model`.
- ●Useful CLI Commands:
- ● - List channels: `openclaw channels list`
- ● - Check model status: `openclaw models status`
Step 7: For 24/7 VPS Deployment
If you want your assistant to be available 24/7:
- ●Set up a VPS (like DigitalOcean or Linode) and install Docker.
- ●Run the OpenClaw container and connect it to your LLM and channels as mentioned earlier.
- ●You can use a cron job to ensure it wakes up as needed.
Step 8: Add Skills and Integrations
After the basic setup, you can enhance your assistant:
- ●In the dashboard, install skills for automations (like Google Workspace).
- ●Use the chat function to type "install skills" for guided setup.
Best Practices
- ●Security: Always allowlist user IDs and use secure tokens; enable daily resets and idle timeouts.
- ●Reliability: Run OpenClaw as a daemon for continuous operation; consider using a VPS for uptime.
- ●Customization: Tailor the scope of sessions per sender and set requirements for group mentions.
- ●Updates: Regularly check for updates and rerun onboarding if necessary.
- ●Integrations: Prioritize integrating Google APIs for enhanced productivity.
Common Pitfalls and Fixes
- ●Gateway Not Connecting: Ensure the token is correctly pasted into the dashboard settings and that port 18789 is free.
- ●Bot Not Responding: Verify that the API token and pairing code are correctly entered; check the bot's status in the dashboard.
- ●Auth Prompts: Use a clean link from the channels login to avoid issues with tokenized URLs.
- ●Local vs. Cloud: Remember that local setups stop running when the machine shuts down—consider VPS for 24/7 access.
- ●Model Issues: Check the validity of your API key and consider fallback options if limits are reached.
- ●Logs Missing: Verify the log directory `/tmp/openclaw/` and enable verbose logging in your config file.
Conclusion
With OpenClaw and EaseClaw, setting up your very own AI assistant has never been easier. Follow the steps outlined above, and you'll be well on your way to deploying an intelligent, responsive assistant on Telegram or Discord. The potential for automations, integrations, and enhanced user engagement is vast. So why wait? Start your journey with EaseClaw today and transform how you interact with technology.