# Configure QQ Mail

Let an agent handle email through a specified QQ mailbox. Use a mailbox client authorization code, not the QQ login password.

## Obtain an authorization code

1. Sign in to [QQ Mail](https://mail.qq.com/) and open **Settings** at the top.
2. Find the **POP3/IMAP/SMTP/Exchange/CardDAV services** section. Enable the required IMAP/SMTP services if needed, then select **Generate authorization code**.
3. Complete the account verification and copy the code. Enter it only in MOI's authorization-code field.

Menus vary by mailbox version. If necessary, open account/security settings and find third-party client services, or search official help for authorization codes.

You need permission to create or edit tool configuration in the current MOI workspace. If the entry is missing or access is denied, contact the workspace administrator rather than using another person's account.

## Configure MOI

1. Prepare a test mailbox and enable the required client services.
2. Open **Resource Center → Tools → QQ Mail** and create an instance.
3. Enter the name, complete email address, and authorization code.
4. Save and test the connection.
5. Select the mailbox instance in the agent's tool configuration. If a code expires or is revoked, generate a new one, update, and retest.

| Field | Requirement | Value |
| --- | --- | --- |
| Instance name | Required | A name such as “Test QQ mailbox” |
| Email address | Required | The complete address; `test-user@qq.com` is only an example |
| Authorization code | Required | The client code generated by this same mailbox, not its login password |
| Timeout | As offered by the form | Usually retain the default; longer timeouts do not fix authentication |

## Validate agent use

After saving, reopen the configuration to confirm it persists and run **Test connection**. Then [bind the capability to the target agent](../bind-tools.md), selecting the intended connection wherever an instance selector is provided. Inspect an actual tool call and compare its result with the target platform. A configured badge or a plausible answer alone is insufficient.

First query a known test message in the mailbox. For sending, specify your own recipient address and explicit test content, then check actual receipt. A connection test does not establish delivery.

## Troubleshoot

| Symptom | Check |
| --- | --- |
| Authentication failed | Correct code rather than login password, matching mailbox, and enabled services |
| Connection timeout | MOI server outbound access to mailbox services |
| Message not received | Send result, recipient, spam folder, and bounces before repeating the send |

- [QQ Mail help](https://service.mail.qq.com/detail/0/75)
- [All tool configuration guides](index.md)