项目档案命令行工具

WeClaw 微信 AI Agent 桥接器：连接 Claude、Codex 等 AI 代理，一键安装使用

WeClaw 是一个开源工具，将微信作为 AI Agent 的交互入口，支持 Claude、Codex 等代理。提供文本、图片、语音消息处理，主动推送和 HTTP API。本页介绍项目定位、安装步骤、使用命令及技术实现特点。

1,672GoStar 于 2026年3月24日2026年9月19日更新

AI 总结

WeClaw 是一个微信 AI Agent 桥接器，通过扫码登录微信，将消息路由到 Claude、Codex 等 AI 代理，支持文本、图片、语音等多种消息类型，并提供主动推送和本地 API，实现微信与 AI 的无缝交互。

中文项目介绍

WeClaw 是一个开源的微信 AI Agent 桥接器，旨在将微信消息无缝接入多种 AI 代理（如 Claude、Codex、Gemini、Kimi 等），实现通过微信与 AI 对话。项目解决了如何将日常使用的微信作为 AI 交互入口的问题，支持文本、图片、视频、文件及语音消息的处理，并自动进行格式转换（如语音转文字、Markdown 转纯文本、图片下载上传）。适用场景主要包括个人学习与实验，将 AI 代理接入微信进行对话；开发者快速原型验证 AI 与微信的交互；以及需要将 AI 能力通过微信分发的个人项目。技术实现上，WeClaw 采用 Go 语言开发，提供三种 Agent 接入模式：ACP（长驻子进程 JSON-RPC，最快）、CLI（每消息启动进程）和 HTTP（OpenAI 兼容 API），并自动优选 ACP。配置保存在本地，支持多微信账号管理和主动消息推送，同时提供本地 HTTP API 供外部调用。从当前仓库信息可见，项目专注于个人学习用途，未明确涉及商业使用或企业级功能。

详细信息与使用说明

1. 项目定位与用途

WeClaw 是一个微信 AI Agent 桥接器，连接微信消息到多种 AI 代理（Claude、Codex、Gemini、Kimi 等）。它允许用户通过微信直接与 AI 代理交互，支持文本、图片、语音等消息类型，并提供主动推送功能。项目灵感来自 @tencent-weixin/openclaw-weixin，仅限个人学习使用。核心用途是将微信作为 AI 交互的前端入口，降低使用门槛。

2. 解决的问题

从当前仓库信息可见，项目主要解决如何将微信作为 AI Agent 的前端接口的问题。它实现了消息路由、媒体处理、会话管理等功能，但未明确给出完整的问题定义，如具体痛点或市场空白。基于功能推断，它简化了 AI 代理的微信集成，避免了手动开发微信机器人，提供了开箱即用的桥接方案。

3. 适用场景

适用场景包括个人学习与实验，将 AI 代理（如 Claude）接入微信进行对话；开发者快速原型验证 AI 与微信的交互；以及需要将 AI 能力通过微信分发的个人项目。仓库中未明确给出企业级或商业场景，强调个人学习用途，不适用于商业部署。

4. 安装方式

仓库提供了三种安装方式：一键安装脚本（curl -sSL https://raw.githubusercontent.com/fastclaw-ai/weclaw/main/install.sh | sh）、Go 安装（go install github.com/fastclaw-ai/weclaw@latest）和 Docker 运行（docker run -it -v ~/.weclaw:/root/.weclaw ghcr.io/fastclaw-ai/weclaw start）。所有方式均基于公开命令，未明确给出其他平台或依赖说明，如 Windows 特定步骤或系统要求。

5. 使用方式

使用 weclaw start 启动服务，首次运行需扫码登录微信。支持 weclaw login 添加多账号，weclaw send 主动推送消息。在微信中，通过命令前缀（如 /codex）或别名（如 /cc）路由到特定 Agent，支持 /claude 切换默认 Agent、/cwd 切换工作目录、/new 新建会话等。配置保存在 ~/.weclaw/config.json，可通过编辑文件自定义别名。

6. 补充说明或实现特点

实现特点包括三种 Agent 模式（ACP、CLI、HTTP）自动优选；富媒体处理如语音转文字、图片 Markdown 自动下载上传至微信 CDN、Markdown 转纯文本；本地 HTTP API 运行于 127.0.0.1:18011 提供发送接口；支持自定义别名。项目基于 Cobra 构建 CLI，使用 JSON-RPC 等协议。仓库中未明确给出性能指标、安全机制或错误处理细节。

思维导图

当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。

常见问题

如何安装 WeClaw？

支持三种方式：一键脚本（curl 命令）、Go 安装（go install）或 Docker 运行，详见安装章节。所有命令均来自仓库 README。

首次使用需要什么步骤？

运行 weclaw start，首次会显示二维码，用微信扫码登录即可自动开始接收和回复消息。随后可配置 Agent 和别名。

支持哪些 AI 代理？

支持 Claude、Codex、Gemini、Kimi、Cursor、OpenCode、OpenClaw 等，通过 ACP、CLI 或 HTTP 模式接入。自动检测并优先使用 ACP 模式。

如何处理图片和语音消息？

语音消息自动转文字发送给 AI；AI 返回的图片 Markdown 会自动下载并上传到微信 CDN 以图片消息发送；整体 Markdown 响应转为纯文本在微信显示。

可以主动发送消息给微信用户吗？

可以，使用 weclaw send 命令或本地 HTTP API（127.0.0.1:18011）向微信用户发送文本、图片或文件，无需等待对方先发消息。