How to receive SMS in OpenClaw
This guide walks you through retrieving incoming SMS messages directly from OpenClaw using the Ozeki SMS MCP server. By following this tutorial, you will learn how to launch OpenClaw, switch to the normal agent mode, ask it to list incoming messages in plain language, and verify the transaction through the gateway logs.
What is an MCP tool call?
An MCP (Model Context Protocol) tool call is how an AI model communicates with external systems. When the AI needs to perform an action or retrieve data, such as querying a database, calling an API, or reading a file, it sends a structured request to the appropriate MCP server, which processes it and returns the result.
Example prompt
List all my incoming SMS messages.
Steps to follow
We assume Ozeki SMS Gateway is already installed on your system, you have created an MCP user account with an API key, and you have already configured the Ozeki SMS MCP server in OpenClaw.
- Launch OpenClaw
- Switch to normal agent mode
- Use the list incoming messages tool
- Verify the transaction in logs
How to receive SMS in OpenClaw video
The following video shows how to retrieve incoming SMS messages from OpenClaw using the Ozeki SMS MCP server step-by-step.
Step 1 - Launch OpenClaw
Open a terminal window and navigate to your working directory. Type openclaw
and press Enter to start OpenClaw (Figure 1).
Step 2 - Switch to normal agent mode
By default, OpenClaw may start in a restricted agent mode that limits tool access. To allow MCP tool calls, switch to the normal agent mode. You can do this by selecting the normal agent option from the mode menu or by issuing the appropriate command in the OpenClaw interface (Figure 2).
Step 3 - Use the list incoming messages tool
In the OpenClaw prompt, type your request in plain language and press Enter. OpenClaw will interpret the request and invoke the appropriate MCP tool to retrieve the messages from the gateway inbox (Figure 3).
List all my incoming SMS messages.
OpenClaw will display the result returned by the Ozeki SMS MCP server. You should see the list of incoming messages, each with the sender number, message text, and timestamp confirming when it was received (Figure 4).
Step 4 - Verify the transaction in logs
Open Ozeki SMS Gateway in your browser and navigate to the event log of your MCP user. You should see a log entry for the incoming message retrieval request, confirming that the API key authentication and tool call were processed correctly by the gateway (Figure 5).
Final thoughts
You have successfully retrieved incoming SMS messages from OpenClaw using the Ozeki SMS MCP server. OpenClaw can now list incoming messages from your gateway simply by being asked to do so in plain language, making it easy to add SMS inbox access to any OpenClaw workflow.