Talon — 基于 OpenClaw 网关驱动的 AI 助手

Talon 是一款常驻 macOS 菜单栏的浮动 AI 助手，基于 OpenClaw 网关驱动。它悬浮在所有桌面 Space 的右下角，支持同时管理多个 AI Agent 会话，并在后台会话有新消息时自动切换和推送通知。

截图

主面板	完整聊天记录	多 Agent 管理
悬浮在桌面右下角的紧凑窗口	富文本、工具调用追踪与 Token 统计	管理并切换多个 Agent 会话

功能特性

• 常驻浮层 — 透明窗口，始终置顶，显示在所有 macOS Space 上
• 动态 Avatar — 基于 Lottie 的动画，含空闲 / 思考 / 回复 / 报错多种状态
• 完整聊天记录 — 可展开的独立窗口，支持 Markdown、KaTeX 数学公式、代码高亮
• 多 Agent 会话 — 创建专属任务会话（如「A 股早报」「邮件监控」），互相隔离
• 自动切换 — 每 10 秒轮询，有新回复的会话自动切换到前台
• 桌面通知 — 后台会话收到新消息时推送系统通知
• 工具调用可见 — 在聊天记录中完整展示每一次工具调用与返回结果
• 隐私优先 — 所有数据通过 Tauri Store 本地存储，需自行部署 OpenClaw 网关

前置条件

Talon 是 OpenClaw AI 网关的桌面客户端，使用前需要先在本机（或可访问的远端机器）运行 OpenClaw。

安装 OpenClaw

curl -fsSL  | 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 即可。

方法二：通过系统设置放行

1. 尝试打开 Talon，macOS 会拦截并弹出提示。
2. 打开系统设置 → 隐私与安全性。
3. 在「安全性」区域找到 Talon 的拦截记录，点击**「仍要打开」**。
4. 在弹出的确认框中再次确认。

初次使用配置

点击主面板右上角的齿轮图标，或右键菜单栏图标选择「Settings」，进入设置窗口，切换到 Connection 标签页。

1. 填写 Gateway URL — 默认为 ws://localhost:18789，如果 OpenClaw 部署在其他机器，填写对应的地址。
2. 填写 Gateway Token — OpenClaw 的认证 Token。
3. 点击 Save Changes。
4. 在部署了 OpenClaw 的机器上执行设备授权：

   openclaw devices approve
   

5. 重启 Talon — 重启后将自动完成连接。

使用说明

技术栈

开发命令

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

贡献

欢迎提交 Issue 和 Pull Request！详见 CONTRIBUTING.md。