What is xiaobei?
xiaobei is a social-media customer-acquisition agent built by the Wiseflow team for one-person companies and small businesses. It runs on top of the openclaw agent runtime and you talk to it through WeChat on your phone (Feishu and WeCom are also supported). It sits in the Writing & Marketing category of the AI Productivity & Writing tools and is open-source, written in Python and licensed Modified Apache 2.0 (commercial licence required for multi-tenant use; commercial crawling and unauthorised scraping prohibited).
Overview
xiaobei is a social-media customer-acquisition agent built by the Wiseflow team for one-person companies and small businesses. It runs on top of the openclaw agent runtime and you talk to it through WeChat on your phone (Feishu and WeCom are also supported). From that one chat window it writes, formats and pushes WeChat Official Account articles, creates and publishes Xiaohongshu image posts, generates posters and videos and distributes them to WeChat Channels, Douyin and Xiaohongshu, and posts to Twitter/X, Weibo and Zhihu. It can also break down trending videos from Douyin, Bilibili and Xiaohongshu links for rewriting, model the style of leading accounts in a niche, monitor the data of published posts with a daily scheduled review, and work comment sections for leads.
Behind the single chat sits a crew of agents. The default xiaobei agent handles content operations; a built-in IT Engineer sub-agent handles operations and troubleshooting; a content producer runs the video and visual production line; and an optional sales-and-customer-service agent (sales-cs) answers pre-sales questions from a knowledge base. When one agent hits a problem it cannot solve — the README's example is an expired WeChat access token during publishing — it calls the right sub-agent itself and resumes the task, without asking the user for help.
Platform automation runs on a reworked browser stack: a fork of camoufox-cli (the anti-detect Firefox build) with added upload, fail-first session queuing and identity export, plus a set of browser skills for login management, web form filling and per-platform publishing. A built-in Smart Search skill covers 18 kinds of sources, from Xiaohongshu, Douyin and Weibo to GitHub, news and academic sites, without any API key. Models default to an Alibaba Cloud Bailian (Model Studio) plan that covers chat, image generation, text-to-speech, speech recognition and video generation from one key; Volcano Engine Ark and MiniMax are supported for video. The code is published under a modified Apache 2.0 licence that forbids commercial crawling and requires a commercial licence for multi-tenant use.
What it does
- One WeChat chat controls everything — also works over Feishu and WeCom
- Writes, formats and publishes to WeChat Official Accounts, Xiaohongshu, Douyin, WeChat Channels, Twitter/X, Weibo and Zhihu, and can post to WeChat Moments through WeCom
- Trending-video breakdown and rewriting from Douyin, Bilibili and Xiaohongshu links, plus style modelling of leading accounts on Xiaohongshu, WeChat Channels, Douyin and WeChat Official Accounts
- Tracks the data of published posts and runs a scheduled daily review
- A crew of cooperating agents — xiaobei, IT Engineer, content producer and an optional sales-cs customer-service agent — that hand problems to each other without user involvement
- Browser automation on a forked camoufox-cli with persistent login sessions, plus a keyless Smart Search skill across 18 source types
- One-line installer for macOS, Linux and Windows that bundles a portable Node and pnpm, with a China-hosted mirror route
Getting started
The project recommends its one-line installer, which downloads a prebuilt tarball with a portable Node and pnpm, so nothing needs to be preinstalled. Have an Alibaba Cloud Bailian Token Plan key ready: the only manual input after the script runs is AWK_API_KEY. Recommended system is Ubuntu 22.04; WSL2, macOS (arm64 and x64) and Windows 10 1803+ are supported, with at least 8 GB RAM and 40 GB of free disk.
Install on macOS or Linux
Use the GitHub route if GitHub is reachable, or the atomgit route for networks in mainland China. Both install the same program to ~/xiaobei/ and keep runtime data in ~/.openclaw/.
# GitHub route
bash -c "$(curl -fsSL https://raw.githubusercontent.com/TeamWiseFlow/xiaobei/master/scripts/install.sh)"
# atomgit route (mainland China)
bash -c "$(curl -fsSL https://raw.atomgit.com/wiseflow/xiaobei/raw/master/scripts/install-atomgit.sh)"Or install on Windows
Install Git Bash first (tick "Add to PATH"), because the crew setup script needs bash, then run PowerShell as administrator. Turning on Developer Mode lets the installer create skill symlinks instead of copies.
irm https://raw.githubusercontent.com/TeamWiseFlow/xiaobei/master/scripts/install.ps1 | iexBind WeChat
At the end of the install the script prints a WeChat binding QR code; scan it with WeChat on your phone and confirm. To bind another account later, re-run the channel login.
~/xiaobei/bin/openclaw channels login --channel openclaw-weixinRun in the foreground for testing, and upgrade by re-running the installer
Debug mode starts the gateway once in the foreground instead of as a launchd/systemd service. Re-running the install script on a machine that already has ~/.openclaw/openclaw.json upgrades the program directory and leaves your data alone.
~/xiaobei/bin/openclaw gateway runCommands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- A one-person company that wants its WeChat Official Account, Xiaohongshu and short-video channels kept up without hiring an operations team
- Turning a trending Douyin, Bilibili or Xiaohongshu video into a breakdown and a new video of your own, then publishing it to several platforms at once
- Watching how published posts perform with an automatic daily review instead of checking each platform by hand
- Adding an AI pre-sales customer-service agent that answers from your own knowledge base
How xiaobei compares
xiaobei alongside other open-source writing & marketing tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| AiToEarn | ★ 27.6k | An AI content-marketing agent that creates, schedules and publishes posts to 14+ Chinese and global social platforms, with an MCP server, an agent skill bundle and a self-hosted Docker stack. |
| InkOS | ★ 11.1k | Story-creation agent for long novels, short fiction, scripts, storyboards, interactive film and translation, sharing one tool loop across a Studio web app, a TUI and a CLI while it keeps story state on disk. |
| xiaobei | ★ 8.7k | A self-hosted team of AI agents that writes, publishes and tracks social-media content for small businesses, driven entirely from a WeChat chat |
| chinese-novelist | ★ 4.8k | An agent skill that interviews you, plans an outline, cast and chapter plan, then writes, polishes and checks a complete 10–50 chapter Chinese novel, one Markdown file per chapter. |
| GEOFlow | ★ 4.1k | An open-source, self-hosted platform for generative engine optimization that runs knowledge-grounded AI content through quality checks, human review and multi-site publishing. |
| md2wechat | ★ 3.8k | Command-line tool that AI agents can drive to turn Markdown into WeChat Official Account articles, generate covers and infographics, check readiness and create drafts. |
| AI Novel Writer | ★ 2.6k | Local-first Windows and macOS desktop app that takes a novel from premise, characters and worldbuilding through chapter blueprints, drafts, AI review and revision, using local Ollama or cloud models. |
| Jasper | — | AI platform for marketing teams that runs brand-aware content workflows, campaigns and copy at scale using specialized agents. |