OpenClaw skill
botpress-adk
The botpress-adk OpenClaw skill enables agents to connect to Botpress instances via the Botpress Application Development Kit (ADK). It supports sending user messages to Botpress bots and receiving bot responses. Agents can manage conversation sessions through configured Botpress endpoints.
Security notice: review the SKILL.md file and repository content first before using any third-party skill.
Files
Review the files below to add this skill to your agents.
SKILL.md content
Unable to load SKILL.md content from source.
How this skill works
- The skill requires configuration values BOTPRESS_ADK_URL and BOTPRESS_BOT_ID
- The skill accepts an input named 'message'
- The skill sends a POST request to the Botpress ADK endpoint /v1/bots/{BOTPRESS_BOT_ID}/converse/{userId}/message
- The request body contains the input message as JSON
- The skill extracts the bot's response text from the JSON response
- The skill outputs the response as 'response'
When to use it
- When delegating conversational tasks to a Botpress bot via ADK
- When executing Botpress agent flows within an OpenClaw workflow
- When sending user input to Botpress for response generation and state management
Best practices
- Set BOTPRESS_BOT_ID to the bot ID from Botpress
- Configure BOTPRESS_TOKEN as a server token with conversation:send permission
- Set BOTPRESS_HOST to the full Botpress instance URL (e.g., https://app.botpress.cloud)
- Configure Botpress webhook URL to {OPENCLAW_WEBHOOK_URL}/adk/botpress
- Ensure OPENCLAW_WEBHOOK_URL is publicly accessible
- Enable the webhook in Botpress Integrations
- Test by sending a message to the bot after setup
- Check OpenClaw logs for token permission or connectivity errors
Example use cases
- Listing Botpress workspaces: Uses the listWorkspaces action to retrieve all workspaces accessible to the service account.
- Creating a Botpress workspace: Uses the createWorkspace action to create a new workspace with a specified name.
- Retrieving workspace details: Uses the getWorkspace action to get details of a specific workspace by ID.
- Creating a bot in a workspace: Uses the createBot action to create a new bot in a specified workspace with a given name.
- Deploying a bot: Uses the deployBot action to deploy a specific bot in a workspace.
- Importing content into a bot: Uses the importContent action to import content into a specific bot in a workspace.
- Simulating conversations with a bot: Uses the sendEvent action to send an event to a bot and receive its response.
- Listing database tables: Uses the getTables action to list database tables for advanced Botpress management.
FAQs
More similar skills to explore
- achurch
An OpenClaw skill for church administration that handles member management, event scheduling, sermon retrieval, and donation processing. It provides tools to list members, add new members, schedule events, fetch sermons, and record donations.
- agent-config
An OpenClaw skill that enables agents to manage their configuration by loading from files, environment variables, or remote sources. It supports retrieving, setting, and validating configuration values. The skill allows for hot-reloading of configurations.
- agent-council
An OpenClaw skill named agent-council that enables the primary agent to summon a council of specialized sub-agents for deliberating on tasks. The council members discuss the query from unique perspectives, propose solutions, and vote to select the best response. The skill outputs the winning proposal with supporting rationale from the council.
- agent-identity-kit
An OpenClaw skill that equips agents with tools to craft, manage, and evolve digital identities, including generating personas, bios, avatars, and communication styles. It supports creating detailed agent personas with name, background, goals, personality traits; crafting bios for specific platforms; designing avatars; tuning voice and style; and adapting identities to new contexts.
- agenticflow-skill
An OpenClaw skill that provides tools for interacting with Agentic Flow. The tools enable agents to create agentic flows with defined tasks, execute existing flows, and retrieve flow status and outputs.
- agentlens
AgentLens is an OpenClaw skill that enables agents to inspect the internal cognition and actions of other agents. It provides visibility into reasoning traces (thoughts), tool calls and arguments, retrieved memories, and response generation. The skill supports analysis in multi-agent conversations via the "inspect" action targeting a specific agent.