Chat/Ask Skill

A simple skill for handling chat conversations and Q&A with OpenClaw.

Description

This skill provides tools for: - Chat conversations with OpenClaw - Asking questions and getting answers - Managing chat history - Simple conversation analysis

Tools

chat

Start or continue a chat conversation.

Parameters: - message (string): The message to send in chat - context (string, optional): Additional context for the conversation

Example:

{
  "message": "Hello, how are you?",
  "context": "Just checking in"
}

ask

Ask a question to OpenClaw.

Parameters: - question (string): The question to ask - detailed (boolean, optional): Whether to provide a detailed answer (default: false)

Example:

{
  "question": "What is the weather like?",
  "detailed": true
}

chat-history

Manage chat history.

Parameters: - action (string): Action to perform - 'get', 'clear', or 'summary' - limit (number, optional): Number of messages to retrieve (default: 10)

Example:

{
  "action": "get",
  "limit": 5
}

Usage

1. Start a chat: Use the chat tool to start a conversation

2. Ask questions: Use the ask tool for specific questions

3. Manage history: Use chat-history to review or clear conversations

How to Call Tools

chat tool

python3 scripts/chat_tool.py '<message>' '[context]'

Example:

python3 scripts/chat_tool.py 'Hello, how are you?' 'Just checking in'

ask tool

python3 scripts/ask_tool.py '<question>' [detailed]

Example:

python3 scripts/ask_tool.py 'What is OpenClaw?' true

chat_history tool

python3 scripts/chat_history_tool.py '<action>' [limit]

Examples:

# Get last 10 messages
python3 scripts/chat_history_tool.py 'get' 10

# Clear history
python3 scripts/chat_history_tool.py 'clear'

# Get summary
python3 scripts/chat_history_tool.py 'summary'

Response Format

All tools return JSON with: - status: "success" or "error" - timestamp: ISO format timestamp - tool: Tool name that was called - Additional tool-specific fields

chat response

{
  "status": "success",
  "response": "I received your message...",
  "timestamp": "2026-03-16T14:30:00.000Z",
  "tool": "chat"
}

ask response

{
  "status": "success",
  "answer": "OpenClaw is a self-hosted AI assistant...",
  "detailed": true,
  "timestamp": "2026-03-16T14:30:00.000Z",
  "tool": "ask"
}

chat_history response

{
  "status": "success",
  "action": "get",
  "history": [...],
  "count": 5,
  "limit": 10,
  "total": 15
}

Configuration

No special configuration required. The skill works out of the box.

Notes

• Chat history is stored in memory during the session
• For persistent storage, consider integrating with a database
• The skill is designed for simple conversational interactions