← Back to Skills Marketplace

RaspAP

Name: RaspAP
Author: naamah75

by Yngvarr_75 · GitHub ↗ · v0.1.1 · MIT-0

cross-platform ✓ Security Clean

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install raspap

Description

Query and troubleshoot a RaspAP access point via its local REST API.

README (SKILL.md)

RaspAP

Use for RaspAP access point status and diagnostics via the experimental local REST API.

Configuration

Default RestAPI port: 8081
RaspAP RestAPI auth header: access_token
Environment variables:
- RASPAP_HOST: RaspAP host or IP address
- RASPAP_PORT: RestAPI port, defaults to 8081
- RASPAP_API_KEY: API key value
- RASPAP_KEY_FILE: file containing the API key

Never print the API key. Prefer RASPAP_API_KEY or RASPAP_KEY_FILE.

Igor's local instance currently uses:

export RASPAP_HOST=10.0.0.235
export RASPAP_KEY_FILE=/home/igor/RaspAp.txt

Safety

Default to read-only checks. Ask before restart/reload actions or any change that could interrupt Wi-Fi, DHCP, DNS, routing, firewall, OpenVPN, or WireGuard service.

Helper

Use the bundled helper for API reads:

skills/raspap/scripts/raspap-api system
skills/raspap/scripts/raspap-api clients
skills/raspap/scripts/raspap-api clients/wlan0
skills/raspap/scripts/raspap-api dhcp
skills/raspap/scripts/raspap-api dns/logs

The helper accepts an endpoint without a leading slash and emits JSON. By default it redacts JSON fields whose names look secret-sensitive, such as passphrases, keys, certs, tokens, and passwords. Set RASPAP_RAW=1 only when the user explicitly needs raw output.

Do not fetch /openvpn/{config}, /ap, or other raw config endpoints without thinking about redaction. They may contain Wi-Fi passphrases, certificates, private keys, static keys, credentials, or auth file names. If config inspection is unavoidable, summarize only non-secret fields such as remote, proto, dev, cipher, SSID, channel, and active config names.

Useful Endpoints

Observed on 2026-06-02 from /openapi.json:

/system
/ap
/clients
/clients/{wireless_interface}
/dhcp
/dns/domains
/dns/hostnames
/dns/logs
/dns/upstream
/ddns
/firewall
/networking
/openvpn
/openvpn/{config}
/wireguard

Troubleshooting

If :8081 is closed, check restapi.service on the Raspberry Pi. A systemd status of 217/USER usually means the unit's User= does not exist; change it to a real local user, then run sudo systemctl daemon-reload and restart the service.

Usage Guidance

Install this only if you administer the RaspAP device you intend to query. Keep the API key private, review any raw configuration output before sharing it, and approve disruptive actions such as Wi-Fi, DHCP, DNS, firewall, VPN, reload, or restart changes only when you explicitly intend them.

Capability Tags

requires-sensitive-credentials

Capability Assessment

✓ Purpose & Capability

The artifact's purpose is to query and troubleshoot a RaspAP access point through its local REST API, and the documented endpoints, API key handling, and safety notes fit that purpose.

✓ Instruction Scope

Instructions default to read-only checks, prohibit printing the API key, redact secret-looking JSON fields by default, and require user approval before service restarts or network-impacting changes.

ℹ Install Mechanism

The supplied artifact is markdown-only with no executable install hook or dependency payload; it references a bundled helper script path that is not present in the inspected artifact, which is a completeness issue rather than evidence of hidden behavior.

ℹ Credentials

Use of a RaspAP host and API key is sensitive because it can expose or administer network configuration, but that access is expected for the stated local-admin troubleshooting purpose and is disclosed.

✓ Persistence & Privilege

No persistence, background execution, privilege escalation, broad local indexing, or automatic mutation behavior was found in the artifact.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install raspap
After installation, invoke the skill by name or use /raspap
Provide required inputs per the skill's parameter spec and get structured output

Version History

v0.1.1

Redact sensitive JSON fields by default and document raw config safety caveats.

v0.1.0

Initial read-only RaspAP REST API helper skill.

Metadata

Slug raspap

Version 0.1.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 2

Frequently Asked Questions

What is RaspAP?

Query and troubleshoot a RaspAP access point via its local REST API. It is an AI Agent Skill for Claude Code / OpenClaw, with 41 downloads so far.

How do I install RaspAP?

Run "/install raspap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is RaspAP free?

Yes, RaspAP is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does RaspAP support?

RaspAP is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created RaspAP?

It is built and maintained by Yngvarr_75 (@naamah75); the current version is v0.1.1.

More Skills

RaspAP

RaspAP

Configuration

Safety

Helper

Useful Endpoints

Troubleshooting

What is RaspAP?

How do I install RaspAP?

Is RaspAP free?

Which platforms does RaspAP support?

Who created RaspAP?

💬 Comments