# Build a WeChat Official Account AI Bot with Claude

Source: https://langbot.app/docs/en/recipes/claude/wechat-official-account

Step-by-step guide to running a Claude-powered AI bot on WeChat Official Account with LangBot: model setup, bot credentials, networking, testing and troubleshooting.

This recipe puts a Claude model behind a WeChat Official Account bot. LangBot receives messages from WeChat Official Account, runs them through a pipeline, and sends the answer back, so you do not write any platform code.

Use Anthropic's Claude models with LangBot's built-in Agent, including tool use with MCP servers, Skills and the code sandbox.

## What you need

- A running LangBot instance: [LangBot Cloud](https://space.langbot.app/cloud) (no server needed) or a [self-hosted deployment](https://langbot.app/docs/en/deploy/langbot/docker.md) with Docker or `uvx langbot`.
- A Claude account or server you can call from LangBot.
- A WeChat Official Account or Service Account: **AppID**, **AppSecret**, a server **Token** and **EncodingAESKey**, with LangBot's server IP in the **IP whitelist**.

## Networking

Official Accounts require a public domain with HTTPS and must get a response within 5 seconds. Slow AI replies need `passive` or `auto` mode. LangBot Cloud includes a public domain.

## 1. Add the Claude model

1. Create an API key in the Anthropic console.
2. In LangBot, open **Models**, add an LLM model with the provider set to Anthropic, then paste the API key and the model ID.
3. Enable **Tool Use** if the model supports function calling; MCP tools, Skills and the sandbox need it.
4. Keep the provider's default request URL unless you use a gateway. Use a current Claude model ID from Anthropic's documentation.

## 2. Create a pipeline

Open **Pipelines** in the LangBot WebUI, create a pipeline (or edit the default one) and set **AI** as follows.

| Field           | Value                                                                  |
| --------------- | ---------------------------------------------------------------------- |
| Runner          | **Local Agent** (built-in Agent)                                       |
| Model           | The model you just added. You can add fallback models.                 |
| Prompt          | Instructions: who the bot is, tone, what it must not do.               |
| Knowledge Bases | Optional. Attach a knowledge base so answers come from your documents. |

## 3. Create the WeChat Official Account bot

1. Create a bot with the **WeChat Official Account** adapter and choose a reply mode: `drop` (reply within the 5-second callback), `passive` or `auto` (answer later through the customer service API when the account is enterprise-verified).
2. Paste the bot's callback URL into the account's server configuration and save.

## 4. Bind and test

Open the bot, select the pipeline you created, save and make sure the bot is enabled.

Follow the account in WeChat and send it a message.

## Troubleshooting

- The agent never calls tools: enable **Tool Use** on the model.
- Users see the loading message but no answer: in `passive` mode (or after `auto` falls back) the user must send another message to retrieve the queued answer.
- Customer service messages require an enterprise-verified account; identity verification alone is not enough.
- Check **Monitoring** in the WebUI: every message, pipeline run and error is recorded there.

## FAQ

### Do I need a server with a public IP for WeChat Official Account?

Yes, or use LangBot Cloud. Official Accounts require a public domain with HTTPS and must get a response within 5 seconds. Slow AI replies need `passive` or `auto` mode. LangBot Cloud includes a public domain.

### Does the WeChat Official Account bot support streaming replies?

Check the [platform feature matrix](https://langbot.app/docs/en/insight/platform-features.md) for what this platform supports. Replies are delivered once the AI back end has finished.

### Can the same Claude setup serve other platforms too?

Yes. A pipeline can be bound to many bots, so one configuration can answer on several platforms at once.

## Related guides

- [Full WeChat Official Account setup guide](https://langbot.app/docs/en/usage/platforms/wxoa.md)
- [Model configuration](https://langbot.app/docs/en/usage/models/readme.md)
- Other AI back ends on WeChat Official Account: [Dify](https://langbot.app/docs/en/recipes/dify/wechat-official-account.md) · [n8n](https://langbot.app/docs/en/recipes/n8n/wechat-official-account.md) · [Coze](https://langbot.app/docs/en/recipes/coze/wechat-official-account.md) · [Langflow](https://langbot.app/docs/en/recipes/langflow/wechat-official-account.md) · [DeepSeek](https://langbot.app/docs/en/recipes/deepseek/wechat-official-account.md)
- Claude on other platforms: [Telegram](https://langbot.app/docs/en/recipes/claude/telegram.md) · [Discord](https://langbot.app/docs/en/recipes/claude/discord.md) · [Slack](https://langbot.app/docs/en/recipes/claude/slack.md) · [Lark (Feishu)](https://langbot.app/docs/en/recipes/claude/lark.md) · [DingTalk](https://langbot.app/docs/en/recipes/claude/dingtalk.md) · [WeCom (internal app)](https://langbot.app/docs/en/recipes/claude/wecom.md)