Edith Senso Ingest

Senso Content Ingestion

Ingest documents and content into the user's Senso.ai knowledge base so it becomes searchable through Edith smart glasses.

When to use

Activate this skill when the user wants to add, upload, or ingest content into their knowledge base. Examples:

Do NOT use this skill for simple note-taking or reminders. This is for ingesting substantial content that should be searchable later.

Setup

The user must have a Senso.ai API key configured. If not, tell them:

1. Sign up at https://senso.ai and create a project 2. Go to Settings > API Keys and generate a new key 3. Tell OpenClaw: "My Senso API key is sk-..." and store it for future use

The API key should be stored in OpenClaw's memory/config as SENSO_API_KEY.

How to ingest content

Use the exec tool to call the Senso.ai content ingestion endpoint:

curl -s -X POST "https://sdk.senso.ai/api/v1/content/raw" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${SENSO_API_KEY}" \
  -d '{"content": "", "metadata": {"title": "", "source": ""}}'

Ingesting from a file

If the user provides a file path, read it first and then send the content:

curl -s -X POST "https://sdk.senso.ai/api/v1/content/raw" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ${SENSO_API_KEY}" \
  -d @- <<'BODY'
{
  "content": "",
  "metadata": {
    "title": "",
    "source": "file"
  }
}
BODY

For large files, consider chunking the content into logical sections before ingesting.

Formatting responses for Edith voice output

Edith speaks responses through smart glasses speakers. Keep confirmations brief:

1. Confirm success simply. Say "Done, I've added that to your knowledge base" or "Got it, that's been indexed." 2. Mention what was ingested. Say "I've added the return policy document to your knowledge base" so the user knows what happened. 3. No technical details. Don't mention API responses, document IDs, chunk counts, or byte sizes. 4. If it fails, be clear. Say what went wrong in plain language.

Example

User: "Hey Edith, add this meeting summary to my knowledge base: We decided to launch the new product line in Q3 and increase the marketing budget by 20 percent."

Good response: "Done, I've added your meeting summary to your knowledge base."

Bad response: "I have successfully ingested 1 document containing 147 characters into your Senso.ai knowledge base. The document ID is doc_abc123 and it was chunked into 1 segment."

Error handling

User: "Hey Edith, add this meeting summary to my knowledge base: We decided to launch the new product line in Q3 and increase the marketing budget by 20 percent."

Good response: "Done, I've added your meeting summary to your knowledge base."

Bad response: "I have successfully ingested 1 document containing 147 characters into your Senso.ai knowledge base. The document ID is doc_abc123 and it was chunked into 1 segment."

The user must have a Senso.ai API key configured. If not, tell them:

1. Sign up at https://senso.ai and create a project 2. Go to Settings > API Keys and generate a new key 3. Tell OpenClaw: "My Senso API key is sk-..." and store it for future use

The API key should be stored in OpenClaw's memory/config as SENSO_API_KEY.