Amber-Hunter Skill
> Local memory engine for Huper琥珀
by ankechenlab-node · published 2026-04-01
$ claw add gh:ankechenlab-node/ankechenlab-node-amber-hunter# Amber-Hunter Skill
> Local memory engine for Huper琥珀
> Version: 0.9.6 | 2026-03-28
---
> amber-hunter runs on the user's local machine (Mac / Linux / Windows). Agents communicate with it via `localhost:18998`.
---
What It Does
Amber-Hunter is the **capture layer** of Huper琥珀 — free, open-source, and zero-barrier. It lets users experience "freeze this moment" AI collaboration memory with no account required.
---
Core Features
---
API Endpoints (v0.9.6)
| Endpoint | Method | Auth | Description |
|----------|--------|------|-------------|
| `/status` | GET | none | Service status |
| `/memories` | GET | **none** | Local memory snapshot (localhost only) |
| `/token` | GET | localhost | Get local API key |
| `/session/summary` | GET | none | OpenClaw/Claude session summary |
| `/session/files` | GET | none | Recent workspace files |
| `/freeze` | GET/POST | Bearer or ?token= | Trigger freeze |
| `/capsules` | GET | Bearer | List local capsules |
| `/capsules` | POST | Bearer | Create capsule |
| `/capsules/{id}` | GET | Bearer | Read capsule |
| `/capsules/{id}` | DELETE | Bearer | Delete capsule |
| `/recall` | GET | Bearer or ?token= | Retrieve relevant memories (`?q=<query>&limit=3`) |
| `/classify` | GET/POST | Bearer or ?token= | Topic classification (16 topics, vector-tuned) |
| `/sync` | GET | Bearer or ?token= | Cloud sync (requires account) |
| `/config` | GET/POST | Bearer or ?token= | Read/set config (incl. auto_sync) |
| `/master-password` | POST | localhost | Set master_password |
| `/bind-apikey` | POST | localhost | Update Huper cloud API key in config.json |
---
Authentication
Bearer Header (server-to-server)
Authorization: Bearer <api_key>Query Parameter (browser cross-origin compatible)
GET /freeze?token=<api_key>
GET /sync?token=<api_key>
GET /recall?token=<api_key>&q=your+query> Note: Browsers block `Authorization` headers on HTTPS→HTTP localhost requests, so the frontend uses query parameters instead.
---
Installation
Platform Support
| Platform | Auto-start | Keychain |
|----------|-----------|---------|
| **macOS** | LaunchAgent (launchctl) | macOS Keychain |
| **Linux** | systemd user service | GNOME Keyring (secret-tool) |
| **Windows** | Task Scheduler (schtasks) | Windows Credential Manager |
Prerequisites
Quick Install (run on the user's local machine)
bash ~/.openclaw/skills/amber-hunter/install.shManual Install
# 1. Install dependencies
pip install -r ~/.openclaw/skills/amber-hunter/requirements.txt
# 2. Start service (no account needed)
python3 ~/.openclaw/skills/amber-hunter/amber_hunter.py &
# 3. Verify
curl http://localhost:18998/status
curl http://localhost:18998/memories---
Auto-start
`install.sh` configures this automatically.
| Platform | Command |
|----------|---------|
| macOS | `launchctl load ~/Library/LaunchAgents/com.huper.amber-hunter.plist` |
| Linux | `systemctl --user start amber-hunter` |
| Windows | Task Scheduler entry created automatically at login |
---
Config & Storage
---
Usage
No account (immediate use)
# View local memories
curl http://localhost:18998/memories
# Active recall — retrieve relevant past memories
curl "http://localhost:18998/recall?token=<api_key>&q=what+did+we+decide+about+auth"
# Get API token for OpenClaw/Claude integration
curl http://localhost:18998/tokenOptional: register huper.org for cloud sync
1. Go to https://huper.org and create an account
2. Get your API key from the dashboard, add it to `~/.amber-hunter/config.json`
3. Set a master_password (local encryption key — never uploaded)
4. Enable cloud sync to access memories across devices
---
Troubleshooting
amber-hunter not connecting
curl http://localhost:18998/status
python3 ~/.openclaw/skills/amber-hunter/amber_hunter.py &
tail -f ~/.amber-hunter/amber-hunter.logLinux: secret-tool not installed
# Ubuntu/Debian
sudo apt install libsecret-tools
# Fedora
sudo dnf install libsecret
# Arch
sudo pacman -S libsecret---
Version History
---
*Built with 🔒 by [Anke Chen](https://github.com/ankechenlab-node) for the [Huper琥珀](https://huper.org) ecosystem.*
More tools from the same signal band
Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).
Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.
The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...