Skip to content

Commit c486226

Browse files
committed
feat: add Windows one-click install scripts and update clone URLs to fork repository
1 parent f907be2 commit c486226

File tree

4 files changed

+296
-25
lines changed

4 files changed

+296
-25
lines changed

README.md

Lines changed: 48 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 🦞 Moltbot — Personal AI Assistant
1+
# 🦞 Moltbot — Personal AI Assistant (Windows Enhanced Fork)
22

33
<p align="center">
44
<img src="https://raw.githubusercontent.com/moltbot/moltbot/main/docs/whatsapp-clawd.jpg" alt="Clawdbot" width="400">
@@ -9,24 +9,51 @@
99
</p>
1010

1111
<p align="center">
12-
<a href="https://github.com/moltbot/moltbot/actions/workflows/ci.yml?branch=main"><img src="https://img.shields.io/github/actions/workflow/status/moltbot/moltbot/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a>
13-
<a href="https://github.com/moltbot/moltbot/releases"><img src="https://img.shields.io/github/v/release/moltbot/moltbot?include_prereleases&style=for-the-badge" alt="GitHub release"></a>
14-
<a href="https://deepwiki.com/moltbot/moltbot"><img src="https://img.shields.io/badge/DeepWiki-moltbot-111111?style=for-the-badge" alt="DeepWiki"></a>
15-
<a href="https://discord.gg/clawd"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
12+
<a href="https://github.com/Joinsyna-Co-Ltd/moltbot-new/actions"><img src="https://img.shields.io/badge/Windows-Native%20Support-0078D6?style=for-the-badge&logo=windows" alt="Windows Native Support"></a>
1613
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
14+
<a href="https://discord.gg/clawd"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
1715
</p>
1816

17+
> 🎉 **This is an enhanced fork with full Windows native support!** The original [moltbot/moltbot](https://github.com/moltbot/moltbot) only supports Windows via WSL2. This fork adds **native Windows support** - no WSL2 required!
18+
1919
**Moltbot** is a *personal AI assistant* you run on your own devices.
2020
It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat), plus extension channels like BlueBubbles, Matrix, Zalo, and Zalo Personal. It can speak and listen on macOS/iOS/Android, and can render a live Canvas you control. The Gateway is just the control plane — the product is the assistant.
2121

2222
If you want a personal, single-user assistant that feels local, fast, and always-on, this is it.
2323

2424
**[中文文档 / Chinese README](README.zh-CN.md)**
2525

26-
[Website](https://molt.bot) · [Docs](https://docs.molt.bot) · [Getting Started](https://docs.molt.bot/start/getting-started) · [Updating](https://docs.molt.bot/install/updating) · [Showcase](https://docs.molt.bot/start/showcase) · [FAQ](https://docs.molt.bot/start/faq) · [Wizard](https://docs.molt.bot/start/wizard) · [Nix](https://github.com/moltbot/nix-clawdbot) · [Docker](https://docs.molt.bot/install/docker) · [Discord](https://discord.gg/clawd)
26+
## ✨ What's New in This Fork
27+
28+
| Feature | Original | This Fork |
29+
|---------|----------|-----------|
30+
| Windows Native | ❌ WSL2 only |**Full native support** |
31+
| One-click Install || ✅ PowerShell script |
32+
| Chinese Docs || ✅ Complete |
33+
| Quick Start Script || ✅ Included |
34+
35+
[Docs](https://docs.molt.bot) · [Getting Started](https://docs.molt.bot/start/getting-started) · [FAQ](https://docs.molt.bot/start/faq) · [Discord](https://discord.gg/clawd)
36+
37+
## 🚀 Windows One-Click Install
38+
39+
**Run this in PowerShell (as Administrator):**
40+
41+
```powershell
42+
irm https://raw.githubusercontent.com/Joinsyna-Co-Ltd/moltbot-new/main/scripts/install-windows.ps1 | iex
43+
```
44+
45+
This script will:
46+
- ✅ Check Node.js (v22+) and Git
47+
- ✅ Install pnpm if needed
48+
- ✅ Clone the repository
49+
- ✅ Install dependencies
50+
- ✅ Build the project
51+
52+
After installation, follow the on-screen instructions to configure and start.
2753

28-
Preferred setup: run the onboarding wizard (`moltbot onboard`). It walks through gateway, workspace, channels, and skills. The CLI wizard is the recommended path and works on **macOS, Linux, and Windows (via WSL2; strongly recommended)**.
29-
Works with npm, pnpm, or bun.
54+
## Quick Start (All Platforms)
55+
56+
Works with npm, pnpm, or bun. Runtime: **Node ≥22**.
3057
New install? Start here: [Getting started](https://docs.molt.bot/start/getting-started)
3158

3259
**Subscriptions (OAuth):**
@@ -97,8 +124,8 @@ Details: [Development channels](https://docs.molt.bot/install/development-channe
97124
Prefer `pnpm` for builds from source. Bun is optional for running TypeScript directly.
98125

99126
```bash
100-
git clone https://github.com/moltbot/moltbot.git
101-
cd moltbot
127+
git clone https://github.com/Joinsyna-Co-Ltd/moltbot-new.git
128+
cd moltbot-new
102129

103130
pnpm install
104131
pnpm ui:build # auto-installs UI deps on first run
@@ -126,10 +153,19 @@ Moltbot now fully supports **native Windows** (no WSL2 required).
126153

127154
### Windows Quick Start
128155

156+
**Option 1: One-Click Install (Recommended)**
157+
158+
```powershell
159+
# Run in PowerShell as Administrator
160+
irm https://raw.githubusercontent.com/Joinsyna-Co-Ltd/moltbot-new/main/scripts/install-windows.ps1 | iex
161+
```
162+
163+
**Option 2: Manual Install**
164+
129165
```powershell
130166
# Clone and build
131-
git clone https://github.com/moltbot/moltbot.git
132-
cd moltbot
167+
git clone https://github.com/Joinsyna-Co-Ltd/moltbot-new.git
168+
cd moltbot-new
133169
134170
# Install dependencies
135171
pnpm install

README.zh-CN.md

Lines changed: 49 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 🦞 Moltbot — 个人 AI 助手
1+
# 🦞 Moltbot — 个人 AI 助手 (Windows 增强版)
22

33
<p align="center">
44
<img src="https://raw.githubusercontent.com/moltbot/moltbot/main/docs/whatsapp-clawd.jpg" alt="Clawdbot" width="400">
@@ -9,21 +9,47 @@
99
</p>
1010

1111
<p align="center">
12-
<a href="https://github.com/moltbot/moltbot/actions/workflows/ci.yml?branch=main"><img src="https://img.shields.io/github/actions/workflow/status/moltbot/moltbot/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a>
13-
<a href="https://github.com/moltbot/moltbot/releases"><img src="https://img.shields.io/github/v/release/moltbot/moltbot?include_prereleases&style=for-the-badge" alt="GitHub release"></a>
14-
<a href="https://deepwiki.com/moltbot/moltbot"><img src="https://img.shields.io/badge/DeepWiki-moltbot-111111?style=for-the-badge" alt="DeepWiki"></a>
15-
<a href="https://discord.gg/clawd"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
12+
<a href="https://github.com/Joinsyna-Co-Ltd/moltbot-new"><img src="https://img.shields.io/badge/Windows-原生支持-0078D6?style=for-the-badge&logo=windows" alt="Windows 原生支持"></a>
1613
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
14+
<a href="https://discord.gg/clawd"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
1715
</p>
1816

17+
> 🎉 **这是一个增强版 Fork,完全支持 Windows 原生运行!** 原版 [moltbot/moltbot](https://github.com/moltbot/moltbot) 仅支持通过 WSL2 在 Windows 上运行。本 Fork 添加了 **Windows 原生支持** - 无需 WSL2!
18+
1919
**Moltbot** 是一个运行在您自己设备上的*个人 AI 助手*
2020
它可以在您已经使用的渠道上回复您(WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat),以及扩展渠道如 BlueBubbles、Matrix、Zalo 等。它可以在 macOS/iOS/Android 上进行语音交互,并可以渲染您控制的实时画布。Gateway 只是控制平面——产品是助手本身。
2121

2222
如果您想要一个本地化、快速、始终在线的个人单用户助手,这就是它。
2323

2424
**[English README](README.md)**
2525

26-
[官网](https://molt.bot) · [文档](https://docs.molt.bot) · [快速开始](https://docs.molt.bot/start/getting-started) · [更新指南](https://docs.molt.bot/install/updating) · [展示](https://docs.molt.bot/start/showcase) · [常见问题](https://docs.molt.bot/start/faq) · [向导](https://docs.molt.bot/start/wizard) · [Docker](https://docs.molt.bot/install/docker) · [Discord](https://discord.gg/clawd)
26+
## ✨ 本 Fork 的改进
27+
28+
| 功能 | 原版 | 本 Fork |
29+
|------|------|---------|
30+
| Windows 原生支持 | ❌ 仅 WSL2 |**完全原生支持** |
31+
| 一键安装脚本 || ✅ PowerShell 脚本 |
32+
| 中文文档 || ✅ 完整中文文档 |
33+
| 快速启动脚本 || ✅ 已包含 |
34+
35+
[文档](https://docs.molt.bot) · [快速开始](https://docs.molt.bot/start/getting-started) · [常见问题](https://docs.molt.bot/start/faq) · [Discord](https://discord.gg/clawd)
36+
37+
## 🚀 Windows 一键安装
38+
39+
**在 PowerShell 中运行(以管理员身份):**
40+
41+
```powershell
42+
irm https://raw.githubusercontent.com/Joinsyna-Co-Ltd/moltbot-new/main/scripts/install-windows.ps1 | iex
43+
```
44+
45+
此脚本将自动:
46+
- ✅ 检查 Node.js (v22+) 和 Git
47+
- ✅ 安装 pnpm(如果需要)
48+
- ✅ 克隆仓库
49+
- ✅ 安装依赖
50+
- ✅ 构建项目
51+
52+
安装完成后,按照屏幕上的说明进行配置和启动。
2753

2854
---
2955

@@ -69,8 +95,8 @@ moltbot onboard --install-daemon
6995
### 方法二:从源码构建
7096

7197
```bash
72-
git clone https://github.com/moltbot/moltbot.git
73-
cd moltbot
98+
git clone https://github.com/Joinsyna-Co-Ltd/moltbot-new.git
99+
cd moltbot-new
74100

75101
pnpm install
76102
pnpm build
@@ -94,12 +120,21 @@ Moltbot 现在完全支持 **Windows 原生运行**(无需 WSL2)。
94120

95121
### Windows 快速开始(详细步骤)
96122

123+
**方式一:一键安装(推荐)**
124+
125+
```powershell
126+
# 以管理员身份运行 PowerShell,执行:
127+
irm https://raw.githubusercontent.com/Joinsyna-Co-Ltd/moltbot-new/main/scripts/install-windows.ps1 | iex
128+
```
129+
130+
**方式二:手动安装**
131+
97132
#### 步骤 1:克隆项目
98133

99134
```powershell
100135
# 打开 PowerShell(以管理员身份运行可获得更好的体验)
101-
git clone https://github.com/moltbot/moltbot.git
102-
cd moltbot
136+
git clone https://github.com/Joinsyna-Co-Ltd/moltbot-new.git
137+
cd moltbot-new
103138
```
104139

105140
#### 步骤 2:安装依赖
@@ -410,8 +445,8 @@ moltbot config set gateway.mode local
410445

411446
```powershell
412447
# 克隆仓库
413-
git clone https://github.com/moltbot/moltbot.git
414-
cd moltbot
448+
git clone https://github.com/Joinsyna-Co-Ltd/moltbot-new.git
449+
cd moltbot-new
415450
416451
# 安装依赖
417452
pnpm install
@@ -442,8 +477,9 @@ pnpm format
442477
## 社区
443478

444479
- [Discord](https://discord.gg/clawd) - 加入我们的社区讨论
445-
- [GitHub Issues](https://github.com/moltbot/moltbot/issues) - 报告问题或提出建议
480+
- [GitHub Issues](https://github.com/Joinsyna-Co-Ltd/moltbot-new/issues) - 报告问题或提出建议
446481
- [贡献指南](CONTRIBUTING.md) - 了解如何参与贡献
482+
- [原版仓库](https://github.com/moltbot/moltbot) - 上游项目
447483

448484
## 许可证
449485

scripts/install-windows.ps1

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
# Moltbot Windows 一键安装脚本
2+
# 使用方法: 以管理员身份运行 PowerShell,执行:
3+
# irm https://raw.githubusercontent.com/Joinsyna-Co-Ltd/moltbot-new/main/scripts/install-windows.ps1 | iex
4+
5+
$ErrorActionPreference = "Stop"
6+
7+
Write-Host ""
8+
Write-Host "========================================" -ForegroundColor Cyan
9+
Write-Host " Moltbot Windows 一键安装脚本" -ForegroundColor Cyan
10+
Write-Host " https://github.com/Joinsyna-Co-Ltd/moltbot-new" -ForegroundColor Cyan
11+
Write-Host "========================================" -ForegroundColor Cyan
12+
Write-Host ""
13+
14+
# 检查是否以管理员身份运行
15+
$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
16+
if (-not $isAdmin) {
17+
Write-Host "[警告] 建议以管理员身份运行以获得最佳体验" -ForegroundColor Yellow
18+
}
19+
20+
# 检查 Node.js
21+
Write-Host "[1/6] 检查 Node.js..." -ForegroundColor Green
22+
try {
23+
$nodeVersion = node --version 2>$null
24+
if ($nodeVersion) {
25+
$versionNum = [int]($nodeVersion -replace 'v(\d+)\..*', '$1')
26+
if ($versionNum -ge 22) {
27+
Write-Host " ✓ Node.js $nodeVersion 已安装" -ForegroundColor Green
28+
} else {
29+
Write-Host " ✗ Node.js 版本过低 ($nodeVersion),需要 v22+" -ForegroundColor Red
30+
Write-Host " 请从 https://nodejs.org/ 下载安装 Node.js 22+" -ForegroundColor Yellow
31+
exit 1
32+
}
33+
}
34+
} catch {
35+
Write-Host " ✗ Node.js 未安装" -ForegroundColor Red
36+
Write-Host " 请从 https://nodejs.org/ 下载安装 Node.js 22+" -ForegroundColor Yellow
37+
exit 1
38+
}
39+
40+
# 检查 Git
41+
Write-Host "[2/6] 检查 Git..." -ForegroundColor Green
42+
try {
43+
$gitVersion = git --version 2>$null
44+
if ($gitVersion) {
45+
Write-Host "$gitVersion 已安装" -ForegroundColor Green
46+
}
47+
} catch {
48+
Write-Host " ✗ Git 未安装" -ForegroundColor Red
49+
Write-Host " 请从 https://git-scm.com/download/win 下载安装 Git" -ForegroundColor Yellow
50+
exit 1
51+
}
52+
53+
# 检查/安装 pnpm
54+
Write-Host "[3/6] 检查 pnpm..." -ForegroundColor Green
55+
try {
56+
$pnpmVersion = pnpm --version 2>$null
57+
if ($pnpmVersion) {
58+
Write-Host " ✓ pnpm $pnpmVersion 已安装" -ForegroundColor Green
59+
}
60+
} catch {
61+
Write-Host " pnpm 未安装,正在安装..." -ForegroundColor Yellow
62+
npm install -g pnpm
63+
Write-Host " ✓ pnpm 安装完成" -ForegroundColor Green
64+
}
65+
66+
# 设置安装目录
67+
$installDir = "$env:USERPROFILE\moltbot"
68+
Write-Host "[4/6] 克隆项目到 $installDir..." -ForegroundColor Green
69+
70+
if (Test-Path $installDir) {
71+
Write-Host " 目录已存在,正在更新..." -ForegroundColor Yellow
72+
Set-Location $installDir
73+
git pull origin main
74+
} else {
75+
git clone https://github.com/Joinsyna-Co-Ltd/moltbot-new.git $installDir
76+
Set-Location $installDir
77+
}
78+
Write-Host " ✓ 项目克隆/更新完成" -ForegroundColor Green
79+
80+
# 安装依赖
81+
Write-Host "[5/6] 安装依赖..." -ForegroundColor Green
82+
pnpm install
83+
Write-Host " ✓ 依赖安装完成" -ForegroundColor Green
84+
85+
# 构建项目
86+
Write-Host "[6/6] 构建项目..." -ForegroundColor Green
87+
pnpm build
88+
if (Test-Path "ui") {
89+
pnpm ui:build 2>$null
90+
}
91+
Write-Host " ✓ 构建完成" -ForegroundColor Green
92+
93+
Write-Host ""
94+
Write-Host "========================================" -ForegroundColor Cyan
95+
Write-Host " 安装完成!" -ForegroundColor Cyan
96+
Write-Host "========================================" -ForegroundColor Cyan
97+
Write-Host ""
98+
Write-Host "下一步操作:" -ForegroundColor Yellow
99+
Write-Host ""
100+
Write-Host "1. 进入安装目录:" -ForegroundColor White
101+
Write-Host " cd $installDir" -ForegroundColor Gray
102+
Write-Host ""
103+
Write-Host "2. 初始配置:" -ForegroundColor White
104+
Write-Host " node moltbot.mjs setup" -ForegroundColor Gray
105+
Write-Host " node moltbot.mjs config set gateway.mode local" -ForegroundColor Gray
106+
Write-Host " node moltbot.mjs config set gateway.auth.token `"your-token`"" -ForegroundColor Gray
107+
Write-Host ""
108+
Write-Host "3. 配置 AI 模型 (选择一个):" -ForegroundColor White
109+
Write-Host " # Anthropic Claude:" -ForegroundColor Gray
110+
Write-Host " node moltbot.mjs config set models.providers.anthropic.apiKey `"your-key`"" -ForegroundColor Gray
111+
Write-Host " # 或 OpenAI:" -ForegroundColor Gray
112+
Write-Host " node moltbot.mjs config set models.providers.openai.apiKey `"your-key`"" -ForegroundColor Gray
113+
Write-Host ""
114+
Write-Host "4. 启动 Gateway:" -ForegroundColor White
115+
Write-Host " node moltbot.mjs gateway run --port 18789" -ForegroundColor Gray
116+
Write-Host ""
117+
Write-Host "5. 访问控制面板:" -ForegroundColor White
118+
Write-Host " node moltbot.mjs dashboard --no-open" -ForegroundColor Gray
119+
Write-Host ""
120+
Write-Host "更多信息请访问: https://github.com/Joinsyna-Co-Ltd/moltbot-new" -ForegroundColor Cyan
121+
Write-Host ""

0 commit comments

Comments
 (0)