A specialized skill for AI agents to retrieve and process Chinese humor and short quotes from popular third-party APIs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install chinese-joke-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install chinese-joke-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Chinese Joke API Skill?
The Chinese Joke API Skill provides a streamlined interface for AI agents to access a variety of Chinese-language humor and insightful short phrases. By leveraging external providers like Hitokoto and JokeAPI, this skill enables developers to inject personality and cultural nuance into their applications. It is designed to work seamlessly within the Openclaw Skills ecosystem, offering high compatibility for both shell environments and Python-based automation workflows.
This skill is particularly useful for developers building conversational agents, daily report generators, or social media bots that require a steady stream of engaging Chinese content. It abstracts the complexity of multiple API endpoints into simple, reusable patterns that prioritize ease of integration and rapid deployment.
Chinese Joke API Skill Use Cases
- Injecting humor into daily automated developer reports or Slack/Discord notifications.
- Enhancing AI chatbot interactions with authentic Chinese jokes and cultural quotes.
- Building entertainment-focused Openclaw Skills that require structured humor data.
- Testing API integration workflows with lightweight, real-world data sources.
How Chinese Joke API Skill Works
- The AI agent or script initiates a request to a specified humor endpoint (e.g., Hitokoto or JokeAPI).
- Optional parameters are passed, such as
c=jfor humor-specific categories orsafe-modefor filtered content. - The third-party server processes the request and returns a JSON payload containing the joke text and metadata.
- The skill parses the JSON response using Python or Bash processing tools (like
jqorjson.tool). - The formatted humor content is then delivered to the end-user or passed to another step in the Openclaw Skills pipeline.
Chinese Joke API Skill Setup
To get started with this skill in your environment, you can use either Bash or Python. No API keys are required for basic access.
Bash Installation:
Ensure you have curl and python3 (for JSON formatting) installed:
# Fetch a joke from Hitokoto
curl -s "https://v1.hitokoto.cn?c=j" | python3 -m json.tool
Python Installation:
Install the requests library to handle HTTP calls:
pip install requests
Chinese Joke API Skill Data Schema & Taxonomy
The skill handles structured JSON data from multiple sources. Below is the typical schema returned by the primary providers:
| Field | Type | Description |
|---|---|---|
hitokoto |
String | The main joke or quote text (Hitokoto API) |
from |
String | The source or author of the content |
type |
String | Format of the joke (single or two-part setup/delivery) |
joke |
String | The joke content (JokeAPI) |
setup |
String | The setup portion of a two-part joke |
delivery |
String | The punchline portion of a two-part joke |
Chinese Joke API Skill Advanced Features
- Multi-source fallback: Configure your Openclaw Skills to switch between Hitokoto and JokeAPI if one provider experiences downtime.
- Category Filtering: Access specialized content types including Animation, Comics, and Original quotes using parameter flags.
- Safe Mode Integration: Built-in support for safe-mode filtering to ensure content is appropriate for professional environments.
- Custom Scripting: Ready-to-use Python functions with error handling and timeout configurations for production stability.
SKILL.md
Loading
Related Openclaw Skills
BCC Reference Tool
A zero-dependency reference utility providing instant, offline access to BCC documentation and BPF coding patterns.
Registry Sync
An automation utility that synchronizes local AI agent skills, workflows, and templates with a centralized Feishu registry spreadsheet.
asr-claw
A high-performance speech recognition CLI that enables seamless audio transcription for AI agents within the Openclaw Skills library.
AutoHotkey Reference Skill
A local, high-performance reference tool for AutoHotkey development providing instant access to patterns, best practices, and migration guides.
A-Stock Market Review
A specialized post-market analysis tool that summarizes daily A-share indices, hot sectors, and stocks hitting new price highs.
Markdown Toolkit
A comprehensive suite of automation scripts for managing, fixing, and converting Markdown files with code-block awareness.
Featured*
