weavbot 0.4.0

A lightweight personal AI assistant framework

weavbot

A lightweight personal AI assistant framework.

中文说明

Installation

uv tool install weavbot

Verify:

weavbot --version

To try the latest unreleased features:

uv tool install git+https://github.com/yankeguo/weavbot.git

Onboard (Recommended First Run)

Initialize local config/workspace and run the interactive setup wizard:

weavbot onboard

What onboard does:

• Creates ~/.weavbot/config.json and ~/.weavbot/workspace/
• Guides provider/model selection with realtime filtering
• Configures one chat channel in the wizard (Telegram/Discord/Feishu/DingTalk/Slack/QQ/Wecom/Email/Mochat)
• Offers optional ripgrep install and gateway auto-start setup

For non-interactive or scripted setup, use repeatable --set key=value:

weavbot onboard \
  --set providers.openrouter.apiKey=sk-or-v1-xxx \
  --set providers.openrouter.apiBase=https://openrouter.ai/api/v1 \
  --set agents.defaults.provider=openrouter \
  --set agents.defaults.model=openai/gpt-4o-mini

Detailed CLI docs:

• English: CLI Reference
• 中文: 命令参考

Full documentation: https://yankeguo.github.io/weavbot/

Wechat Channel

Wechat is configured in two phases:

1. Enable it in config (interactive onboard only sets placeholder enablement):
   • channels.wechat.enabled=true
2. Complete QR login and credential binding with:

weavbot wechat login

For multi-account setups, put account entries under channels.wechat.accounts and optionally limit runtime accounts with channels.wechat.enabledAccounts.

Configuration reference:

• English: Wechat config
• 中文: 微信配置

Credits

This project is a hard fork of nanobot by HKUDS, with significant optimizations and improvements.

License

MIT