Voice

Plugin Bitchat

Name: Plugin Bitchat
Rating: 3.5 (1 reviews)
Author: SERRAJOthman

By SERRAJOthman 👁 63 views ▲ 0 votes

Integrate Bitchat with OpenClaw. This plugin forwards Bluetooth messages from your smartphone directly into your OpenClaw environment.

GitHub

Install

openclaw plugins install ~/openclaw-plugin-bitchat

Configuration Example

"bitchat": {
  "enabled": true,
  "nickname": "openclaw-pc",
  "nodeUrl": "http://192.168.1.13:3939",
  "pollInterval": 2000,
  "dmPolicy": "open",
  "allowFrom": [
    "*"
  ],
  "groupAllowFrom": [
    "*"
  ]
}

README

# OpenClaw Bitchat Plugin

This plugin provides a channel to connect your Bitchat smartphone app to the OpenClaw companion running in a Windows Hub (via WSL2 Ubuntu). The plugin acts as an API that receives and sends messages from your phone over Bluetooth and forwards them to OpenClaw.

## Prerequisites

1.  **Bitchat Node**: You must run `bitchat-node` from this repository on your Windows machine. This node acts as the receiver that connects to your phone via Bluetooth.
2.  **OpenClaw Companion**: Running in WSL2 (Ubuntu).

## Installation

Install the plugin using the OpenClaw CLI in your WSL2 terminal:

```bash
openclaw plugins install ~/openclaw-plugin-bitchat --force
```

## Configuration

You need to add the `bitchat` channel to your OpenClaw configuration.

You can do this by running `openclaw channels add`, or by manually editing your `~/.openclaw/openclaw.json` file.

Add the following block to the `"channels"` section of your `openclaw.json` file:

```json
"bitchat": {
  "enabled": true,
  "nickname": "openclaw-pc",
  "nodeUrl": "http://192.168.1.13:3939",
  "pollInterval": 2000,
  "dmPolicy": "open",
  "allowFrom": [
    "*"
  ],
  "groupAllowFrom": [
    "*"
  ]
}
```

> [!IMPORTANT]
> Make sure to replace `192.168.1.13` with the actual IP address of your Windows machine where `bitchat-node` is running. Keep the port as `3939`.

## Running the Plugin

After configuring the channel, apply the changes by restarting the gateway and binding your agent:

1.  **Restart the gateway**:
    ```bash
    openclaw gateway restart
    ```

2.  **Add the main agent** (if you haven't already):
    ```bash
    openclaw agents add main
    ```

3.  **Bind the agent** to the Bitchat channel:
    ```bash
    openclaw agents bind --bind bitchat
    ```

## Troubleshooting & Debugging

- **Viewing Incoming Messages**: To see messages as they arrive, you can tail the OpenClaw log file for today (replace the date as needed):
  ```bash
  tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i bitchat
  ```

- **If you get stuck**: Run the OpenClaw doctor tool to automatically fix common issues:
  ```bash
  openclaw doctor --fix
  ```
  > [!TIP]
  > Avoid reinstalling OpenClaw completely if you encounter issues. Running `openclaw doctor --fix` will usually resolve them and save you a lot of time.

voice