Amber-Hunter 集成

Amber-Hunter 是一个本地感知引擎，将你的 OpenClaw 协作会话冻结为可搜索的个人记忆。

Amber-Hunter 在你的 Mac 上运行，持续监控 OpenClaw 会话。当你准备冻结"此刻"时，它会捕获对话上下文、最近的文件更改，并将所有内容存储在加密的本地胶囊中。

🎯 核心功能（v0.8.7）

功能	说明
会话捕获	读取 OpenClaw 会话记录，提取用户/助手对话
文件监控	自动追踪工作区最近修改的文件
瞬间冻结	`Cmd+Shift+F` 捕获"我正在做什么"
主动记忆捕获	自动检测重要时刻（纠正/决策/发现）
主动回忆	AI 响应前自动搜索相关记忆
本地加密	AES-256-GCM，主密码存系统密钥链
云端同步	加密后上传到 huper.org（可选）
跨平台	macOS / Linux / Windows

📦 系统要求

要求	说明
操作系统	macOS 10.15+
Python	3.10+
OpenClaw	已安装并配置
网络	本地服务（可选云端）

🚀 快速安装

第一步：克隆仓库

bash

git clone https://github.com/ankechenlab-node/amber_hunter.git
cd amber_hunter

第二步：安装依赖

bash

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

依赖列表：

txt

fastapi==0.115.0
uvicorn[standard]==0.30.0
pydantic==2.9.0
cryptography==43.0.0
httpx==0.27.0
mac-keychain==0.3.0

第三步：配置

bash

# 创建配置目录
mkdir -p ~/.amber-hunter

# 创建配置文件
cat > ~/.amber-hunter/config.json << 'EOF'
{
  "api_key": "your-huper-org-api-key",
  "master_password": "your-local-encryption-password"
}
EOF

获取 API Key：

访问 huper.org/dashboard
登录 → API Key 标签页
生成新密钥
复制到 config.json

第四步：启动服务

bash

# 后台启动
python3 amber_hunter.py &

# 或使用 LaunchAgent 自动启动
cp com.huper.amber-hunter.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.huper.amber-hunter.plist

🔧 使用方式

方式 1：通过浏览器冻结

打开 huper.org
点击"冻结当下"按钮
Amber-Hunter 自动预填充当前会话上下文

方式 2：通过 API 冻结

bash

# 检查服务状态
curl http://localhost:18998/status

# 获取会话摘要
curl http://localhost:18998/session/summary

# 获取最近修改的文件
curl http://localhost:18998/session/files

# 触发冻结（返回预填充数据）
curl -X POST http://localhost:18998/freeze

# 列出本地胶囊
curl http://localhost:18998/capsules

# 创建胶囊
curl -X POST http://localhost:18998/capsules \
  -H "Content-Type: application/json" \
  -d '{"memo":"架构评审","content":"讨论了模块结构...","tags":"design,review"}'

📡 API 参考

服务端点

端点	方法	说明
`/status`	GET	服务状态、会话信息
`/session/summary`	GET	OpenClaw 对话摘要
`/session/files`	GET	最近修改的工作区文件
`/freeze`	POST	触发冻结，返回预填充数据
`/capsules`	GET	列出本地胶囊
`/capsules`	POST	创建胶囊

响应示例

GET /status:

json

{
  "status": "running",
  "session_id": "abc123",
  "last_capture": "2026-03-22T04:30:00Z"
}

GET /session/summary:

json

{
  "summary": "讨论了 Huper 部署方案...",
  "messages_count": 15,
  "files_modified": 3
}

🔒 安全机制

本地加密

层级	说明
主密码	存储在 macOS Keychain，永不传输
胶囊加密	AES-256-GCM 加密后存储
API Key	仅用于 huper.org 认证，不用于加密
本地优先	完全离线工作，无需云端

云端同步（可选）

本地胶囊 → AES-256 加密 → 上传到 huper.org
                          ↓
                    分布式存储（计划）

🎯 使用场景

场景 1：开发记录

正在调试一个奇怪的报错
    ↓
Cmd+Shift+A 冻结
    ↓
保存：报错信息 + 当时打开的文件 + 终端命令
    ↓
以后搜索"那个奇怪报错"即可找到

场景 2：会议记录

与 AI 讨论架构设计
    ↓
会话结束前触发冻结
    ↓
保存：对话摘要 + 修改的文件 + 决策要点
    ↓
以后可按标签检索

场景 3：灵感捕捉

突然想到一个好点子
    ↓
快速冻结当前上下文
    ↓
保存：想法 + 相关文件 + 参考链接
    ↓
语义搜索即可找到

🐛 故障排查

Q: 服务启动失败

A: 检查端口占用：

bash

lsof -i :18998
# 如果占用，修改 amber_hunter.py 中的端口

Q: 无法读取 OpenClaw 会话

A: 检查权限：

bash

# 确保可以访问 ~/.openclaw/workspace/
ls -la ~/.openclaw/workspace/

Q: 加密失败

A: 检查 Keychain 访问：

bash

#  macOS 允许访问 Keychain
# 系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能

📚 相关资源

资源	说明
GitHub 仓库	源代码
Huper 琥珀	官方网站
OpenClaw	AI 协作平台

🚀 版本历史

版本	功能	日期
v0.8.4	安全修复（加密/认证/CORS）	2026-03-22
v0.8.3	浏览器冻结 + Raycast	2026-03-22
v0.8.2	性能优化	2026-03-21
v0.8.1	Bug 修复	2026-03-21
v0.8.0	本地加密 + 云端同步	2026-03-21
v0.5.0	首版发布	2026-03-21

查看完整更新日志

提示：Amber-Hunter 是 Huper 琥珀的 OpenClaw 集成技能，需要配合使用才能获得完整体验。 ��要配合使用才能获得完整体验。 �� | | v0.4 | 云端同步 | 🔄 进行中 | | v1.0 | 分布式存储 | ⏳ 计划 |

提示：Amber-Hunter 是 Huper 琥珀的 OpenClaw 集成技能，需要配合使用才能获得完整体验。

Amber-Hunter 集成 ​

🎯 核心功能（v0.8.7） ​

📦 系统要求 ​

🚀 快速安装 ​

第一步：克隆仓库 ​

第二步：安装依赖 ​

第三步：配置 ​

第四步：启动服务 ​

🔧 使用方式 ​

方式 1：通过浏览器冻结 ​

方式 2：通过 API 冻结 ​

📡 API 参考 ​

服务端点 ​

响应示例 ​

🔒 安全机制 ​

本地加密 ​

云端同步（可选） ​

🎯 使用场景 ​

场景 1：开发记录 ​

场景 2：会议记录 ​

场景 3：灵感捕捉 ​

🐛 故障排查 ​

Q: 服务启动失败 ​

Q: 无法读取 OpenClaw 会话 ​

Q: 加密失败 ​

📚 相关资源 ​

🚀 版本历史 ​

Amber-Hunter 集成

🎯 核心功能（v0.8.7）

📦 系统要求

🚀 快速安装

第一步：克隆仓库

第二步：安装依赖

第三步：配置

第四步：启动服务

🔧 使用方式

方式 1：通过浏览器冻结

方式 2：通过 API 冻结

📡 API 参考

服务端点

响应示例

🔒 安全机制

本地加密

云端同步（可选）

🎯 使用场景

场景 1：开发记录

场景 2：会议记录

场景 3：灵感捕捉

🐛 故障排查

Q: 服务启动失败

Q: 无法读取 OpenClaw 会话

Q: 加密失败

📚 相关资源

🚀 版本历史