Connections Overview

Karma One's connection system extends your AI beyond the app itself. Send and receive messages across messaging platforms, publish content to social media, and integrate with your desktop workflow -- all powered by the same avatars and AI models.

Three-Layer Architecture

Karma One organizes connections into three distinct layers, each serving a different purpose:

                    +-------------------------------------------+
  Layer 3: Publish  |  One-click publishing to 11 social        |
                    |  media platforms                          |
                    +--------------------+----------------------+
                                         |
                    +--------------------+----------------------+
  Layer 2: Channel  |  Bidirectional messaging across 9         |
                    |  communication platforms                  |
                    +--------------------+----------------------+
                                         |
                    +--------------------+----------------------+
  Layer 1: Bot      |  Karma Telegram Bot -- zero-config        |
                    |  binding in 30 seconds                    |
                    +-------------------------------------------+

| Layer | Purpose | Effort to Set Up | Who It Serves | |---|---|---|---| | Bot | Personal AI access via Telegram | 30 seconds | You | | Channel | Automated two-way messaging on 9 platforms | 10-30 minutes per platform | Your customers, team, community | | Publish | Content distribution to 11 social networks | Per-post | Your audience |

You can use any layer independently or combine them.

Layer 1: Bot Layer

Karma Telegram Bot

The Karma Telegram Bot (@karmabox7bot) is the fastest way to connect. No API keys, no bot creation, no configuration -- just a 30-second binding flow.

What It Is:

An official Telegram bot operated by Karma One. Once bound to your account, it becomes a direct line to your AI.

How to Bind:

1. In the Karma One app, open Settings > Connections.
2. Find the Karma Bot card and tap Bind Telegram.
3. A unique binding link is generated for your account.
4. Tap the link to open Telegram.
5. Send /start to @karmabox7bot.
6. Binding is complete.

Capabilities After Binding:

| Feature | Description | |---|---| | Text messaging | Chat with AI in Telegram just like a normal conversation | | Push notifications | Receive alerts when avatars complete automated tasks | | Morning briefing | Get daily briefing reports pushed to Telegram | | Voice messages | Send voice notes and receive voice replies (for short responses) | | Inline queries | Type @karmabox7bot in any Telegram chat for quick AI answers |

Tip: Binding the Karma Bot does not affect your normal usage inside the Karma One app. It is an additional entry point for when you prefer to use Telegram.

Inline Queries:

You can use the Karma Bot without opening its chat. In any Telegram conversation, type:

@karmabox7bot What is the current exchange rate for USD to EUR?

The bot responds with an inline card you can share directly in the conversation.

How to Unbind:

Open Settings > Connections, find the Karma Bot card, and tap Unbind.

Layer 2: Channel Layer

The Channel Layer connects your avatars to external messaging platforms. When users send messages on those platforms, the avatar replies automatically -- like having a 24/7 assistant or customer service agent.

Supported Platforms (9 Channels)

| Platform | Direction | Typical Use Case | |---|---|---| | WeChat Official Account | Bidirectional | Auto-replies, customer support in China | | WeCom (Enterprise WeChat) | Bidirectional | Internal assistant, B2B customer service | | Feishu (Lark) | Bidirectional | Team collaboration assistant | | DingTalk | Bidirectional | Internal notifications and Q&A | | Slack | Bidirectional | Team collaboration, DevOps alerts | | Discord | Bidirectional | Community management, user engagement | | Telegram | Bidirectional | Custom bot for community or personal use | | WhatsApp | Bidirectional | International customer service | | Email | Bidirectional | Automated email replies, support inbox |

General Setup Flow

Each platform has its own configuration steps, but the overall process is the same:

1. Obtain platform credentials. Create an app or bot on the target platform and get the API key, token, or webhook URL.

2. Configure in Karma One. Go to Settings > Connections > Add Channel, select the platform, and enter the credentials.

3. Assign an avatar. Choose which avatar should handle messages from this channel.

4. Test the connection. Send a test message on the target platform and confirm the avatar receives and replies correctly.

5. Go live. Once testing passes, the channel enters active status. You can monitor the message flow in real time from Karma One.

Channel Management

From the Connections page, you can perform the following actions on any channel:

| Action | Description | |---|---| | View status | See whether each channel is online, offline, or in an error state | | Pause / Resume | Temporarily disable automatic replies for a channel | | Switch avatar | Change which avatar is responsible for replies | | View messages | Browse the message history sent and received through the channel | | Delete channel | Remove the channel configuration entirely |

Platform-Specific Notes

WeChat Official Account

WeChat is one of the most commonly used channels for users in China.

• Requires a verified WeChat Official Account (Service Account or Subscription Account).
• Get the AppID and AppSecret from the Official Account backend under Development > Basic Configuration.
• Configure the server URL (Karma One provides a dedicated callback address).
• Supports text and image messages.
• Supports Security Mode (AES-256-CBC encryption) for enterprise compliance.

WeCom (Enterprise WeChat)

• Requires a WeCom admin account with API access.
• Supports internal employee messaging and external customer contact.
• Useful for building internal knowledge assistants accessible from the WeCom sidebar.

Email

The Email channel allows avatars to automatically reply to emails:

• Supports any standard IMAP/SMTP mailbox.
• Configure both the receiving and sending email addresses.
• Avatars analyze incoming emails and compose replies automatically.
• You can set keyword filters to only reply to emails matching specific subjects.

Slack and Discord

• Both support bot-based integration.
• Create a Slack App or Discord Bot, get the token, and configure in Karma One.
• Avatars can respond in specific channels or via direct messages.

Telegram Channel vs. Karma Bot

If you use Telegram, you have two options. Here is how they differ:

| Comparison | Karma Bot | Telegram Channel | |---|---|---| | Setup | Zero configuration | Requires creating your own Bot via BotFather | | Use case | Personal use | User-facing or community-facing | | Bot identity | Official @karmabox7bot | Your own custom bot name and avatar | | Customization | Limited | Full (custom name, welcome message, etc.) | | Avatar binding | Bound to your account's default AI | Can bind a specific avatar |

Note: If your custom Telegram bot uses the same token as the Karma Bot, the system detects the conflict automatically and prevents duplicate operation.

Layer 3: Publish Layer

The Publish Layer lets you distribute AI-generated content to multiple social media platforms in one step.

Supported Platforms (11 Networks)

| Platform | Content Type | Notes | |---|---|---| | Weibo | Text + images | Supports hashtags | | Xiaohongshu (RED) | Text + images / video | Note-style format | | Douyin (TikTok CN) | Short video | Pair with AI video generation | | Kuaishou | Short video | Pair with AI video generation | | Bilibili | Video / articles | Supports posts and column articles | | WeChat Articles | Long-form text + images | Rich article publishing | | Zhihu | Text + images | Q&A and column format | | Twitter / X | Text + images | Multi-language support | | Instagram | Images / video | Supports Stories | | LinkedIn | Text + images | Professional content | | Facebook | Text + images / video | Broad international reach |

Publishing Flow

1. Ask AI to generate the content you need in a conversation.
2. Once satisfied with the result, tap the Publish button below the message.
3. Select target platforms (you can select multiple at once).
4. Preview how the content adapts to each platform's format.
5. Confirm and publish.

Tip: Different platforms have different format requirements (character limits, image ratios, video length, etc.). Karma One adapts content automatically, but it is good practice to review the preview before publishing.

Content Adaptation

When publishing to multiple platforms simultaneously, Karma One handles:

• Character limits: Truncates or reformats text to fit platform constraints
• Image requirements: Adjusts aspect ratios and file sizes
• Hashtag formatting: Converts between platform-specific hashtag conventions
• Language: Maintains the language of your original content

Karma Box -- macOS Desktop

Karma Box is the macOS companion application for Karma One, providing deep system-level integration that goes beyond what a mobile app or browser can offer.

| Feature | Description | |---|---| | System tools | Manage files, take screenshots, access clipboard | | App control | Open applications, control Safari, manage Calendar | | Email | Read and send email through Mail.app | | Voice wake | Activate AI with a voice command | | Notifications | Native macOS notifications | | Camera and screen | Capture photos, record screen and video | | Location | Access device location (with permission) |

Unique Capabilities

Karma Box enables cloud tools that interact directly with your Mac:

• File management: Browse, copy, move files through Finder
• Calendar integration: Create, view, delete events in Calendar.app
• Safari control: Open URLs, read page content, execute JavaScript
• Mail integration: Read inbox, search emails, send messages
• Screenshot and recording: Capture screen or camera for AI analysis
• Clipboard: Read and write clipboard content

These capabilities are exposed as cloud tools that any avatar can use during conversations.

Sovereign AI Connections

For organizations with strict data security requirements, Karma One supports connecting to AI models deployed on your own infrastructure.

Cloud Sovereign AI

• AI models run on controlled cloud infrastructure that you manage.
• Data does not pass through third-party services.
• Suitable for organizations that need privacy but do not require full on-premises deployment.
• Accessible through the standard Karma One interface.

Local Sovereign AI (Advanced)

• AI models run directly on your own hardware (e.g., Mac Studio, GPU server).
• Data never leaves your local network.
• Suitable for finance, healthcare, government, and other regulated industries.
• Supports local image generation and local vision analysis.
• Requires Karma Box to be running on the local machine.

Sovereign AI Capabilities

| Capability | Cloud Sovereign | Local Sovereign | |---|---|---| | Text generation | Yes | Yes | | Image generation | Yes | Yes | | Image analysis | Yes | Yes | | Data residency | Controlled cloud | Your hardware | | Network requirement | Internet | LAN only | | Setup complexity | Moderate | Advanced |

Full Architecture Diagram

You (User)
  |
  +-- Karma One App (iOS / Android / Web)
  |     +-- Full access to all AI features
  |
  +-- Karma Box (macOS)
  |     +-- Deep desktop integration + Local Sovereign AI
  |
  +-- Bot Layer
  |     +-- Karma Telegram Bot (@karmabox7bot)
  |           +-- Personal messaging + push notifications
  |
  +-- Channel Layer (Avatar auto-replies)
  |     +-- WeChat Official Account
  |     +-- WeCom (Enterprise WeChat)
  |     +-- Feishu (Lark)
  |     +-- DingTalk
  |     +-- Slack
  |     +-- Discord
  |     +-- Telegram (custom bot)
  |     +-- WhatsApp
  |     +-- Email
  |
  +-- Publish Layer (One-click content distribution)
        +-- Weibo / Xiaohongshu / Douyin / Kuaishou / Bilibili
        +-- WeChat Articles / Zhihu
        +-- Twitter / Instagram / LinkedIn / Facebook

Next Steps

• Quick Start -- Detailed Telegram binding walkthrough
• Autopilot -- Let avatars execute tasks and push results automatically
• Multimodal Input -- Explore all input methods
• Avatar System -- Build the avatars that power your channels