A versatile skill that triggers specific Poe models using simple @ tags with automatic model selection and file upload capabilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install poe-chat
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 poe-chat 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 Poe Chat?
The Poe Chat skill is a comprehensive integration designed for Openclaw Skills that enables users to communicate with a vast range of LLMs hosted on Poe, including Gemini, GPT, Claude, Kimi, and Deepseek. By simply using trigger words such as @gemini or @gpt in their messages, users can leverage the specific strengths of different models without manual configuration.
This skill automates the complexity of model management by dynamically fetching available model IDs and selecting the most appropriate version based on intelligent priority logic. It serves as a bridge between your local environment and the powerful ecosystem of models available on Poe, ensuring you always use the right tool for the job.
Poe Chat Use Cases
- Triggering specific AI providers within a chat using @mentions like @claude or @gemini.
- Automatically selecting the most efficient model version, such as preferring Flash versions over Pro for standard queries.
- Performing document analysis by uploading local PDF or text files directly to Poe-hosted models.
- Centralizing access to diverse models like Kimi or Deepseek through a single Openclaw Skills interface.
How Poe Chat Works
- The skill scans the user's message for trigger words starting with the @ symbol.
- It executes a discovery script to fetch a list of all available models from the Poe API.
- A local cache (models.json) is created or updated to store model IDs and descriptions, ensuring fast subsequent lookups.
- The skill selects the best matching model ID based on the trigger word and a predefined priority hierarchy (e.g., favoring the latest version and non-Pro models unless specified).
- If files are attached, they are uploaded to Poe's infrastructure via the fastapi-poe client.
- The final request is sent to Poe, and the response is returned along with a clear label of which specific model was used.
Poe Chat Setup
To get started with this skill for Openclaw Skills, follow these steps:
- Install the necessary Python dependencies:
pip install -r scripts/requirements.txt
- Configure your Poe API Key as an environment variable:
export POE_API_KEY="your_api_key_here"
- Initialize your local model cache:
python scripts/list_models.py
Poe Chat Data Schema & Taxonomy
The Poe Chat skill manages data using the following structure to optimize performance within Openclaw Skills:
| Component | Format | Description |
|---|---|---|
models.json |
JSON File | A local cache of available model IDs, refreshed every hour based on file modification time. |
POE_API_KEY |
Env Var | The authentication token required to communicate with the Poe API. |
model_id |
String | The unique identifier for the selected LLM (e.g., gemini-1.5-flash). |
attachments |
List | A collection of file metadata including name, type, and URL for uploaded documents. |
Poe Chat Advanced Features
- Intelligent priority logic that defaults to cost-effective models unless Pro or Ultra tiers are explicitly requested in the prompt.
- Support for multiple file uploads in a single request for cross-document synthesis.
- Automated model discovery that updates the local cache to include newly released models on the Poe platform.
- Flexible CLI arguments allowing for direct model ID overrides and full metadata extraction using the --full flag.
- Seamless integration with the Openclaw Skills framework for consistent output formatting and model attribution.
SKILL.md
Loading
Related Openclaw Skills
Google Sheets
A robust tool for automating Google Sheets operations including data management, formatting, and layout control via the Google Sheets API.
Facebook Page Manager
A powerful Openclaw Skills tool for automating Facebook Page posts, comment management, and engagement via the Meta Graph API.
WordCount
A high-performance bash utility for calculating precise line, word, character, and byte counts with full support for CJK text.
Korail Manager
A powerful automation skill for searching, watching, and reserving Korail and SRT train tickets in South Korea.
Report PPT Generator Pro
An AI-driven presentation engine that converts text manuscripts into professional, style-matched PowerPoint decks with AI illustrations and interactive previews.
AI Tools & GitHub Radar
Monitors and analyzes high-momentum AI tools and GitHub repositories to separate hype from genuine technological shifts.
Featured*
