从零开始,把 ClawHeart 跑起来
这是一份面向新手的操作向导。5 个章节、13 张截图、按顺序往下滑就能跑通 Agent 接入到监控告警的完整链路。
入门首次启动,认识主页全景
选择监控模式
首次启动会进入引导页,选择你的监控强度档位。
「端点映射」是零侵入的应用层方案,几乎所有用户都用它。后两档(系统代理 / 沙箱隔离)属于进阶可选,可以之后在「监控模式」页随时切换。
- tier1 端点映射 = 修改 Agent 的 BASE_URL 指向 ClawHeart
- tier2 系统代理 = MITM 覆盖所有遵循系统代理的进程
- tier3 沙箱隔离 = 内核级强制,绕不开

主页全景
进入主页,顶部是 Hero 防御动画(展示 8 层防御实时拦截),底部一排 7 个工具卡片,覆盖 Agent 发现、监控、扫描、技能、用量、设置等全部入口。
建议把主页当作 dashboard:从这里直接点进任意工具,所有动作都有面包屑可回退。

配置把 Agent 和渠道接进来
Agent 发现页
首页第一个卡片「Agent 发现」点进来,顶部是 tab 切换不同 Agent(Claude Code / Codex / Cursor / OpenClaw / Hermes …),下方是当前 Agent 已分配的渠道列表。
右上的「可导入」徽标表示该 Agent 的本地配置可以被反向解析,一键导入历史渠道。

反向导入历史配置
「从配置导入」按钮会弹出候选列表,逐条展示当前 Agent 配置文件里识别到的 provider、base_url、key 状态。
如果该 Agent 走的是账号登录模式(无原生 API key),弹窗顶部会有黄色 warning 明确告诉你「本机没有可用 key」。直接 OK 跳过即可。
- OpenClaw / Codex / Gemini 已支持反向导入
- 勾选后会批量入库到「模型渠道」并自动分配给当前 Agent

手动新增渠道
如果反向导入扫不到,或想新增第三方中转,点「新建」打开新增渠道弹窗:上半部分是 65 个常见上游预设网格(点一下自动填 base_url / 协议),下半部分是手填表单。
API key 填进去会立刻写入系统 Keychain,数据库里只留掩码。

使用一键托管,随时回滚
开启托管
选好一个渠道后,打开工具栏的「托管」开关。ClawHeart 会改写当前 Agent 的 config(base_url 改成 127.0.0.1:19112),所有请求开始走 ClawHeart 网关。
开关变绿、状态指示灯亮起就代表生效。重启 Agent 即可。
- 切换前会自动备份原 config
- 凭据替换成虚拟 key `sk-claw-xxx`,原始 key 永远不出 Keychain

托管历史与回滚
工具栏点「托管历史」打开右侧抽屉,列出该 Agent 的所有托管变更:时间 / 修改前 / 修改后 / 回滚按钮。
任何一次变更都可以一键还原成那一时刻的 config 状态,原子操作不会留下半完成状态。

核心功能监控 / 扫描 / 计费 / 技能
实时监控
实时监控页左侧是请求流(按时间线展开),右侧是拦截事件 / Token 用量。点任意一条可以展开 payload、归一化结果、命中的规则。
所有数据落本机 SQLite,关掉应用再打开依然完整。

80 项安全审计
扫描页跑 8 大类目共 80+ 检查项:文件权限 · 凭据泄漏 · MCP 配置 · Agent 行为 · 技能供应链 · 进程白名单 · 网络出口 · 注册表 / Keychain。
结果按严重程度分组,点开任一项查看证据链和建议修复操作。

用量统计
用量页按 Agent / Provider / 模型分组展示 Token 消耗,每行带 sparkline 趋势。可以快速发现哪个工具或模型在烧钱。
支持设置预算阈值,超额时 fail-closed 自动断流。

技能管理
通配扫描 `~/.<agent>/skills/`,跑 SkillGuard 规则集对每个技能打分(命令执行 / 网络出口 / 文件访问 / 凭据泄漏)。
页面支持一键打包导出、备份、对比历史评分变化。

进阶切档与个性化
切换监控模式
「监控模式」页把 tier1 / tier2 / tier3 横向并列,清楚标注每档的覆盖范围、安装步骤、是否需要 CA 证书。
切档原子操作,旧档配置自动卸载,新档自动安装。

设置页综合
10 种语言切换、规则集开关 / 自定义、日志保留策略、备份与恢复、引导页重放,全部在设置页搞定。
敏感操作(删除全部数据 / 重置等)都有二次确认弹窗。

13 步走完,你已经掌握了 ClawHeart 的全部核心
遇到问题?打开「设置 → 引导页重放」可以从头再走一遍。也可以到 GitHub 提 issue 或参考完整文档。