fuxi-api

What This Skill Does

The fuxi-api skill serves as a powerful bridge between the OpenClaw AI agent and the internal Vanna AI SQL infrastructure, specifically designed for the Fuxi database environment. This skill enables users to leverage natural language to query complex backend business data without needing to write SQL manually. By interacting with the https://vanna-ai-sql-api-ontest.inner.chj.cloud/ask endpoint, the skill translates user queries into executable SQL, executes them against the database, and interprets the structured output into human-readable, actionable responses. It is essential for operational tasks such as retrieving driver's license grades, checking vehicle compliance, or analyzing personnel-specific records stored within the Fuxi repository.

Installation

To install the skill, use the following command in your OpenClaw environment:

clawhub install openclaw/skills/skills/bitbw/fuxi-api

Ensure that your environment has sufficient permissions to access the internal domain defined in the skill configuration. The skill utilizes Node.js and the exec utility to trigger the helper script, so confirm that your host machine has Node.js installed and configured correctly.

Use Cases

This skill is ideal for scenarios involving database-driven internal operations. Use it when you need to access specific data points tied to the Fuxi database. Primary use cases include:

• Auditing driver license information or status.
• Investigating historical driving records or compliance events for specific personnel.
• Generating ad-hoc business intelligence reports based on natural language inquiries.
• Cross-referencing personnel IDs with registered business data in real-time.

Example Prompts

1. "查询伏羲上的张博文准驾等级"
2. "帮我看看伏羲里驾驶人张三最近的违规记录"
3. "利用伏羲 SQL 系统帮我查下当前所有持 C1 驾照的员工名单"

Tips & Limitations

• Ambiguity Handling: If the database returns multiple results for a single query (e.g., multiple individuals with the same name), the skill will surface the conflict. Please provide additional filtering criteria like department IDs or partial ID numbers to narrow down results.
• Error Transparency: While the tool is robust, network disruptions or backend maintenance can cause request timeouts. If a 5xx error occurs, wait a few minutes before retrying.
• Security: The skill does not disclose raw internal server logs or full stack traces to the user. It summarizes results based on the data field of the API response to maintain security posture.
• Execution Limits: Please note that the visualize flag is currently set to false. If you require advanced data visualization, ensure your local environment supports processing the returned JSON objects into charts or graphs.