ClawHeart
使用指南 · 13 步上手

从零开始,把 ClawHeart 跑起来

这是一份面向新手的操作向导。5 个章节、13 张截图、按顺序往下滑就能跑通 Agent 接入到监控告警的完整链路。

Ch.01 · 第 1 章

入门首次启动,认识主页全景

STEP 01

选择监控模式

三档可选,默认推荐「端点映射」

首次启动会进入引导页,选择你的监控强度档位。

「端点映射」是零侵入的应用层方案,几乎所有用户都用它。后两档(系统代理 / 沙箱隔离)属于进阶可选,可以之后在「监控模式」页随时切换。

  • tier1 端点映射 = 修改 Agent 的 BASE_URL 指向 ClawHeart
  • tier2 系统代理 = MITM 覆盖所有遵循系统代理的进程
  • tier3 沙箱隔离 = 内核级强制,绕不开
选择监控模式
STEP 02

主页全景

一张图认识 7 大工具入口

进入主页,顶部是 Hero 防御动画(展示 8 层防御实时拦截),底部一排 7 个工具卡片,覆盖 Agent 发现、监控、扫描、技能、用量、设置等全部入口。

建议把主页当作 dashboard:从这里直接点进任意工具,所有动作都有面包屑可回退。

主页全景
end of Ch.01
Ch.02 · 第 2 章

配置把 Agent 和渠道接进来

STEP 03

Agent 发现页

本机所有 AI 工具一览

首页第一个卡片「Agent 发现」点进来,顶部是 tab 切换不同 Agent(Claude Code / Codex / Cursor / OpenClaw / Hermes …),下方是当前 Agent 已分配的渠道列表。

右上的「可导入」徽标表示该 Agent 的本地配置可以被反向解析,一键导入历史渠道。

Agent 发现页
STEP 04

反向导入历史配置

从配置文件里把渠道扒出来

「从配置导入」按钮会弹出候选列表,逐条展示当前 Agent 配置文件里识别到的 provider、base_url、key 状态。

如果该 Agent 走的是账号登录模式(无原生 API key),弹窗顶部会有黄色 warning 明确告诉你「本机没有可用 key」。直接 OK 跳过即可。

  • OpenClaw / Codex / Gemini 已支持反向导入
  • 勾选后会批量入库到「模型渠道」并自动分配给当前 Agent
反向导入历史配置
STEP 05

手动新增渠道

65 个内置预设 + 自定义

如果反向导入扫不到,或想新增第三方中转,点「新建」打开新增渠道弹窗:上半部分是 65 个常见上游预设网格(点一下自动填 base_url / 协议),下半部分是手填表单。

API key 填进去会立刻写入系统 Keychain,数据库里只留掩码。

手动新增渠道
end of Ch.02
Ch.03 · 第 3 章

使用一键托管,随时回滚

STEP 06

开启托管

把 Agent 的出站请求切到 ClawHeart

选好一个渠道后,打开工具栏的「托管」开关。ClawHeart 会改写当前 Agent 的 config(base_url 改成 127.0.0.1:19112),所有请求开始走 ClawHeart 网关。

开关变绿、状态指示灯亮起就代表生效。重启 Agent 即可。

  • 切换前会自动备份原 config
  • 凭据替换成虚拟 key `sk-claw-xxx`,原始 key 永远不出 Keychain
开启托管
STEP 07

托管历史与回滚

每次变更都可追溯

工具栏点「托管历史」打开右侧抽屉,列出该 Agent 的所有托管变更:时间 / 修改前 / 修改后 / 回滚按钮。

任何一次变更都可以一键还原成那一时刻的 config 状态,原子操作不会留下半完成状态。

托管历史与回滚
end of Ch.03
Ch.04 · 第 4 章

核心功能监控 / 扫描 / 计费 / 技能

STEP 08

实时监控

看到每一次 Agent 调用

实时监控页左侧是请求流(按时间线展开),右侧是拦截事件 / Token 用量。点任意一条可以展开 payload、归一化结果、命中的规则。

所有数据落本机 SQLite,关掉应用再打开依然完整。

实时监控
STEP 09

80 项安全审计

离线扫描,零 LLM 依赖

扫描页跑 8 大类目共 80+ 检查项:文件权限 · 凭据泄漏 · MCP 配置 · Agent 行为 · 技能供应链 · 进程白名单 · 网络出口 · 注册表 / Keychain。

结果按严重程度分组,点开任一项查看证据链和建议修复操作。

80 项安全审计
STEP 10

用量统计

Token 消耗一目了然

用量页按 Agent / Provider / 模型分组展示 Token 消耗,每行带 sparkline 趋势。可以快速发现哪个工具或模型在烧钱。

支持设置预算阈值,超额时 fail-closed 自动断流。

用量统计
STEP 11

技能管理

SkillGuard 给本机 skills 打分

通配扫描 `~/.<agent>/skills/`,跑 SkillGuard 规则集对每个技能打分(命令执行 / 网络出口 / 文件访问 / 凭据泄漏)。

页面支持一键打包导出、备份、对比历史评分变化。

技能管理
end of Ch.04
Ch.05 · 第 5 章

进阶切档与个性化

STEP 12

切换监控模式

三档对比页,按需切换

「监控模式」页把 tier1 / tier2 / tier3 横向并列,清楚标注每档的覆盖范围、安装步骤、是否需要 CA 证书。

切档原子操作,旧档配置自动卸载,新档自动安装。

切换监控模式
STEP 13

设置页综合

语言 · 安全 · 高级 一站搞定

10 种语言切换、规则集开关 / 自定义、日志保留策略、备份与恢复、引导页重放,全部在设置页搞定。

敏感操作(删除全部数据 / 重置等)都有二次确认弹窗。

设置页综合
end of Ch.05

13 步走完,你已经掌握了 ClawHeart 的全部核心

遇到问题?打开「设置 → 引导页重放」可以从头再走一遍。也可以到 GitHub 提 issue 或参考完整文档。

使用指南 · ClawHeart Desktop