← Back to Skills Marketplace
Openclaw Sage
by
alfonso46674
· GitHub ↗
· v0.3.1
· MIT-0
477
Downloads
0
Stars
3
Active Installs
6
Versions
Install in OpenClaw
/install openclaw-sage
Description
OpenClaw documentation expert — answers user questions about OpenClaw setup, configuration, providers, troubleshooting, and what's new using live doc fetchin...
Usage Guidance
This skill appears to do what it claims: fetch and index OpenClaw docs and serve them from a local cache. Before installing, review scripts/lib.sh (the shared helper) to confirm fetch_markdown/check_online behavior and the exact URLs used for network requests. Be aware that running build-index.sh fetch will download many docs from GitHub/docs.openclaw.ai (potentially large). No credentials are needed, but if you set OPENCLAW_SAGE_SOURCE=local:/path the skill will read a local repo path (so don't point it at sensitive directories). If you require tighter controls, run the skill in a sandboxed environment or inspect/limit its network access.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-sage
Version: 0.3.1
The openclaw-sage skill is a documentation assistant designed to fetch, index, and search OpenClaw documentation. It uses shell scripts and Python to process Markdown files from the official OpenClaw GitHub repository (raw.githubusercontent.com). The code follows safe practices, such as using mktemp for temporary files, sanitizing paths to prevent directory traversal, and passing arguments to Python scripts via sys.argv to avoid shell injection. No evidence of data exfiltration, persistence, or malicious intent was found in the scripts or the SKILL.md instructions.
Capability Assessment
Purpose & Capability
Name/description match the implementation: scripts fetch docs, build a BM25 index, search, and show sections. Required binaries (curl, python) are appropriate for network fetch and indexing. No unexpected credentials or unrelated binaries are requested.
Instruction Scope
SKILL.md and AGENTS.md instruct the agent to call the included shell/Python scripts to discover, fetch, and search docs. The scripts only reference repo/docs.json, docs.openclaw.ai, and the GitHub API; they read/write only the skill's cache directory and do not ask the agent to read unrelated user files or secrets. Workflow guidance is specific rather than open-ended.
Install Mechanism
No install spec is present (instruction-only), and code lives in the skill bundle. There are no external arbitrary downloads during install. Runtime does perform network fetches to GitHub/docs.openclaw.ai (expected for a doc fetcher), but those are performed by the provided scripts, not via an installer that pulls random archives.
Credentials
No required environment variables or credentials are declared. Optional env vars (OPENCLAW_SAGE_SOURCE, OPENCLAW_SAGE_DOC_TTL, OPENCLAW_SAGE_CACHE_DIR, etc.) are reasonable and documented. The scripts do use unauthenticated GitHub API and raw content URLs (normal for a docs fetcher).
Persistence & Privilege
always:false and agent-autoinvoke defaults are unchanged. The skill stores cached docs under a local .cache/openclaw-sage directory (or overridden cache dir) but does not request system-wide or other-skills configuration changes. It does not require persistent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-sage - After installation, invoke the skill by name or use
/openclaw-sage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.1
openclaw-sage 0.3.1
- Adds multi-version documentation support: Most fetch, info, and search scripts now accept `--version <tag>` to work with specific OpenClaw doc versions.
- Improves search flexibility: `search.sh` and `build-index.sh search` commands accept `--max-results <n>` to control result limits.
- Enhances caching and status scripts: `cache.sh status` shows all cached versions; new `cache.sh tags` lists available OpenClaw release tags.
- Greatly expands documentation, including source notes, usage examples, and updated agent workflow recommendations.
- Many scripts and workflows updated for more robust offline and multi-version operation.
v0.2.4
openclaw-sage 0.2.4
- Improved documentation and usability notes in SKILL.md and snippets.
- Scripts: usability, error handling, and status output tuned for recent, search, and doc fetching.
- Minor updates to changelog, package metadata, and configs.
- No breaking changes; all core commands and workflows remain stable.
v0.2.3
Version 0.2.3
- Added a version field and metadata (with binary dependencies) to SKILL.md.
- Improved input validation for scripts; `recent.sh` now requires numeric days, and exits with usage message if invalid.
- `build-index.sh fetch` now downloads both `.html` and `.txt` for offline use, enabling `--toc`, `--section`, and `info.sh` without a network connection.
- Removed old documentation and test files: `docs/coding-conventions.md`, `tests/test_bm25.py`.
- Documentation updates and clarifications throughout SKILL.md and other project docs.
v0.2.2
- No functional or content changes; metadata or documentation-only update.
- No changes to features, usage, or available tools.
- Existing instructions, scripts, and workflows remain unchanged.
v0.2.1
openclaw-sage v0.2.1
- Adds a new info.sh script to provide doc metadata (title, headings, word count) without loading full content.
- Expands documentation for new script options and clearer error messages.
- AGENTS.md, CLAUDE.md, and docs/coding-conventions.md added to improve documentation and agent development guidance.
- Refines BM25 search test coverage with new test_bm25.py.
- Various script enhancements for build-index, fetching, and tracking doc changes.
- CHANGELOG.md introduced for easier version tracking.
v0.2.0
- Added comprehensive SKILL.md documenting all available tools, workflows, and decision rules for answering OpenClaw user questions.
- Detailed instructions provided for searching, fetching, and troubleshooting documentation using included scripts.
- Decision rules for handling common user queries (setup, troubleshooting, automation, installation, "what's new", etc.).
- Added config snippets and provider setup guidance for quick copy-paste answers.
- Updated with new methods for tracking doc changes and recent updates.
- Now ensures all responses are source-cited with direct documentation URLs.
Metadata
Frequently Asked Questions
What is Openclaw Sage?
OpenClaw documentation expert — answers user questions about OpenClaw setup, configuration, providers, troubleshooting, and what's new using live doc fetchin... It is an AI Agent Skill for Claude Code / OpenClaw, with 477 downloads so far.
How do I install Openclaw Sage?
Run "/install openclaw-sage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Sage free?
Yes, Openclaw Sage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openclaw Sage support?
Openclaw Sage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Sage?
It is built and maintained by alfonso46674 (@alfonso46674); the current version is v0.3.1.
More Skills