夜雨聆风
告别一人一命令的原始部署方式，WeClaws 让微信 AI 机器人真正变成可管理、可分享、可长期运行的服务。
AI Agent 这件事，已经不只是“在网页里聊几句”了。我希望它能真正进入团队工作流：能长期在线，能接工具，能处理文件，能记住上下文，能在需要的时候自动把任务跑完。
对很多开发者来说，让一个微信 AI 机器人跑起来并不算难，难的是跑起来以后，怎么把它稳定地管住。
比如：微信 AI 机器人怎么长期在线、多个微信 AI 机器人怎么统一管理、不同用户怎么配置自己的模型、登录状态怎么查看、工具执行环境怎么隔离、出问题之后怎么定位和恢复。这些问题，单靠“本地跑一个命令”解决不了。WeClaws 想补上的，就是这块空缺。
KEY TAKEAWAY
WeClaws 是一个开源的微信 AI 助理管理平台，用来把原本偏单机、偏命令行的微信 AI 机器人，整理成更适合长期运行和多人协作的服务形态。
01 / OVERVIEW
WeClaws 是什么
WeClaws 是一个开源的微信 AI 助理管理平台。它不是单纯的聊天页面，也不是只给一个人用的命令行工具，而是一套更适合长期运行的控制面板：你可以通过 Web 界面管理多个微信 AI 机器人、多个用户账号、多个模型配置，并让机器人在隔离环境中稳定运行。
简单来说，它解决的不是“微信 AI 机器人能不能做出来”，而是“做出来之后，能不能被真正地管理、部署和长期运行”。
02 / WHY NOW
为什么要做成管理平台
很多微信 AI 助手项目，最开始都能解决“能不能用”的问题。但只要进入真实使用，很快就会遇到“怎么管”的问题。
如果只有一个人、一个账号、一个微信 AI 机器人，本地命令行或许还够用。但一旦进入团队协作、多机器人并行、模型配置分离、工具调用和任务执行这些场景，问题就会立刻放大。
WeClaws 真正想解决的，是让微信 AI 机器人从单机脚本，变成多人可用、长期在线、状态可见、环境可控的服务。
03 / CONTROL LAYER
平台能管什么
WeClaws 首先解决的是“管理”问题。你部署一次，后续大部分操作都能在网页里完成。
01
多人账号，各自独立
管理员用邀请码控制谁能注册，每个用户有自己的模型配置和机器人，互不干扰。一次部署，整个团队都能用。
02
网页上启停机器人
不用 SSH 登录服务器，打开网页就能创建、启动、停止微信 AI 机器人，实时看到运行状态和微信登录情况。
03
模型配置各自保管
每个人填自己的 API Key，选自己的模型。平台不碰你的密钥，也不会把配置写死在代码里。
04
AI 机器人分享
创建一个微信 AI 机器人之后，可以生成分享链接发给别人。对方打开链接、扫码登录，就能直接开始使用，不用自己再配一遍。
04 / AGENT CAPABILITY
微信 AI 机器人在微信里能干什么
接入微信之后，这个机器人不是只能聊天。它背后接的是一个完整的 Agent 引擎。
01
收发消息和文件
文本、图片、语音、文件都能接收，也能主动发消息和文件。登录状态断了会自动恢复，不用每次都重新扫码。
02
调用工具执行任务
你可以让它读文件、跑命令、查进程，也可以通过 MCP 接入外部工具。需要做的事直接在聊天里交代，不用切换窗口。
SCENARIOS
如果你平时就在做自动化编程，或者习惯用 vibe coding 把零碎需求快速串起来，这种入口会很顺手。像浏览器自动化任务、信息抓取、批量整理、简单脚本执行这类事，也可以直接交给微信 AI 机器人去跑。
03
记忆、技能和定时任务
长会话能记住上下文，可以安装技能包扩展能力，也能设置定时任务自动执行。所有操作都在隔离的沙盒里运行，不会把宿主环境弄乱。
04
后台自动整理记忆
聊天久了上下文会膨胀，机器人在空闲时会自动压缩和整理记忆。你不用手动清理，它自己知道该记住什么、该放下什么。
05 / AUDIENCE
适合谁
想把 AI Agent 接入微信的开发者
想给团队统一部署微信 AI 助手的人
想把自动化编程、vibe coding、浏览器自动化任务放进微信入口的人
想交付一个可管理机器人平台的人
想研究多用户 Agent 管理、工具调用、沙盒执行的人
06 / DEPLOYMENT
快速部署
如果你是准备上生产环境，不需要先把整套仓库拉下来。直接拿官方的 Compose 文件和生产覆盖文件，再补好 .env，就可以跑起来。
bash
mkdir -p weclaws && cd weclaws
curl -O https://raw.githubusercontent.com/baseclaw/weclaws/main/infra/compose/docker-compose.yml
curl -O https://raw.githubusercontent.com/baseclaw/weclaws/main/infra/compose/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/baseclaw/weclaws/main/infra/compose/.env.example
把 .env 里至少这几项改成生产值：WECLAWS_DATA_ROOT=/srv/weclaws/data、APP_BASE_URL=https://你的域名、BETTER_AUTH_SECRET=...、BROWSERLESS_TOKEN=...。
bash
docker compose --env-file .env -f docker-compose.yml -f docker-compose.prod.yml pull
docker compose --env-file .env -f docker-compose.yml -f docker-compose.prod.yml up -d
这样跑起来的就是生产部署形态：直接使用已发布镜像，数据落到你指定的持久化目录里。
07 / WORKFLOW
使用流程
1. 管理员注册账号
2. 在后台生成邀请码
3. 其他用户用邀请码注册
4. 创建模型配置
5. 创建微信 AI 机器人
6. 启动机器人实例
7. 扫描页面上的微信二维码登录
8. 如需给别人使用，生成分享链接，把 AI 机器人分享出去
9. 开始在微信里使用
08 / ROADMAP
未来规划
WeClaws 现在先把微信这一条通道打磨扎实。
这不是因为它只想做微信，而是因为微信本身就是很多团队日常沟通和任务流转最真实、最高频的入口。先把这一条链路跑顺，比一开始把所有通道一起铺开更重要。
后面会陆续补更多通道支持，比如飞书、企业微信、Discord 等。到那时候，WeClaws 想做的也不只是“多接几个聊天入口”，而是把同一套 AI Agent 管理、模型配置、任务执行和分享能力，平稳地放到不同协作场景里。
09 / CLOSING
最后
我越来越强烈地觉得，AI Agent 真正有价值的地方，不是在一个独立页面里“看起来很聪明”，而是在真实入口里长期工作。而在中文互联网的日常工作场景里，微信就是这样一个入口。
WeClaws 关注的不是“能不能做一个微信 AI 机器人”，而是“能不能把微信 AI 机器人做成一个真正可部署、可管理、可持续运行的系统”。
GitHub：https://github.com/baseclaw/weclaws
如果你正在关注微信 AI 助手、AI Agent、MCP、技能扩展、自动化工作流这些方向，可以直接去看看这个项目。觉得有用的话，点个 Star 就够了。
