What is ZoyaChat and how does it work?ZoyaChat 是什么以及它如何工作？Что такое ZoyaChat и как он работает?
ZoyaChat is a desktop application that combines shared AI assistant access with decentralized encrypted messaging. Built on the open-source OpenClaw gateway, it provides a one-click interface to 633+ AI models while keeping all your data local and your conversations encrypted.ZoyaChat 是一个桌面应用，将共享 AI 助手与去中心化加密通讯结合在一起。基于开源 OpenClaw 网关构建，提供 633+ AI 模型的一键访问界面，同时保持所有数据本地存储、对话加密。ZoyaChat — десктопное приложение, объединяющее общий ИИ-ассистент с децентрализованным зашифрованным обменом сообщениями. Построен на open-source шлюзе OpenClaw, предоставляет доступ к 633+ моделям в один клик, сохраняя все данные локально и шифруя переписку.
| Feature功能Функция | Host | Guest |
|---|---|---|
| Available on可用平台Доступен на | Desktop only (Windows / macOS)仅桌面端（Windows / macOS）Только десктоп (Windows / macOS) | All platforms (Desktop, Android, iOS PWA, Web)所有平台（桌面端、Android、iOS PWA、网页版）Все платформы (Десктоп, Android, iOS PWA, Веб) |
| Runs AI gateway运行 AI 网关Запуск шлюза | ✓ | — |
| Needs API keys需要 API 密钥Нужны API-ключи | ✓ | — |
| AI chatAI 对话ИИ-чат | ✓ | ✓ |
| Encrypted messaging加密通讯Шифрованные сообщения | ✓ | ✓ |
| Invite others邀请他人Приглашение других | ✓ | — |
| Becomes relay node成为中继节点Становится реле-узлом | ✓ | — |
| Setup difficulty安装难度Сложность | Guided (5 min)引导式（5分钟）С подсказками (5 мин) | Instant即刻Мгновенно |
ZoyaChat is an Electron + React/Vite desktop application. It communicates with a locally-running OpenClaw gateway for AI model access. Encrypted messaging uses libp2p with Circuit Relay for NAT traversal and Noise protocol for end-to-end encryption. No central servers store any user data or messages.ZoyaChat 是一个 Electron + React/Vite 桌面应用。它与本地运行的 OpenClaw 网关通信以访问 AI 模型。加密通讯使用 libp2p，通过 Circuit Relay 实现 NAT 穿透，使用 Noise 协议端到端加密。没有中心服务器存储任何用户数据或消息。ZoyaChat — десктопное приложение Electron + React/Vite. Оно взаимодействует с локальным шлюзом OpenClaw для ИИ-моделей. Шифрованный обмен использует libp2p с Circuit Relay для NAT-обхода и Noise Protocol для сквозного шифрования. Никакие центральные серверы не хранят данные пользователей.
ZoyaChat supports English, Russian, and Chinese natively throughout the entire interface — including onboarding, settings, and documentation.ZoyaChat 在整个界面中原生支持英文、俄文和中文——包括引导流程、设置和文档。ZoyaChat нативно поддерживает английский, русский и китайский во всём интерфейсе — включая онбординг, настройки и документацию.
Run your own AI gateway in minutes几分钟内运行你自己的 AI 网关Запустите свой ИИ-шлюз за минуты
The Host setup follows a guided 6-phase process:Host 配置遵循 6 阶段引导流程：Настройка Host проходит 6 этапов:
- Welcome — Language selection and introduction欢迎 — 语言选择与介绍Приветствие — Выбор языка и введение
- Identity — Set display name and auth token身份 — 设置显示名称和认证令牌Идентичность — Имя и токен авторизации
- Mode — Choose Host模式 — 选择 HostРежим — Выберите Host
- Gateway Setup — Automatic detection and installation网关配置 — 自动检测和安装Настройка шлюза — Автоопределение и установка
- API Keys — Add your AI provider keysAPI 密钥 — 添加 AI 提供商密钥API-ключи — Добавьте ключи провайдеров
- Done — Start using ZoyaChat完成 — 开始使用 ZoyaChatГотово — Начните использовать ZoyaChat
During gateway setup, ZoyaChat automatically handles:网关配置过程中，ZoyaChat 自动处理：Во время настройки ZoyaChat автоматически:
- WSL detection (Windows only) — checks if WSL2 is availableWSL 检测（仅 Windows）— 检查 WSL2 是否可用Обнаружение WSL (только Windows) — проверяет наличие WSL2
- Node.js detection — installs if missingNode.js 检测 — 缺失时自动安装Обнаружение Node.js — устанавливает при отсутствии
- OpenClaw installation — with Chinese mirror support for mainland ChinaOpenClaw 安装 — 支持中国镜像加速Установка OpenClaw — с поддержкой китайских зеркал
- Port & password configuration端口和密码配置Настройка порта и пароля
- Gateway startup网关启动Запуск шлюза
%USERPROFILE%\.openclaw\. No WSL required.Windows 原生模式：如果 WSL2 不可用，ZoyaChat 使用 Windows 原生模式，将 OpenClaw 数据存储在 %USERPROFILE%\.openclaw\。无需 WSL。Нативный режим Windows: Если WSL2 недоступен, ZoyaChat использует нативный режим Windows, хранящий данные OpenClaw в %USERPROFILE%\.openclaw\. WSL не требуется.Join in seconds with an invite code通过邀请码几秒即可加入Присоединитесь за секунды по коду
Guest mode requires no gateway setup, no API keys, and no technical knowledge. Simply:Guest 模式无需网关配置、无需 API 密钥、无需技术知识。只需：Guest-режим не требует настройки шлюза, API-ключей или технических знаний. Просто:
- Install ZoyaChat安装 ZoyaChatУстановите ZoyaChat
- Choose a display name选择显示名称Выберите имя
- Select Guest mode and enter the invite code选择 Guest 模式并输入邀请码Выберите Guest и введите код приглашения
- Start chatting开始聊天Начните общение
You'll automatically connect to the Host's gateway and have access to AI models and encrypted messaging.你将自动连接到 Host 的网关，获得 AI 模型和加密通讯的访问权限。Вы автоматически подключитесь к шлюзу Host и получите доступ к ИИ-моделям и зашифрованным сообщениям.
Managing your AI provider API keys管理你的 AI 提供商 API 密钥Управление API-ключами провайдеров
Navigate to Settings → API Keys to add keys for any supported provider. ZoyaChat supports per-model API key storage with a three-state verification system:进入 设置 → API 密钥 添加任何支持的提供商密钥。ZoyaChat 支持按模型存储 API 密钥，具有三态验证系统：Перейдите в Настройки → API-ключи для добавления ключей. ZoyaChat поддерживает хранение ключей по моделям с трёхуровневой верификацией:
| Status状态Статус | Meaning含义Значение |
|---|---|
| ✓ Verified (1)已验证 (1)Проверен (1) | API key tested and workingAPI 密钥已测试且有效API-ключ протестирован и работает |
| ○ Never verified (0)未验证 (0)Не проверен (0) | Saved but not yet tested已保存但尚未测试Сохранён, но не проверен |
| ✕ Failed (-1)验证失败 (-1)Ошибка (-1) | Failed verification but force-saved验证失败但强制保存Проверка не прошла, но принудительно сохранён |
All API keys are encrypted using Electron safeStorage (OS-level encryption). Encrypted keys are stored with a $enc$ prefix. On first launch after the security update, any existing plain-text keys are automatically migrated to encrypted format.所有 API 密钥使用 Electron safeStorage（操作系统级加密）加密。加密后的密钥以 $enc$ 前缀存储。安全更新后首次启动时，已有的明文密钥会自动迁移为加密格式。Все API-ключи зашифрованы через Electron safeStorage (шифрование на уровне ОС). Зашифрованные ключи хранятся с префиксом $enc$. При первом запуске после обновления безопасности существующие текстовые ключи автоматически мигрируются в зашифрованный формат.
You can add custom AI providers with their own apiKey, api (base URL), and models fields. When adding custom models, set models.mode to merge to combine with existing model lists.你可以添加自定义 AI 提供商，包含其 apiKey、api（基础 URL）和 models 字段。添加自定义模型时，将 models.mode 设为 merge 以与现有模型列表合并。Можно добавить пользовательских провайдеров с полями apiKey, api (базовый URL) и models. При добавлении моделей установите models.mode в merge для объединения с существующими списками.
Chatting with 633+ AI models与 633+ AI 模型对话Общение с 633+ моделями
ZoyaChat dynamically loads all available models from your OpenClaw gateway. You can switch models mid-conversation, batch-select multiple models for comparison, and the interface supports multi-model selection with provider-level locking.ZoyaChat 从你的 OpenClaw 网关动态加载所有可用模型。你可以在对话中切换模型，批量选择多个模型进行比较，界面支持多模型选择和提供商级别锁定。ZoyaChat динамически загружает все доступные модели из вашего шлюза OpenClaw. Можно переключать модели в процессе разговора, выбирать несколько для сравнения, с блокировкой на уровне провайдера.
Decentralized, end-to-end encrypted communication去中心化端到端加密通信Децентрализованное сквозное шифрование
ZoyaChat uses libp2p Circuit Relay for decentralized connections — no third-party dependency and no public IP mapping required. The Noise protocol provides end-to-end encryption between peers. Every Host user automatically becomes a decentralized relay node, and official relay nodes (2–3) provide additional fallback. Relay nodes only pass encrypted packets and store nothing.ZoyaChat 使用 libp2p Circuit Relay 进行去中心化连接——无第三方依赖、无需公网 IP 映射。Noise 协议提供端到端加密。每个 Host 用户自动成为去中心化中继节点，官方中继节点（2-3个）提供额外备用连接。中继节点仅转发加密数据包，不存储任何内容。ZoyaChat использует libp2p Circuit Relay для децентрализованных соединений — без сторонних зависимостей и публичных IP. Noise Protocol обеспечивает сквозное шифрование. Каждый Host-пользователь автоматически становится децентрализованным реле-узлом, а официальные узлы (2–3) обеспечивают дополнительный резерв. Узлы только передают зашифрованные пакеты.
Creating custom AI personalities with tool permissions创建具有工具权限的自定义 AI 角色Создание ИИ-персонажей с разрешениями инструментов
ZoyaChat supports custom AI agents, each with their own identity (IDENTITY.md) and tool configuration (TOOLS.md). Agents can be configured with specific tool permissions that sync to the OpenClaw gateway's tools.allow and tools.deny lists. Agents are routed via the x-clawdbot-agent-id header.ZoyaChat 支持自定义 AI 智能体，每个智能体有自己的身份（IDENTITY.md）和工具配置（TOOLS.md）。智能体可配置特定的工具权限，同步到 OpenClaw 网关的 tools.allow 和 tools.deny 列表。智能体通过 x-clawdbot-agent-id header 路由。ZoyaChat поддерживает пользовательских ИИ-агентов, каждый со своей идентичностью (IDENTITY.md) и конфигурацией инструментов (TOOLS.md). Агенты настраиваются с определёнными разрешениями, синхронизируемыми с tools.allow и tools.deny шлюза OpenClaw.
Protect your data with full backups通过完整备份保护你的数据Защитите данные полным резервным копированием
ZoyaChat creates tar.gz backups of your complete data including database, settings, and agent configurations. To restore, select a backup file and ZoyaChat will reload the database and refresh the UI automatically.ZoyaChat 创建 tar.gz 备份，包含完整数据：数据库、设置和智能体配置。恢复时选择备份文件，ZoyaChat 将自动重新加载数据库并刷新界面。ZoyaChat создаёт tar.gz бэкапы с полными данными: база данных, настройки и конфигурации агентов. Для восстановления выберите файл бэкапа — ZoyaChat автоматически перезагрузит БД и обновит интерфейс.
Move your identity between devices在设备间迁移你的身份Перенос идентичности между устройствами
Export your identity to a PIN-encrypted file. This includes your cryptographic keys, contacts, and settings. On a new device, choose "Import Identity" during onboarding and enter your PIN to restore everything.将你的身份导出为 PIN 加密文件。包含你的加密密钥、联系人和设置。在新设备上，引导过程中选择"导入身份"并输入 PIN 即可恢复一切。Экспортируйте идентичность в файл с PIN-шифрованием. Включает криптографические ключи, контакты и настройки. На новом устройстве выберите «Импорт идентичности» и введите PIN для восстановления.
Troubleshooting common problems常见问题排查Решение типичных проблем
Check if the configured port is already in use. ZoyaChat includes a health monitor and mutex protection to prevent multiple gateway instances. If the gateway process crashed, restart ZoyaChat — it will detect the state and recover automatically.检查配置的端口是否已被占用。ZoyaChat 包含健康监控和互斥锁保护，防止多个网关实例运行。如果网关进程崩溃，重启 ZoyaChat——它会检测状态并自动恢复。Проверьте, не занят ли настроенный порт. ZoyaChat включает мониторинг здоровья и mutex-защиту. Если шлюз упал, перезапустите ZoyaChat — он обнаружит состояние и восстановится автоматически.
If you experience freezing or high CPU usage, this may be related to WSL process management. ZoyaChat monitors WSL processes to prevent leaks. If issues persist, try switching to native Windows mode (no WSL required) in settings.如果遇到卡顿或 CPU 使用率过高，可能与 WSL 进程管理有关。ZoyaChat 会监控 WSL 进程以防止泄漏。如果问题持续，尝试在设置中切换到 Windows 原生模式（无需 WSL）。Если наблюдается зависание или высокая загрузка CPU, это может быть связано с управлением WSL-процессами. ZoyaChat отслеживает процессы WSL. Если проблема сохраняется, переключитесь на нативный режим Windows в настройках.
Encrypted messaging requires both parties to be online (or reachable via a relay node). If a message fails to send, check that the recipient is online and that at least one relay node is accessible. The official relay nodes provide fallback connectivity.加密通讯需要双方在线（或可通过中继节点到达）。如果消息发送失败，检查收件人是否在线以及是否有至少一个可访问的中继节点。官方中继节点提供备用连接。Шифрованный обмен требует, чтобы обе стороны были онлайн (или доступны через реле). Если сообщение не отправляется, проверьте, что получатель онлайн и хотя бы один реле-узел доступен.
If your Telegram bot stops responding but ZoyaChat itself works normally, the Telegram session has likely expired or lost sync. To fix this, go to the Agent's settings in ZoyaChat, find the Telegram configuration, and restart the conversation. The bot will reconnect and resume responding.如果你的 Telegram 机器人停止响应，但 ZoyaChat 本身正常工作，说明 Telegram 会话可能已过期或失去同步。解决方法：在 ZoyaChat 中进入对应 Agent 的设置，找到 Telegram 配置，重启会话。机器人将重新连接并恢复响应。Если Telegram-бот перестал отвечать, но ZoyaChat работает нормально, вероятно, сессия Telegram истекла или потеряла синхронизацию. Перейдите в настройки агента в ZoyaChat, найдите конфигурацию Telegram и перезапустите беседу. Бот переподключится и возобновит работу.