OpenClaw-Docker-CN-IM  by justlovemaki

AI robot gateway for Chinese IM platforms

Created 3 weeks ago

New!

1,870 stars

Top 22.8% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

This project offers a Dockerized gateway for integrating popular Chinese instant messaging (IM) platforms with AI models. It addresses the need for a unified AI bot interface across Feishu, DingTalk, QQ Bot, and WeCom. The target audience includes developers and power users seeking to rapidly deploy AI-powered bots across these ecosystems, simplifying multi-platform AI integration.

How It Works

The solution packages OpenClaw, an AI gateway, within a Docker image pre-loaded with plugins for major Chinese IM platforms. It simplifies deployment via Docker Compose, allowing configuration of IM credentials and AI model endpoints through environment variables. It supports OpenAI and Claude API protocols, facilitating integration with external AI services like AIClient-2-API for advanced token management. The architecture also incorporates Playwright for browser automation and Chinese Text-to-Speech (TTS).

Quick Start & Requirements

Installation uses Docker Compose. Users pull the image (justlikemaki/openclaw-docker-cn-im:latest), download docker-compose.yml and .env.example, copy to .env, and configure AI model parameters (MODEL_ID, BASE_URL, API_KEY). IM credentials can be configured later. Launch with docker-compose up -d. Prerequisites include Docker and Docker Compose. Successful message reception requires correct IM platform webhook and event subscription configuration. Links: Project Repo, Docker Hub.

Highlighted Details

  • Comprehensive IM Integration: Pre-installed plugins for Feishu, DingTalk, QQ Bot, and WeCom.
  • Flexible AI Connectivity: Supports OpenAI and Claude API protocols, recommended with AIClient-2-API for large context windows.
  • Built-in Utilities: Includes OpenCode AI, Playwright for browser automation, and Chinese TTS.
  • Ease of Deployment: Dockerized for "out-of-the-box" usability.

Maintenance & Community

The README provides no specific details on maintenance frequency, notable contributors, or community support channels (e.g., Discord, Slack). It encourages user stars for project support and mentions sponsorship opportunities.

Licensing & Compatibility

Licensed under GNU General Public License v3.0 (GPL-3.0). This copyleft license requires derivative works to also be distributed under GPL-3.0, potentially restricting integration into proprietary, closed-source commercial applications without explicit agreements.

Limitations & Caveats

Configuring IM platform event subscriptions and webhooks is a common failure point for message reception. The GPL-3.0 license's copyleft nature requires careful consideration for commercial use. Some IM integrations (e.g., WeCom) require the service to be publicly accessible. Functionality depends on external AI services and IM platform APIs.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
45
Star History
1,952 stars in the last 24 days

Explore Similar Projects

Feedback? Help us improve.