OpenClaw + Dify Starter

🚀 Integrate OpenClaw AI agent with Dify AI workflow platform

English | 中文文档

🌟 What is This?

This project enables seamless integration between OpenClaw (Telegram AI agent) and Dify (AI application development platform), allowing you to:

• 📱 Chat with Dify AI workflows via Telegram
• 🤖 Build powerful AI agents with visual workflow editor
• 🔗 Connect multiple AI models and services
• 📚 Create knowledge bases for Q&A systems
• 🎨 Design custom AI applications without coding

Inspired by openclaw-n8n-starter, this project replaces n8n with Dify for AI-first workflow automation.

✨ Features

Core Components

• OpenClaw - AI agent accessible via Telegram
• Dify - Visual AI workflow builder
  • Chat applications
  • Text completion
  • Workflow orchestration
  • Knowledge base integration
  • Multi-model support (OpenAI, Claude, local LLMs)
• Caddy - Automatic HTTPS reverse proxy
• PostgreSQL - Data persistence
• Redis - Caching and task queue

Security Features

• 🔒 Three-tier network isolation (frontend/backend/egress)
• 🔒 OpenClaw not exposed to internet
• 🔒 API key authentication
• 🔒 Automatic HTTPS certificates
• 🔒 Container security hardening

🚀 Quick Start

Prerequisites

• Ubuntu 24.04 server (4GB+ RAM recommended)
• Telegram Bot Token (get from @BotFather)
• Telegram User ID (get from @userinfobot)
• OpenAI API Key (get from OpenAI)

One-Command Deployment

# SSH into your server
ssh root@your-server

# Download and run setup script
curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/openclaw-dify-starter/main/setup.sh | bash

The script will:

1. ✅ Install Docker and Docker Compose
2. ✅ Configure firewall (ufw)
3. ✅ Build OpenClaw from source
4. ✅ Generate secure random keys
5. ✅ Set up Caddy for HTTPS
6. ✅ Start all services

Manual Deployment

# Clone the repository
git clone https://github.com/YOUR_USERNAME/openclaw-dify-starter.git
cd openclaw-dify-starter

# Run setup script
chmod +x setup.sh
./setup.sh

🏗️ Architecture

Internet
    │
    ├─── Telegram ──────────► OpenClaw (internal only)
    │                              │
    │                              ▼
    └─── HTTPS ──► Caddy ──► Dify ◄─┘
                              │
                              ▼
                    PostgreSQL + Redis (internal)

Network Isolation

• Frontend Network: Public-facing services (Caddy, Dify Web)
• Backend Network: Internal services (PostgreSQL, Redis)
• Egress Network: Outbound connections only

📚 Documentation

English

• README.md - Quick start guide
• CONTRIBUTING.md - Contribution guidelines
• LICENSE - MIT License

中文文档 (Chinese)

• 使用指南.md - Comprehensive user guide
• 项目说明.md - Detailed project overview
• 对比说明.md - Comparison with n8n version
• 工作流示例.md - 7 practical workflow examples
• 快速参考.md - Command reference

🎯 Use Cases

1. Personal Knowledge Assistant

• Upload documents to Dify knowledge base
• Query via Telegram through OpenClaw
• Get AI-powered intelligent answers

2. Enterprise Document Q&A

• Build company knowledge base
• Employees query through Telegram
• 24/7 automated support

3. Multi-Model Experimentation

• Configure multiple AI models
• Compare responses
• Optimize prompts and workflows

4. AI Content Generation

• Text summarization
• Translation
• Creative writing
• Code generation

💡 Example Workflows

We provide 7 ready-to-use examples (view in Chinese):

1. 📰 Daily News Summary Bot
2. 📚 Intelligent Document Q&A
3. 🌐 Multi-language Translation
4. 💻 Code Review Assistant
5. 📝 Personal Diary Analyzer
6. 📡 RSS Monitor & Notifier
7. 📋 Meeting Notes Summarizer

🔧 Configuration

Environment Variables

See .env.example for all configuration options:

# Required
TELEGRAM_BOT_TOKEN=your_telegram_bot_token
TELEGRAM_USER_ID=your_telegram_user_id
OPENAI_API_KEY=your_openai_api_key

# Auto-generated during setup
OPENCLAW_GATEWAY_TOKEN=auto_generated
DIFY_SECRET_KEY=auto_generated
POSTGRES_PASSWORD=auto_generated

Access URLs

After deployment (replace 123.45.67.89 with your server IP):

• Dify Web UI: https://123.45.67.89.nip.io
• OpenClaw Gateway: Internal only (port 18789)
• Telegram Bot: Search for your bot in Telegram

📊 Comparison with n8n Version

Feature	n8n-starter	dify-starter
Focus	General automation	AI applications
AI Capabilities	Via integration	Built-in
Knowledge Base	Plugin required	Native support
Learning Curve	Medium	Lower
RAM Required	2GB	4GB
Best For	Integrations	AI agents

See 对比说明.md for detailed comparison.

🛠️ Skills

OpenClaw skills for Dify integration (in skills/ directory):

• dify-api - General Dify API integration (Docker internal network)
• dify-api/SKILL_云端版.md - Cloud Dify setup guide
• dify-cloud-ready - Ready-to-use cloud configuration

Each skill includes:

• Complete API documentation
• Usage examples
• Error handling
• Best practices

🔍 Troubleshooting

Common Issues

1. "Workflow not published"

   • Publish your application in Dify Web UI first

2. Port conflicts

   • Stop conflicting services: docker compose down

3. Skill not found

   • Ensure skill is in correct OpenClaw workspace path

4. API errors

   • Check API key is correct
   • Verify application is published
   • Check logs: docker compose logs -f dify-api

📈 Monitoring

# View all logs
docker compose logs -f

# View specific service
docker compose logs -f dify-api
docker compose logs -f openclaw-gateway

# Check service status
docker compose ps

# Resource usage
docker stats

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Areas we need help:

• 📝 Documentation improvements
• 🔧 New workflow examples
• 🌐 Translations
• 🐛 Bug reports and fixes
• ✨ Feature requests

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Credits

• OpenClaw - AI agent framework
• Dify - AI application platform
• openclaw-n8n-starter - Original inspiration

💬 Community

• 📖 Documentation
• 💬 GitHub Discussions
• 🐛 Issues

⭐ Star History

If you find this project helpful, please give it a star! It helps others discover the project.

---

Built with ❤️ for the OpenClaw and Dify communities