codex-weixin

codex-weixin is a Codex-powered ClawWeixin bot for Weixin. It logs into Weixin with a QR code, receives messages, runs Codex locally, and sends replies back to the user.

• Weixin QR login
• persistent chat sessions per user
• local Codex integration
• text reply flow over the ClawWeixin-compatible transport
• per-user memory with /remember
• built-in reminders with /remind

npm install
npm run build
node dist/cli.js --login-only
node dist/cli.js

After --login-only, scan the QR code in Weixin. Then start the bot normally with node dist/cli.js.

• /status show the current session status
• /reset start a fresh Codex session
• /remember <text> save a fact for later
• /memory show saved memory status
• /remind in 10m <text> create a reminder
• /remind every day 09:00 <text> create a recurring reminder
• /remind stop stop recurring reminders

• Node.js 22+
• a local codex installation
• an existing Codex login on the machine

This project is currently focused on the core text-bot flow:

• inbound Weixin messages
• Codex-powered replies
• persistent session state
• memory and reminders

Media handling and some advanced operator tooling exist in the codebase but are not the main public-facing workflow yet.

npm test