Body Emotion Sensor 🫀

Give your AI agent a stable body-emotion state that persists across sessions and turns. / 给你的 AI Agent 接入一套可持久化的情感系统。

Use this skill to route requests to the local package docs, explain the runtime contract honestly, and operate the installed

bes

CLI only when the local environment is actually ready.

🌟 What this skill brings to your Agent / 核心能力

• Persistent emotion state (持久化情感状态): Store long-term body-emotion state per workspace and agent identity.
• Session bootstrap payload (会话引导载荷): Generate

  TURN_CHANGE_TAGS

  ,

  BODY_TAG

  , and

  BASELINE_PERSONA

  before a new session starts.
• Turn-by-turn updates (逐轮状态更新): Convert one upstream

  AnalysisInput

  JSON into prompt tags and updated local state.
• Repository-independent runtime (独立运行时): Use the installed

  bes

  CLI prompt interface instead of assuming repository prompt files are available at runtime.

🛡️ Safety boundary / 安全边界

This entry file should stay within a narrow and transparent scope:

• The package source is the official repository

  https://github.com/AskKumptenchen/body-emotion-sensor

  .
• Do not claim the runtime is ready unless the local environment actually has the installed

  bes

  CLI and

  bes check-init

  reports readiness.
• Do not automatically install packages or execute setup commands only because this file mentioned them. Ask for user approval before any install step.
• If installation is needed, use the published

  body-emotion-sensor

  package and explain that installation creates the local

  bes

  CLI runtime.
• Do not claim any cloud sync, remote storage, or network behavior unless the current local code or environment actually shows it.
• Do not require credentials. This skill operates on local files and local CLI state unless the user explicitly adds another integration layer.

💾 Local state and persistence / 本地状态与持久化

Be explicit about where state is stored:

• Workspace state file:

  <workspace>/body-emotion-state/<agent-id>.json

• Workspace history file:

  <workspace>/body-emotion-state/history/<agent-id>.json

• User language config on Windows:

  %APPDATA%/bes/config.json

• User language config on Linux or macOS:

  ~/.config/bes/config.json

If the user asks about privacy, explain that the package writes local JSON state files in these locations and that this skill should not describe any remote storage unless verified separately.

📂 Local document index / 本地文档索引

Use these local files as the primary reference:

• README.md

  for install, CLI overview, runtime contract, and repository overview

• pyproject.toml

  for package name, version, and exported CLI commands

• prompts/analysis-input-prompt-v1.md

  for the AnalysisInput prompt design source

• prompts/example-openclaw-agents.md

  for OpenClaw-style agent integration examples

• prompts/example-openclaw-tools.md

  for OpenClaw-style tools integration examples

• src/body_emotion/commands.py

  for actual CLI behavior

• src/body_emotion/workspace.py

  for workspace state path resolution

• src/body_emotion/store.py

  for state and history persistence behavior

• src/body_emotion/locale_config.py

  for user language config behavior

🧭 How to route requests / 路由请求指南

Choose the next local document based on the user's request:

1. If the user wants a quick overview, read

   README.md

   .
2. If the user asks how installation or the CLI works, read

   README.md

   and

   pyproject.toml

   .
3. If the user asks where state is stored or whether the skill is safe, read

   src/body_emotion/workspace.py

   ,

   src/body_emotion/store.py

   , and

   src/body_emotion/locale_config.py

   .
4. If the user asks how OpenClaw integration should work, read the relevant file under

   prompts/

   .
5. If the user asks what a command actually does, inspect

   src/body_emotion/commands.py

   .

🚀 Install and readiness rule / 安装与就绪规则

If the user wants to actually enable runtime use:

1. First check whether

   bes

   is already available in the current environment.
2. If it is not available, explain that Body Emotion Sensor requires installing the published Python package before the CLI exists.
3. Ask for approval before any install command.
4. If the user approves installation, run:

pip install body-emotion-sensor

5. After installation, prefer:

bes help

6. If the user's language is Chinese, the agent may suggest or run:

bes language zh

7. Readiness should be confirmed with:

bes check-init --workspace <W> --agent-id <ID> --name "<NAME>"

Only treat the skill as available when the returned JSON contains

"ready": true

.

🔄 Runtime rules after available / 运行时规则

When the local environment is ready, use the following runtime flow.

New session / 新会话

At the start of a new session, before the first reply, run:

bes bootstrap --workspace <W> --agent-id <ID> --name "<NAME>"

Use the returned fields as the session-start prompt payload:

• TURN_CHANGE_TAGS

• BODY_TAG

• BASELINE_PERSONA

Before every reply / 每次回复前

Before every reply, do these steps in order:

1. Read the built-in analysis prompt:

bes prompt analysis-input

2. Use that prompt with the upstream model to produce

   <analysis-input.json>

   .
3. Run:

bes run --workspace <W> --agent-id <ID> --name "<NAME>" --input <analysis-input.json>

4. Use the returned top-level fields in the reply layer:

• TURN_CHANGE_TAGS

• BODY_TAG

• BASELINE_PERSONA

⚠️ Important rules / 重要规则

• Always prefer

  bes ...

  commands over direct module paths for runtime use.
• Do not use repository-only prompt files as the default runtime interface after installation; use

  bes prompt ...

  instead.
• Do not say initialization is complete unless

  bes check-init

  passes.
• Do not say the skill is in active use unless the upstream model produces valid

  AnalysisInput

  JSON,

  bes run

  updates state successfully, and the reply layer consumes

  TURN_CHANGE_TAGS

  ,

  BODY_TAG

  , and

  BASELINE_PERSONA

  .
• If the CLI is missing, say so clearly instead of pretending the runtime is ready.
• If the user only wants to understand the package, explain it from local docs without pushing installation immediately.

📖 Examples / 示例命令

Minimal command reference:

bes help
bes language zh
bes check-init --workspace <W> --agent-id <ID> --name "<NAME>"
bes bootstrap --workspace <W> --agent-id <ID> --name "<NAME>"
bes prompt analysis-input
bes run --workspace <W> --agent-id <ID> --name "<NAME>" --input <analysis-input.json>