Documentation 文档 Документация

Getting Started快速开始Начало работы
Install & Setup安装与配置Установка и настройка

Get ZoyaChat running in minutes. Requires macOS 12+ or Windows 10+.几分钟内启动 ZoyaChat。需要 macOS 12+ 或 Windows 10+。Запустите ZoyaChat за несколько минут. Требуется macOS 12+ или Windows 10+.

1

Download下载Скачайте

Download the .dmg (macOS) or .exe (Windows) from the GitHub releases page.从 GitHub releases 页面下载 .dmg（macOS）或 .exe（Windows）。Скачайте .dmg (macOS) или .exe (Windows) со страницы релизов GitHub.

2

Install安装Установите

Open the installer and follow the standard installation process. On macOS, drag to Applications. On Windows, run the .exe installer.打开安装程序并按照标准安装流程操作。macOS 拖入应用程序文件夹，Windows 运行 .exe 安装程序。Откройте установщик. На macOS перетащите в Applications. На Windows запустите .exe.

3

Launch启动Запустите

Launch ZoyaChat. On first run, it will automatically detect and install the OpenClaw AI gateway.启动 ZoyaChat。首次运行时将自动检测并安装 OpenClaw AI 网关。Запустите ZoyaChat. При первом запуске автоматически установится шлюз OpenClaw.

4

Add API Key添加 API 密钥Добавьте API-ключ

Go to Settings and add your API key (e.g. OpenAI, Anthropic, Google). Keys are encrypted via OS safeStorage and never leave your machine.进入设置，添加 API 密钥（如 OpenAI、Anthropic、Google）。密钥通过 OS safeStorage 加密，不会离开设备。Перейдите в настройки и добавьте API-ключ (OpenAI, Anthropic, Google). Ключи шифруются через safeStorage.

5

Create Your First Agent创建第一个智能体Создайте первого агента

Click "New Agent", set its name, identity, system prompt, and select a model. Your agent is ready to go.点击「新建智能体」，设置名称、身份、系统提示词，选择模型。智能体准备就绪。Нажмите "Новый агент", задайте имя, личность, промпт и модель. Агент готов к работе.

Agents智能体Агенты
Agent Configuration智能体配置Настройка агентов

Each agent is an independent AI entity with its own identity, prompt, model, and tools.每个智能体是独立的 AI 实体，拥有自己的身份、提示词、模型和工具。Каждый агент — это независимая ИИ-сущность со своей личностью, промптом, моделью и инструментами.

What is an Agent?什么是智能体？Что такое агент?

An agent is a configured AI personality. It has a name, identity description, system prompt that defines its behavior, a selected AI model (e.g. Claude, GPT-4o), and optional tool permissions. Agents are stored locally in your openclaw.json config file.智能体是配置好的 AI 人格。它有名称、身份描述、定义行为的系统提示词、选定的 AI 模型（如 Claude、GPT-4o），以及可选的工具权限。智能体保存在本地 openclaw.json 配置文件中。Агент — это настроенная личность ИИ. У него есть имя, описание, системный промпт, выбранная модель (Claude, GPT-4o) и права на инструменты. Агенты хранятся локально в openclaw.json.

Create, Edit, Delete创建、编辑、删除Создание, редактирование, удаление

Create: Click "New Agent" in the sidebar. Fill in name, identity, system prompt, and select a model.
Edit: Click on any agent to open its settings. All fields are editable at any time.
Delete: Right-click an agent and select "Delete", or use the delete button in agent settings.创建：点击侧边栏的「新建智能体」，填写名称、身份、系统提示词，选择模型。
编辑：点击任意智能体打开设置，所有字段随时可编辑。
删除：右键点击智能体选择「删除」，或在设置中使用删除按钮。Создание: Нажмите "Новый агент" в боковой панели. Заполните имя, промпт, выберите модель.
Редактирование: Кликните по агенту для открытия настроек.
Удаление: Правый клик → "Удалить", или кнопка удаления в настройках.

Channel Integration渠道集成Интеграция каналов
Connect Agents to Channels将智能体连接到渠道Подключение агентов к каналам

Channels are messaging platforms your agents can respond on. Configuration is stored in openclaw.json. Each channel binding routes messages to a specific agent.渠道是智能体可以响应的消息平台。配置存储在 openclaw.json 中。每个渠道绑定将消息路由到特定智能体。Каналы — это платформы обмена сообщениями. Конфигурация хранится в openclaw.json. Каждая привязка направляет сообщения конкретному агенту.

✈️

Telegram

Open @BotFather on Telegram, create a new bot, copy the Bot Token. Paste it into ZoyaChat's Telegram channel settings.在 Telegram 中打开 @BotFather，创建新机器人，复制 Bot Token。将其粘贴到 ZoyaChat 的 Telegram 渠道设置中。Откройте @BotFather в Telegram, создайте бота, скопируйте токен. Вставьте в настройках канала ZoyaChat.

Bot Token
💬

Discord

Go to Discord Developer Portal. Create an application, add a Bot, enable Message Content Intent under Privileged Gateway Intents. Copy the Bot Token. Generate an invite URL with bot scope and add to your server.前往 Discord 开发者门户。创建应用，添加 Bot，在 Privileged Gateway Intents 下启用 Message Content Intent。复制 Bot Token，生成邀请链接添加到服务器。Перейдите на портал разработчиков Discord. Создайте приложение, добавьте бота, включите Message Content Intent. Скопируйте токен, создайте ссылку-приглашение.

Bot Token
📱

WhatsApp

In ZoyaChat, go to Channels and select WhatsApp. Click "Show QR". Scan the QR code with your phone's WhatsApp app (Settings > Linked Devices > Link a Device).在 ZoyaChat 中进入渠道，选择 WhatsApp。点击「显示二维码」。用手机 WhatsApp 扫描（设置 > 已关联设备 > 关联设备）。В ZoyaChat откройте каналы, выберите WhatsApp. Нажмите "Показать QR". Отсканируйте QR-код в WhatsApp (Настройки > Связанные устройства).

QR Code
💼

Slack

Create a Slack App at api.slack.com. Enable Socket Mode. Generate an App-Level Token (connections:write scope) and a Bot Token (with chat:write, app_mentions:read scopes). Paste both into ZoyaChat. Install the app to your workspace.在 api.slack.com 创建 Slack App。启用 Socket Mode。生成 App-Level Token（connections:write 权限）和 Bot Token（chat:write、app_mentions:read 权限）。粘贴到 ZoyaChat。将应用安装到工作区。Создайте Slack App на api.slack.com. Включите Socket Mode. Сгенерируйте App Token и Bot Token. Вставьте в ZoyaChat и установите приложение в рабочую область.

App Token + Bot Token
🟢

WeChat

ZoyaChat uses a WeChat plugin. Go to Channels, select WeChat, click "Show QR". Scan the QR code with your WeChat app to log in. The plugin bridges messages to your agent.ZoyaChat 使用微信插件。进入渠道，选择微信，点击「显示二维码」。用微信扫码登录。插件将消息转发给智能体。ZoyaChat использует плагин WeChat. Откройте каналы, выберите WeChat, нажмите "Показать QR". Отсканируйте QR-код в WeChat.

QR Code
📋

Other Channels其他渠道Другие каналы

LINE, Feishu, Signal, MS Teams, Matrix, IRC, and Google Chat are configured in the "Other" tab under Channels. Fill in the required credentials for each platform (tokens, keys, or server config).LINE、飞书、Signal、MS Teams、Matrix、IRC 和 Google Chat 在渠道的「其他」选项卡中配置。填写每个平台所需的凭据（令牌、密钥或服务器配置）。LINE, Feishu, Signal, MS Teams, Matrix, IRC и Google Chat настраиваются во вкладке "Другие" в разделе каналов. Введите необходимые данные для каждой платформы.

Per-channel credentials各渠道凭据Данные для каждого канала
FAQ
Frequently Asked Questions常见问题Часто задаваемые вопросы
Is ZoyaChat free?ZoyaChat 免费吗？ZoyaChat бесплатный?
Yes. ZoyaChat is free and open source under the MIT license. You need your own API keys for AI model providers (OpenAI, Anthropic, Google, etc.).是的。ZoyaChat 在 MIT 许可下免费开源。你需要自备 AI 模型提供商的 API 密钥（OpenAI、Anthropic、Google 等）。Да. ZoyaChat бесплатный и с открытым исходным кодом (MIT). Вам нужны собственные API-ключи (OpenAI, Anthropic, Google и т.д.).
Which AI models are supported?支持哪些 AI 模型？Какие ИИ-модели поддерживаются?
633+ models via OpenClaw, including Claude, GPT-4o, Gemini, Qwen, DeepSeek, Llama, Mistral, and many more. The model list is dynamically loaded and always up to date.通过 OpenClaw 支持 633+ 模型，包括 Claude、GPT-4o、Gemini、Qwen、DeepSeek、Llama、Mistral 等。模型列表动态加载，始终保持最新。633+ моделей через OpenClaw: Claude, GPT-4o, Gemini, Qwen, DeepSeek, Llama, Mistral и другие. Список обновляется динамически.
Do I need a server?需要服务器吗？Нужен ли сервер?
No. Everything runs locally on your machine. ZoyaChat includes an embedded OpenClaw gateway that handles all AI model routing and channel connections from your desktop.不需要。所有功能都在你的设备上本地运行。ZoyaChat 包含嵌入式 OpenClaw 网关，在桌面上处理所有 AI 模型路由和渠道连接。Нет. Всё работает локально. ZoyaChat включает встроенный шлюз OpenClaw, который маршрутизирует модели и подключения прямо с десктопа.
Is my data safe?我的数据安全吗？Мои данные в безопасности?
Yes. All configuration is stored locally on your machine. API keys are encrypted via OS safeStorage (macOS Keychain / Windows DPAPI). There is no telemetry, no analytics, no data collection. The code is open source and fully auditable.是的。所有配置存储在你的设备本地。API 密钥通过 OS safeStorage（macOS 钥匙串 / Windows DPAPI）加密。没有遥测、没有分析、没有数据收集。代码开源，完全可审计。Да. Вся конфигурация хранится локально. API-ключи зашифрованы через safeStorage (macOS Keychain / Windows DPAPI). Никакой телеметрии, аналитики или сбора данных. Код открыт.
Can I use multiple models?可以使用多个模型吗？Можно использовать разные модели?
Yes. Each agent can use a different model. For example, one agent on Claude for customer support, another on GPT-4o for code review, and a third on DeepSeek for Chinese-language tasks.可以。每个智能体可以使用不同的模型。例如，一个智能体用 Claude 做客户支持，另一个用 GPT-4o 做代码审查，第三个用 DeepSeek 处理中文任务。Да. Каждый агент может использовать свою модель. Например, один на Claude для поддержки, другой на GPT-4o для ревью кода, третий на DeepSeek для задач на китайском.
What about mobile?支持移动端吗？А мобильная версия?
ZoyaChat is desktop only (macOS + Windows). Mobile is not currently planned. The app requires a local OpenClaw gateway which needs a desktop environment.ZoyaChat 仅支持桌面端（macOS + Windows）。目前没有移动端计划。应用需要本地 OpenClaw 网关，需要桌面环境。ZoyaChat только для десктопа (macOS + Windows). Мобильная версия не планируется. Приложение требует локальный шлюз OpenClaw.
How do channels work?渠道是如何工作的？Как работают каналы?
The OpenClaw gateway runs locally and connects to messaging platforms via their APIs. When a message arrives on a channel (e.g. Telegram), the gateway routes it to the bound AI agent, gets a response, and sends it back. All routing is configured in openclaw.json.OpenClaw 网关在本地运行，通过 API 连接到消息平台。当消息到达渠道（如 Telegram）时，网关将其路由到绑定的 AI 智能体，获取响应并发送回去。所有路由在 openclaw.json 中配置。Шлюз OpenClaw работает локально и подключается к платформам через их API. Когда сообщение приходит в канал (напр. Telegram), шлюз направляет его привязанному агенту, получает ответ и отправляет обратно. Маршрутизация настраивается в openclaw.json.