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 '\x3Cmessage>' '[context]'

Example:

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

ask tool

python3 scripts/ask_tool.py '\x3Cquestion>' [detailed]

Example:

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

chat_history tool

python3 scripts/chat_history_tool.py '\x3Caction>' [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