najmuzzaman-mohammad/gawkbot

gawkbot – 开源“常驻”AI 助手，运行在你自己的机器上

它是什么 – gawkbot 是一款桌面（macOS）和 iPhone 伴侣应用，让你将工作流程的自然语言描述转化为专用的 AI 驱动“微应用”。每个微应用（称为 bot）都在本地运行，使用你已有的 LLM（Claude Code、Codex、Opencode，或任何你通过 Ollama/Hermes/OpenClaw 暴露的本地模型），并能操作 1,200 多个集成（Slack、Gmail、HubSpot 等）。每个外部操作（发送、提交、购买、删除）都暂停在需要你点击的 审批门 之后。

工作原理

• 代理检测 – 启动时，gawkbot 扫描你的 PATH、配置文件夹和运行进程，以发现现有的 LLM-CLI 工具（Claude Code、Codex、Cursor 等）。检测到的代理可以被 采用 并成为独立的 bot。
• Bot 构建 – 你用一句话描述工作流程（或演示它）。所选 LLM 构建一个 bot：一个沙盒目录、一个屏幕 UI、一个计划（Routines）、一组工具、一个类型化数据表，以及一个带引用的知识 wiki 页面。
• 运行时 – 每个 bot 在你机器上的独立沙盒中运行（或你指向的云 VM）。一个 side-car 服务（agent/）监督 bot 进程。Bot 也可以通过 iPhone 应用访问，该应用显示相同的问题收件箱。
• Notch UI – 在 macOS 上，助手位于摄像头刘海处。它会弹出带有情绪、声音提示和键盘快捷键（⌃⌥Space 打开，J/K 导航，1-9 选择答案，V 说话等）。
• 审批门 – 读取是免费的；任何写操作都作为 ExternalActionApprovalCard 呈现，并在 bot 继续之前等待你的手动批准。
• 共享 – 你可以通过私有 Tailscale/WireGuard 网格（gawkbot share）或创建一次性 URL 的公共 Cloudflare 隧道邀请队友。
• 持久化 – Bot 状态、转录和“公司大脑”以纯文件形式存储在 ~/.wuphf/ 下，因此你可以检查或删除它们（gawkbot shred）。

主要功能

功能	你获得的内容
应用 UI	显示 bot 工作区、工具、数据表和知识页面的真实屏幕。
Routines	类似 Cron 的计划、版本化提示、每次运行的转录。
工具	你教给 bot 的自定义操作（例如，“给潜在客户打分”）。
知识	带有每个声明内联引用的 Wiki 风格页面。
集成	1,200+ 预构建连接器；你连接一次，所有 bot 共享它们。
审批门	每个外部写入都需要点击；你看到成本、令牌和运行次数。
多工作区	你可以列出、切换或共享的隔离工作区。
本地优先	在你的硬件上运行，使用你的 API 密钥；可选遥测默认关闭。

开始使用

1. 从 gawk.bot/download.html 或 GitHub releases 安装 macOS 应用。
2. 首次启动时验证你的运行时并登录 LLM CLI（Claude Code 是默认）。
3. 描述你的第一个工作流程；观看实时构建反馈。
4. 通过刘海或 iPhone 应用（apps/ios）进行交互。

从源码安装（需要 Go 1.25+ 和 Bun 用于 Web UI）：

git clone https://github.com/najmuzzaman-mohammad/gawkbot.git
cd gawkbot/web && bun install && bun run build && cd ..
go build -o gawkbot ./cmd/wuphf
./gawkbot

配置标志 – 例如，--provider ollama 使用本地 Ollama 模型，--no-open 抑制自动打开浏览器，--unsafe 用于仅开发权限绕过。

隐私 – 可选的匿名分析和会话录制默认禁用，除非你设置 PostHog 密钥。所有数据本地存储；bot 环境中不存储任何密钥。

为什么重要 – gawkbot 为你提供与商业服务（例如，xAI 的 Grok Bot）相同的“常驻”助手体验，但 自托管、免费，并且每个操作都有明确的人工批准。它是个人 AI 代理编排的一个具体示例，可以与你控制的任何 LLM 扩展。