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

0 阅读3分钟

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


截图

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

功能特性

  • 常驻浮层 — 透明窗口,始终置顶,显示在所有 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 可能会弹出以下错误:

cannot-be-open.jpg

方法一:移除隔离属性(推荐)

打开终端,执行:

sudo xattr -r -d com.apple.quarantine /Applications/Talon.app

之后正常启动 Talon 即可。

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

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

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


初次使用配置

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

连接设置转存失败,建议直接上传图片文件

  1. 填写 Gateway URL — 默认为 ws://localhost:18789,如果 OpenClaw 部署在其他机器,填写对应的地址。
  2. 填写 Gateway Token — OpenClaw 的认证 Token。
  3. 点击 Save Changes
  4. 在部署了 OpenClaw 的机器上执行设备授权:
    openclaw devices approve
    
  5. 重启 Talon — 重启后将自动完成连接。

使用说明

操作方式
显示 / 隐藏窗口点击菜单栏 Talon 图标
发送消息在输入框输入后按 Enter
展开完整聊天记录点击气泡右上角展开图标(↗)
切换 Agent 会话设置 → Agents → 点击对应会话的 Switch
新建 Agent 会话设置 → Agents → New Agent
删除 Agent 会话设置 → Agents → 选中会话 → Delete

技术栈

层级技术
前端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 + 插件:


贡献

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