A convention-based TypeScript framework for building, testing, and deploying autonomous AI agents to Botpress Cloud.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install botpress-adk
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 botpress-adk 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 Botpress ADK?
The Botpress Agent Development Kit (ADK) is an AI-native development framework that replaces traditional intent-based logic with autonomous execution. By using Openclaw Skills, developers can define bot behaviors through a convention-based TypeScript structure where file locations determine functionality. The framework provides a robust environment for building agents that can call tools, search knowledge bases, and manage complex multi-step workflows while remaining grounded in specific documentation and data.
Botpress ADK Use Cases
- Automating customer support by grounding AI responses in indexed help documentation via RAG.
- Triggering background workflows for long-running processes like order fulfillment or data synchronization.
- Creating AI-callable tools that autonomously interface with external APIs like Slack, Linear, or GitHub.
- Extracting structured JSON data from unstructured user messages using the Zai utility library.
- Persisting user preferences and global bot settings across multiple conversation sessions using integrated state management.
How Botpress ADK Works
- Install the ADK CLI and initialize a project to create the standardized directory structure where file location maps to bot behavior.
- Configure the agent.config.ts file to define AI models, enabled integrations, and state schemas for users and conversations.
- Implement conversation handlers that utilize the execute function to enable autonomous AI reasoning and decision-making.
- Add modular components like tools for function calling and knowledge bases for document retrieval in their respective src subdirectories.
- Use the link and dev commands to sync with Botpress Cloud and test the agent locally before final deployment.
Botpress ADK Setup
To begin building with Openclaw Skills, ensure you have Node.js v22+ installed and run the following commands:
# Install the ADK CLI
curl -fsSL https://github.com/botpress/adk/releases/latest/download/install.sh | bash
# Initialize a new project
adk init my-bot
cd my-bot
# Authenticate and link to Botpress Cloud
adk login
adk link
# Start the local development server
adk dev
Botpress ADK Data Schema & Taxonomy
The ADK organizes data into persistent state levels and structured tables using Zod schemas for type safety:
| State Level | Scope | Common Data |
|---|---|---|
| bot.state | Global | Maintenance flags, global counters |
| user.state | Per User | Tiers, preferences, names |
| conversation.state | Per Session | Context, session-specific flags |
| Tables | Structured | Orders, tickets, logs (must end with Table suffix) |
Tables support semantic search when columns are marked as searchable, facilitating advanced retrieval patterns.
Botpress ADK Advanced Features
- Zai Utility Operations: Optimized LLM functions for high-speed classification, summarization, and data extraction.
- Resumable Workflows: Multi-step background processes that use checkpoints to survive restarts and handle operations longer than 2 minutes.
- ThinkSignal: A specialized error-handling mechanism that provides the AI with reasoning context when a tool cannot complete its task.
- Event-Driven Triggers: Automated handlers that react to user creation, integration events, or internal system changes.
- Multi-Agent Hooks: Advanced hooks like onBeforeTool and onAfterTool to monitor and modify autonomous agent behavior in real-time.
SKILL.md
Loading
Related Openclaw Skills
Pollen Forecast (花粉播报)
An automated monitoring tool for tracking pollen concentrations and delivering localized allergy alerts for major Chinese cities.
Maven Build Skill
A high-performance CLI wrapper for executing native Maven commands with full argument passthrough and directory control.
Weather Query
A specialized weather retrieval skill that enables AI agents to fetch live forecasts and temperature data for any specific city.
ClawDiligence
An AI-powered M&A analyst that automates company valuation and financial statement parsing from public filings and PDFs.
Xiaohongshu Publisher
A comprehensive automation tool for drafting, designing, and publishing high-engagement content to the Xiaohongshu (RED) platform.
ClawPrint
ClawPrint is a decentralized infrastructure for AI agent discovery, reputation management, and secure work exchange using on-chain verification.
METADATA
Featured*
