← 返回 Skills 市场
naamah75

RaspAP

作者 Yngvarr_75 · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ✓ 安全检测通过
41
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install raspap
功能描述
Query and troubleshoot a RaspAP access point via its local REST API.
使用说明 (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.

安全使用建议
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.
能力标签
requires-sensitive-credentials
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install raspap
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /raspap 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug raspap
版本 0.1.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

RaspAP 是什么?

Query and troubleshoot a RaspAP access point via its local REST API. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 41 次。

如何安装 RaspAP?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install raspap」即可一键安装,无需额外配置。

RaspAP 是免费的吗?

是的,RaspAP 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

RaspAP 支持哪些平台?

RaspAP 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 RaspAP?

由 Yngvarr_75(@naamah75)开发并维护,当前版本 v0.1.1。

💬 留言讨论