Macro Your Work, Claw Your Way
Go 语言编写的轻量级个人 AI 助手，$10 硬件即可运行，~30MB 内存占用，毫秒级启动（10-30ms），支持 38+ LLM 提供商、20 个渠道接入、6 种 Linux 架构。
选择你的平台，开始体验 MakerClaw
纯 Go 原生编译，实测各子命令启动时间 10-30ms，冷启动无 JVM/解释器开销，交互即开即用。
完整 CLI 实测峰值 RAM 约 30MB，可运行于 $10 的树莓派 Zero / 旧安卓设备，旧硬件焕发新生。
已实测 20 个 channel，支持 Telegram / 飞书 / Discord / 微信 / Slack 等 IM 平台，一处部署多渠道触达。
原生支持 Model Context Protocol，可挂载外部工具与数据源，扩展 Agent 能力边界。
双路由系统：Agent 路由（7 个 when 字段）按场景切换模型，Model 路由按任务复杂度自动分流到轻量或重量模型。
二进制可直接执行，状态本地落盘，API 密钥加密入库，数据主权完全自主，无云端依赖。
桌面版 WebUI Launcher，浏览器内完成全部配置，端口 18800，零 CLI 门槛上手。
6 个 Linux 架构（amd64 / arm64 / armv7 / riscv64 / loong64 / mipsle）+ macOS / Windows / Android 全平台覆盖。
$10 硬件即可运行，30MB 内存占用，旧设备焕发新生，个人 AI 助手门槛降至最低。
10-30ms 启动，交互无延迟，告别 Spinner 等待，体验如原生应用般流畅。
覆盖国外主流 13+、国内 13+、本地 5+ 共 38+ LLM 提供商，一处配置多模型切换，灵活应对不同场景。
本地优先架构，密钥加密存储，状态本地落盘，无云端依赖，数据完全自主可控。
从 x86 到 MIPS，从 ARM 到 RISC-V，6 种 Linux 架构全覆盖，适配各种硬件环境。
WebUI 零门槛配置，桌面启动器一键运行，CLI / Docker 灵活部署，满足不同技术栈需求。
| 架构 | 二进制大小 | Gzip 压缩 |
|---|---|---|
| amd64 | 33.8 MB | 11.8 MB |
| arm64 | 31.4 MB | 10.8 MB |
| armv7 | 30.2 MB | 10.7 MB |
| riscv64 | 30.2 MB | 11.1 MB |
| loong64 | 32.3 MB | 10.9 MB |
| mipsle | 28.3 MB | 8.1 MB |
~/.makerclaw/config.json
主配置文件
定义模型列表与路由规则
~/.makerclaw/.security.yml
密钥文件（推荐）
API 密钥集中管理，与主配置分离
.env
仅开发参考
不作为运行时配置来源
model_name
模型实例名，用于路由引用
provider
提供商标识，如 openai/deepseek/ollama
model
模型名，如 gpt-4o/deepseek-chat
api_base
API 端点 URL
api_keys
API 密钥数组，支持多 Key 轮换
fallbacks
备用模型名数组，主模型不可用时自动切换
proxy
HTTP 代理地址
rpm
每分钟请求限制
request_timeout
请求超时（秒）
thinking_level
思考深度 low/medium/high
max_tokens_field
最大 Token 字段名
tool_schema_transform
工具 Schema 转换模式
extra_body
附加请求体字段
custom_headers
自定义请求头
enabled
是否启用（默认 true）
user_agent
自定义 UA
7 个 when 字段（channel/account/space/chat/topic/sender/mentioned）实现按场景自动切换模型
3 个字段（enabled/light_model/threshold）按任务复杂度自动分流到轻量或重量模型
api_keys 直接写在 config.json 中（简单但不安全）
密钥存入 .security.yml，config.json 引用名称即可
makerclaw doctor
验证配置 + 健康检查
makerclaw auth login --provider <name>
OAuth 类 provider 登录
makerclaw gateway
启动 Gateway（默认 127.0.0.1:18790）
makerclaw-launcher
启动 WebUI 控制台（端口 18800）
makerclaw-launcher -public
暴露到所有接口（远程访问）
makerclaw-launcher -no-browser
不自动打开浏览器（无头服务器）
MAKERCLAW_HOME
运行时目录（默认 ~/.makerclaw）
MAKERCLAW_CONFIG
配置文件路径
MAKERCLAW_GATEWAY_HOST
Gateway 监听主机
MAKERCLAW_BUILTIN_SKILLS
内置 Skills
MAKERCLAW_BINARY
主二进制路径
curl -sSL https://makerclaw.io/install.sh | bash 安装二进制，运行 makerclaw gateway 启动网关（默认 127.0.0.1:18790），运行 makerclaw-launcher 启动 WebUI 控制台（端口 18800）
Docker 方式：docker compose -f docker/docker-compose.yml --profile launcher up -d
下载 .dmg/.app (macOS)、.exe (Windows) 或 .AppImage/.deb (Linux) 安装包，安装后运行 MakerClaw Launcher，浏览器自动打开 http://localhost:18800