Skip to main content

Floating OpenClaw Chat Support

Need help with the app? Learn more about the app or browse our support documentation below.

About the App

Floating OpenClaw Chat is a macOS menu bar application that provides a floating chat bubble for instant AI conversations through your OpenClaw gateway. Chat with your AI assistant without leaving your current app.

Getting Started

  1. Download and install the app from the Mac App Store
  2. Ensure your OpenClaw gateway is running locally
  3. Launch Floating OpenClaw Chat
  4. Click the floating bubble or press Cmd+Shift+O to open the chat panel
  5. Start chatting with your AI assistant

Configuring the Gateway Connection

The app connects to your local OpenClaw gateway via WebSocket. By default, it looks for the gateway at:

  • Default URL: ws://localhost:8080
  • You can configure the gateway URL in the app settings

Using the Floating Bubble

The floating bubble stays on top of all your windows:

  • Click the bubble: Opens the chat panel
  • Drag the bubble: Reposition it anywhere on screen
  • Cmd+Shift+O: Global shortcut to toggle the chat panel
  • The bubble position is remembered between sessions

Managing Chat Sessions

You can work with multiple chat sessions:

  • Use the dropdown menu to switch between sessions
  • Create new sessions for different topics or projects
  • Each session maintains its own conversation history

Frequently Asked Questions

Q: The app won't connect to my gateway

A: Make sure your OpenClaw gateway is running. Check that:

  1. The gateway is started and accessible
  2. The gateway URL in settings matches your actual gateway address
  3. No firewall is blocking local connections
  4. The gateway is configured to accept WebSocket connections

Q: Can I change the keyboard shortcut?

A: The default shortcut is Cmd+Shift+O. You can configure this in the app settings if you need a different key combination.

Q: The bubble disappeared, how do I get it back?

A: Look for the OpenClaw icon in your menu bar. Click it to access the menu and reset the bubble position, or use the global keyboard shortcut.

Q: Is my conversation data private?

A: Yes. All communication happens locally between the app and your OpenClaw gateway. No data is sent to external servers. See our Privacy Policy for more details.

Q: What macOS version is required?

A: The app requires macOS 12.0 (Monterey) or later.

Q: Does the app work without an internet connection?

A: The app communicates with your local OpenClaw gateway. Whether you need internet depends on how your gateway is configured and which AI services it connects to.

Keyboard Shortcuts

  • Cmd+Shift+O: Toggle chat panel (global, works from any app)
  • Cmd+W: Close chat panel
  • Cmd+,: Open settings
  • Return: Send message
  • Shift+Return: New line in message

Troubleshooting

App not responding

  1. Try closing and reopening the chat panel
  2. Restart the app from the menu bar
  3. Check if your OpenClaw gateway is still running
  4. Check macOS Console for any error messages

Messages not sending

  1. Verify your gateway connection is active
  2. Check the gateway logs for any errors
  3. Try switching to a new session
  4. Restart both the app and the gateway

Support Contact

For support inquiries, please contact us via our contact form.

Version Information

Current Version: 1.0

Requires: macOS 12.0 (Monterey) or later

Requires: OpenClaw gateway running locally