GPTree Channel Plugin for OpenClaw

This OpenClaw channel plugin integrates your OpenClaw agent with the GPTree conversation platform, allowing you to chat with your AI agent through a modern web interface.

Features

• 🌐 Web Interface: Chat with your OpenClaw agent through GPTree's modern web UI
• 💬 Real-time Messaging: Instant message delivery between GPTree and OpenClaw
• 🔄 Conversation Persistence: Messages are saved and synchronized between platforms
• 🎯 Multi-Agent Support: Works with OpenClaw's different agent types (Main, Research, Content, Automation)
• 🔒 Secure Authentication: Uses API tokens for secure communication
• 📊 Usage Tracking: Monitor your agent interactions through GPTree's dashboard

Installation

1. Install the plugin in OpenClaw:

# Clone or download this plugin
git clone https://github.com/openclaw/gptree-channel-plugin.git
cd gptree-channel-plugin

# Install dependencies
npm install

# Install in OpenClaw (use -l for development linking)
openclaw plugins install -l .

2. Configure your OpenClaw config:

Add this to your OpenClaw configuration (usually ~/.openclaw/openclaw.json):

{
  "channels": {
    "gptree": {
      "accounts": {
        "default": {
          "enabled": true,
          "apiKey": "your-gptree-api-token-here",
          "baseUrl": "https://api.gptree.com"
        }
      }
    }
  }
}

3. Get your GPTree API token:

• Go to GPTree.com
• Sign up or log in
• Navigate to Settings → API Keys
• Create a new "OpenClaw Integration" token
• Copy the token and paste it in your OpenClaw config

4. Restart OpenClaw:

openclaw gateway restart

Configuration Options

| Option | Required | Default | Description | |--------|----------|---------|-------------| | enabled | Yes | false | Enable/disable the GPTree channel | | apiKey | Yes | "" | Your GPTree API token | | baseUrl | No | "http://127.0.0.1:8000" | GPTree API base URL |

Example Configuration

{
  "channels": {
    "gptree": {
      "accounts": {
        "personal": {
          "enabled": true,
          "apiKey": "gpt_abc123...",
          "baseUrl": "https://api.gptree.com"
        },
        "work": {
          "enabled": true,  
          "apiKey": "gpt_def456...",
          "baseUrl": "https://work.gptree.com"
        }
      }
    }
  }
}

Usage

Once configured, your OpenClaw agent will be available as a provider in GPTree:

1. Start a conversation in GPTree web interface
2. Select OpenClaw as your AI provider
3. Choose an agent type (Main, Research, Content, Automation)
4. Chat normally - messages flow between GPTree and your OpenClaw agent
5. Enjoy the benefits of GPTree's conversation management and your OpenClaw's capabilities!

How It Works

GPTree Web UI → GPTree API → OpenClaw Plugin → OpenClaw Agent
                     ↑                               ↓
                     ←─── OpenClaw Plugin ←─── Agent Response

1. User types message in GPTree web interface
2. GPTree sends message to your OpenClaw instance
3. OpenClaw agent processes the message
4. Agent response goes through this channel plugin
5. Plugin sends response back to GPTree API
6. GPTree displays response in web interface

Development

Build

npm run build

Test

npm test

Development Mode

# Install with linking for development
openclaw plugins install -l .

# Watch for changes
npm run dev

Logs

Check OpenClaw logs to see plugin activity:

openclaw logs

Look for messages tagged with [gptree].

Troubleshooting

Plugin not loading:

• Check openclaw logs for error messages
• Ensure plugin is properly installed with openclaw plugins list
• Verify your openclaw.plugin.json is valid JSON

Messages not sending:

• Check your apiKey is correct and not expired
• Verify baseUrl points to your GPTree instance
• Ensure GPTree is running and accessible
• Check GPTree logs for webhook errors

Authentication errors:

• Regenerate your API token in GPTree
• Update the apiKey in your OpenClaw config
• Restart OpenClaw gateway

Connection refused:

• Make sure GPTree is running
• Check the baseUrl is correct
• Test connectivity: curl https://your-gptree-url/api/openclaw/webhook-health

API Endpoints

This plugin communicates with these GPTree API endpoints:

• POST /api/openclaw/receive-message - Receives messages from OpenClaw
• GET /api/openclaw/webhook-health - Health check
• GET /api/openclaw/channel-config - Plugin configuration info

Contributing

1. Fork this repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

• Documentation: OpenClaw Plugin Docs
• Issues: GitHub Issues
• Community: OpenClaw Discord

Built with ❤️ for the OpenClaw ecosystem.