快速开始 · MakerClaw

三种安装方式

桌面优先 WebUI Launcher，服务器优先二进制，树莓派和老硬件请直接上 Docker。

桌面端 · 推荐

下载 makerclaw-launcher 双击即可启动。内置 WebUI，自动打开浏览器。

macOS

.dmg / .app

Windows

.exe / InnoSetup

Linux

.AppImage / .deb

命令行 · Linux 服务器

下载预编译二进制直接跑。适合轻量云服务器、NAS、家用 Linux 主机。

# 一行启动
curl -sSL https://makerclaw.io/install.sh | bash
makerclaw gateway
      

Docker · 多设备部署

老硬件、虚拟机、NAS 通用方案。一次配置，所有机器跑同样的版本。

# 启动 + 后台运行
docker compose -f docker/docker-compose.yml --profile launcher up -d
      

从源码编译

给二次开发者。前置：Go 1.25+ · Node.js 22+ · pnpm 10.33+。

# 克隆与依赖
git clone https://github.com/meikeit/makerclaw.git
cd makerclaw
make deps

# 安装前端依赖
(cd web/frontend && pnpm install --frozen-lockfile)

# 当前平台二进制
make build

# 构建 WebUI Launcher
make build-launcher

# 构建所有支持的平台
make build-all

# 树莓派 Zero 2 W（ARM 32 位）
make build-pi-zero

# 安装到 $GOPATH/bin
make install
  

四步跑通

无论你选了哪种安装方式，下面的步骤完全一样。

STEP 01

打开 WebUI 控制台

桌面端双击启动器后，浏览器会自动打开 http://localhost:18800。命令行启动则需要手动访问这个地址。

# 命令行启动 + 浏览器监听
makerclaw-launcher -public   ← -public 允许远程访问

# 手动访问
open http://localhost:18800
        

STEP 02

配置一个 LLM Provider

进入「Providers」面板，添加你的 API Key。MakerClaw 支持多家供应商混用，按路由规则自动切换。详见 LLM 配置。

# .env 写法（与 WebUI 等价）
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
        

STEP 03

接入聊天渠道（可选）

想让 AI 自动接管 Telegram / 飞书 / Discord，在「Channels」面板粘入对应 Bot Token 即可。一个 Agent 同时挂多个渠道。

# 飞书 / Feishu 示例
MAKERCLAW_CHANNELS_FEISHU_APP_ID=cli_xxx
MAKERCLAW_CHANNELS_FEISHU_APP_SECRET=xxx
        

STEP 04

启动 Gateway，开始聊天

点一下「Start Gateway」。状态栏变绿后，进入「Chat」面板发送第一条消息。Webhook 渠道则会在收到消息时自动拉起。

# 健康检查
curl http://localhost:18800/health

# 期望返回
{ "status": "ok", "version": "0.2.4" }
        

远程访问

默认仅监听 127.0.0.1。要让局域网或公网能访问，需要明确开关。

# 方式一：命令行参数（启动时）
makerclaw-launcher -public

# 方式二：环境变量（Docker / VM 场景）
MAKERCLAW_GATEWAY_HOST=0.0.0.0 makerclaw-launcher

# 局域网内访问：http://192.168.x.x:18800
# 公网访问：建议套 Cloudflare Tunnel 或自建反向代理
  

macOS 首次启动提示

未经过 Mac App Store 公证的二进制首次启动会被 Gatekeeper 拦截。一次放行即可：

系统设置 → 隐私与安全性

双击 makerclaw-launcher 看到警告弹窗时，打开 系统设置 → 隐私与安全性，滚到底部点「仍要打开」。

二次确认

在弹出的对话框再次点击「仍要打开」，之后即可正常运行，不再拦截。

60 秒上手