做了一个代理 OpenClaw 常驻菜单栏的浮动 AI 助手

查看 15|回复 0
作者:yanceyofficial   
Talon 是一款常驻 macOS 菜单栏的浮动 AI 助手,基于 OpenClaw 网关驱动。它悬浮在所有桌面 Space 的右下角,支持同时管理多个 AI Agent 会话,并在后台会话有新消息时自动切换和推送通知。
GITHUB: https://github.com/YanceyOfficial/talon
功能特性
  • 常驻浮层 — 透明窗口,始终置顶,显示在所有 macOS Space 上
  • 动态 Avatar — 基于 Lottie 的动画,含空闲 / 思考 / 回复 / 报错多种状态
  • 完整聊天记录 — 可展开的独立窗口,支持 Markdown 、KaTeX 数学公式、代码高亮
  • 多 Agent 会话 — 创建专属任务会话(如「 A 股早报」「邮件监控」),互相隔离
  • 自动切换 — 每 10 秒轮询,有新回复的会话自动切换到前台
  • 桌面通知 — 后台会话收到新消息时推送系统通知
  • 工具调用可见 — 在聊天记录中完整展示每一次工具调用与返回结果
  • 隐私优先 — 所有数据通过 Tauri Store 本地存储,需自行部署 OpenClaw 网关

    前置条件
    Talon 是 OpenClaw AI 网关的桌面客户端,使用前需要先在本机(或可访问的远端机器)运行 OpenClaw 。
    安装 OpenClaw
    curl -fsSL https://openclaw.ai/install.sh | bash
    或访问 openclaw.ai 查看其他安装方式。
    启动 OpenClaw 网关
    openclaw gateway
    默认在 ws://localhost:18789 启动 WebSocket 服务。
    安装 Talon
    直接下载(推荐)
    在 Releases 页面下载最新的 .dmg 文件,打开后将 Talon 拖入「应用程序」文件夹即可。
    从源码构建
    环境要求:Rust 工具链、Node.js ≥ 18 、pnpm
    # 安装依赖
    pnpm install
    # 开发模式(热更新)
    pnpm tauri dev
    # 打包正式版 → src-tauri/target/release/bundle/
    pnpm tauri build
    macOS 提示「已损坏,无法打开」
    由于 Talon 尚未通过 Apple 开发者证书签名,下载后 macOS Gatekeeper 可能会弹出无法打开的错误:
    方法一:移除隔离属性(推荐)
    打开终端,执行:
    sudo xattr -r -d com.apple.quarantine /Applications/Talon.app
    之后正常启动 Talon 即可。
    方法二:通过系统设置放行
    [ol]
  • 尝试打开 Talon ,macOS 会拦截并弹出提示。
  • 打开系统设置 → 隐私与安全性
  • 在「安全性」区域找到 Talon 的拦截记录,点击「仍要打开」
  • 在弹出的确认框中再次确认。
    [/ol]

    macOS Sequoia ( 15+)可能不显示「仍要打开」按钮,请使用方法一。

    初次使用配置
    点击主面板右上角的齿轮图标,或右键菜单栏图标选择「 Settings 」,进入设置窗口,切换到 Connection 标签页。
    [ol]
  • 填写 Gateway URL — 默认为 ws://localhost:18789,如果 OpenClaw 部署在其他机器,填写对应的地址。
  • 填写 Gateway Token — OpenClaw 的认证 Token 。
  • 点击 Save Changes

  • 在部署了 OpenClaw 的机器上执行设备授权:openclaw devices approve
  • 重启 Talon — 重启后将自动完成连接。
    [/ol]
    使用说明
    [td]操作[/td]
    [td]方式[/td]
    显示 / 隐藏窗口
    点击菜单栏 Talon 图标
    发送消息
    在输入框输入后按 Enter
    展开完整聊天记录
    点击气泡右上角展开图标(↗)
    切换 Agent 会话
    设置 → Agents → 点击对应会话的 Switch
    新建 Agent 会话
    设置 → Agents → New Agent
    删除 Agent 会话
    设置 → Agents → 选中会话 → Delete
    技术栈
    [td]层级[/td]
    [td]技术[/td]
    前端
    React 19 + TypeScript + Vite
    桌面壳
    Tauri 2.0 ( Rust )
    样式
    Tailwind CSS 4.x + shadcn/ui ( Radix UI )
    动画
    DotLottie
    AI 后端
    OpenClaw WebSocket 网关
    认证
    Ed25519 密钥对签名
    持久化
    @tauri-apps/plugin-store
    开发命令
    pnpm dev            # 仅启动 Vite 开发服务器
    pnpm tauri dev      # Tauri + Vite 完整开发模式(含热更新)
    pnpm build          # 构建前端
    pnpm tauri build    # 打包 .app / .dmg
    pnpm format         # Prettier 格式化(含 import 排序和 Tailwind class 排序)
    pnpm lint           # ESLint + TypeScript 检查
    推荐开发环境
    VS Code + 插件:
  • Tauri
  • rust-analyzer
  • 您需要登录后才可以回帖 登录 | 立即注册

    返回顶部