Xpersona

Crawler Summary

telebutton answer-first brief

Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。 使用场景： - 需要用户从多个选项中选择 - 多轮嵌套菜单（选择后显示子菜单） - 简单的确认/取消交互 - 工作流分支选择（如 HPC 任务提交方式选择） 核心特点： - 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码 - 支持嵌套：多级菜单，选择后自动展开子选项 - 临时状态：无需持久化存储，适合快速交互 - 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果 --- name: telebutton description: | Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。 使用场景： - 需要用户从多个选项中选择 - 多轮嵌套菜单（选择后显示子菜单） - 简单的确认/取消交互 - 工作流分支选择（如 HPC 任务提交方式选择） 核心特点： - 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码 - 支持嵌套：多级菜单，选择后自动展开子选项 - 临时状态：无需持久化存储，适合快速交互 - 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果 --- Telebutton - Telegram 选择按钮 Skill 快速开始 1. 基础用法 2. 配置文件方式 **config/hpc_menu.yaml:** API 参考 ButtonMenu 类 主菜单配置类。 Bu Capability contract not published. No trust telemetry is available yet. Last updated 4/14/2026.

Freshness

Last checked 4/14/2026

Best For

telebutton is best for general automation workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, GITHUB OPENCLEW, runtime-metrics, public facts pack

CardFactsSnapshotContractTrust
Claim this agent
Agent DossierGitHubSafety: 94/100

telebutton

Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。 使用场景： - 需要用户从多个选项中选择 - 多轮嵌套菜单（选择后显示子菜单） - 简单的确认/取消交互 - 工作流分支选择（如 HPC 任务提交方式选择） 核心特点： - 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码 - 支持嵌套：多级菜单，选择后自动展开子选项 - 临时状态：无需持久化存储，适合快速交互 - 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果 --- name: telebutton description: | Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。 使用场景： - 需要用户从多个选项中选择 - 多轮嵌套菜单（选择后显示子菜单） - 简单的确认/取消交互 - 工作流分支选择（如 HPC 任务提交方式选择） 核心特点： - 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码 - 支持嵌套：多级菜单，选择后自动展开子选项 - 临时状态：无需持久化存储，适合快速交互 - 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果 --- Telebutton - Telegram 选择按钮 Skill 快速开始 1. 基础用法 2. 配置文件方式 **config/hpc_menu.yaml:** API 参考 ButtonMenu 类 主菜单配置类。 Bu

OpenClawself-declared

Public facts

4

Change events

1

Artifacts

0

Freshness

Apr 14, 2026

Verifiededitorial-contentNo verified compatibility signals

Capability contract not published. No trust telemetry is available yet. Last updated 4/14/2026.

Trust evidence available

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Apr 14, 2026

Vendor

Liush2yuxjtu

Artifacts

0

Benchmarks

0

Last release

Unpublished

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Capability contract not published. No trust telemetry is available yet. Last updated 4/14/2026.

View Source

Setup snapshot

git clone https://github.com/liush2yuxjtu/telebutton.git
  1. 1

    Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.

  2. 2

    Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content
Vendor (1)

Vendor

Liush2yuxjtu

profilemedium
Observed Apr 14, 2026Source linkProvenance
Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium
Observed Apr 14, 2026Source linkProvenance
Security (1)

Handshake status

UNKNOWN

trustmedium
Observed unknownSource linkProvenance
Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium
Observed Apr 15, 2026Source linkProvenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB OPENCLEW

Extracted files

0

Examples

6

Snippets

0

Languages

typescript

Parameters

Executable Examples

python

from telebutton import ButtonMenu, show_menu, wait_selection

# 定义菜单
menu = ButtonMenu(
    question="选择执行方式：",
    options=[
        {"text": "本地运行", "callback": "local"},
        {"text": "远程服务器", "callback": "remote", "sub_menu": {
            "question": "选择服务器：",
            "options": [
                {"text": "HPC-01", "callback": "hpc_01"},
                {"text": "HPC-02", "callback": "hpc_02"}
            ]
        }}
    ]
)

# 发送按钮
message_id = show_menu(menu)

# 等待用户选择（阻塞式）
result = wait_selection(timeout=300)  # 5分钟超时

print(f"用户选择了: {result['callback']}")
# 输出: 用户选择了: hpc_01

python

from telebutton import load_menu_from_file, show_menu, wait_selection

# 从 YAML 加载
menu = load_menu_from_file("config/hpc_menu.yaml")
show_menu(menu)
result = wait_selection()

yaml

question: "选择执行方式："
options:
  - text: "本地运行"
    callback: "local"
  - text: "远程服务器"
    callback: "remote"
    sub_menu:
      question: "选择服务器："
      options:
        - text: "HPC-01"
          callback: "hpc_01"
        - text: "HPC-02"
          callback: "hpc_02"
        - text: "返回"
          callback: "back"

python

ButtonMenu(
    question: str,                    # 显示的问题/标题
    options: List[ButtonOption],       # 选项列表
    max_per_row: int = 2               # 每行最多按钮数
)

python

{
    "text": str,                      # 按钮显示文字
    "callback": str,                  # 回调标识（唯一）
    "sub_menu": Optional[ButtonMenu]  # 子菜单（可选）
}

python

from telebutton import show_confirm

result = show_confirm("确定要删除吗？")
if result['callback'] == 'yes':
    print("用户确认")

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB OPENCLEW

Docs source

GITHUB OPENCLEW

Editorial quality

ready

Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。 使用场景： - 需要用户从多个选项中选择 - 多轮嵌套菜单（选择后显示子菜单） - 简单的确认/取消交互 - 工作流分支选择（如 HPC 任务提交方式选择） 核心特点： - 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码 - 支持嵌套：多级菜单，选择后自动展开子选项 - 临时状态：无需持久化存储，适合快速交互 - 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果 --- name: telebutton description: | Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。 使用场景： - 需要用户从多个选项中选择 - 多轮嵌套菜单（选择后显示子菜单） - 简单的确认/取消交互 - 工作流分支选择（如 HPC 任务提交方式选择） 核心特点： - 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码 - 支持嵌套：多级菜单，选择后自动展开子选项 - 临时状态：无需持久化存储，适合快速交互 - 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果 --- Telebutton - Telegram 选择按钮 Skill 快速开始 1. 基础用法 2. 配置文件方式 **config/hpc_menu.yaml:** API 参考 ButtonMenu 类 主菜单配置类。 Bu

Full README

name: telebutton description: | Telegram 选择按钮交互 Skill。用于在 Telegram 对话中向用户展示选择按钮（InlineKeyboard），获取用户反馈。

使用场景：

  • 需要用户从多个选项中选择
  • 多轮嵌套菜单（选择后显示子菜单）
  • 简单的确认/取消交互
  • 工作流分支选择（如 HPC 任务提交方式选择）

核心特点：

  • 配置驱动：通过 YAML/JSON 定义按钮结构，无需修改代码
  • 支持嵌套：多级菜单，选择后自动展开子选项
  • 临时状态：无需持久化存储，适合快速交互
  • 通用接口：与具体执行逻辑解耦，Agent 自行处理选择结果

Telebutton - Telegram 选择按钮 Skill

快速开始

1. 基础用法

from telebutton import ButtonMenu, show_menu, wait_selection

# 定义菜单
menu = ButtonMenu(
    question="选择执行方式：",
    options=[
        {"text": "本地运行", "callback": "local"},
        {"text": "远程服务器", "callback": "remote", "sub_menu": {
            "question": "选择服务器：",
            "options": [
                {"text": "HPC-01", "callback": "hpc_01"},
                {"text": "HPC-02", "callback": "hpc_02"}
            ]
        }}
    ]
)

# 发送按钮
message_id = show_menu(menu)

# 等待用户选择（阻塞式）
result = wait_selection(timeout=300)  # 5分钟超时

print(f"用户选择了: {result['callback']}")
# 输出: 用户选择了: hpc_01

2. 配置文件方式

from telebutton import load_menu_from_file, show_menu, wait_selection

# 从 YAML 加载
menu = load_menu_from_file("config/hpc_menu.yaml")
show_menu(menu)
result = wait_selection()

config/hpc_menu.yaml:

question: "选择执行方式："
options:
  - text: "本地运行"
    callback: "local"
  - text: "远程服务器"
    callback: "remote"
    sub_menu:
      question: "选择服务器："
      options:
        - text: "HPC-01"
          callback: "hpc_01"
        - text: "HPC-02"
          callback: "hpc_02"
        - text: "返回"
          callback: "back"

API 参考

ButtonMenu 类

主菜单配置类。

ButtonMenu(
    question: str,                    # 显示的问题/标题
    options: List[ButtonOption],       # 选项列表
    max_per_row: int = 2               # 每行最多按钮数
)

ButtonOption 结构

{
    "text": str,                      # 按钮显示文字
    "callback": str,                  # 回调标识（唯一）
    "sub_menu": Optional[ButtonMenu]  # 子菜单（可选）
}

核心函数

show_menu(menu, chat_id=None)

发送按钮菜单到 Telegram。

  • menu: ButtonMenu 实例
  • chat_id: 目标聊天 ID（默认当前会话）
  • 返回: message_id

wait_selection(timeout=300, delete_message=True)

等待用户选择。

  • timeout: 超时时间（秒）
  • delete_message: 选择后是否删除原消息
  • 返回: {"callback": str, "text": str, "path": List[str]}
    • callback: 选中的回调标识
    • text: 选中的按钮文字
    • path: 选择路径（如 ["remote", "hpc_01"]）

show_confirm(question, yes_text="是", no_text="否")

快速显示确认对话框。

from telebutton import show_confirm

result = show_confirm("确定要删除吗？")
if result['callback'] == 'yes':
    print("用户确认")

高级用法

动态生成选项

from telebutton import ButtonMenu, show_menu, wait_selection

# 从外部数据动态生成
servers = ["hpc-01", "hpc-02", "hpc-03"]

menu = ButtonMenu(
    question="选择服务器：",
    options=[
        {"text": s.upper(), "callback": s} 
        for s in servers
    ],
    max_per_row=3
)

show_menu(menu)
result = wait_selection()

处理多级选择

result = wait_selection()

# 根据选择路径判断
if result['path'] == ['remote', 'hpc_01']:
    # 用户选择了：远程服务器 -> HPC-01
    execute_on_hpc_01()
elif result['callback'] == 'local':
    # 用户选择了：本地运行
    execute_locally()

自定义按钮样式

from telebutton import ButtonOption

options = [
    ButtonOption(text="✅ 确认", callback="confirm"),
    ButtonOption(text="❌ 取消", callback="cancel"),
    ButtonOption(text="🔙 返回", callback="back"),
]

完整示例

HPC 任务提交

from telebutton import ButtonMenu, show_menu, wait_selection

def submit_hpc_job():
    # 主菜单
    main_menu = ButtonMenu(
        question="🖥️ HPC 任务提交",
        options=[
            {
                "text": "🚀 快速提交",
                "callback": "quick",
                "sub_menu": {
                    "question": "选择队列：",
                    "options": [
                        {"text": "GPU (A100)", "callback": "gpu_a100"},
                        {"text": "GPU (3090)", "callback": "gpu_3090"},
                        {"text": "CPU", "callback": "cpu"}
                    ]
                }
            },
            {
                "text": "⚙️ 高级配置",
                "callback": "advanced"
            },
            {
                "text": "📊 查看状态",
                "callback": "status"
            }
        ]
    )
    
    show_menu(main_menu)
    result = wait_selection()
    
    # 处理选择
    if result['callback'] == 'gpu_a100':
        print("提交到 A100 队列...")
    elif result['callback'] == 'advanced':
        print("打开高级配置...")
    # ...

注意事项

  1. 超时处理: wait_selection() 默认 5 分钟超时，超时后返回 None
  2. 并发: 同一聊天中同时只能有一个活跃的选择等待
  3. 回调唯一性: 同一菜单层级中，callback 标识必须唯一
  4. 嵌套深度: 建议不超过 3 层嵌套，避免用户迷失

依赖

  • Python >= 3.8
  • OpenClaw 消息工具（用于发送按钮和接收回调）

参考

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

MissingGITHUB OPENCLEW

Endpoints

Dossier APISnapshot APIContract APITrust API

Contract coverage

Status

missing

Auth

None

Streaming

No

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.
Invocation examples
curl -s "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/snapshot"
curl -s "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/contract"
curl -s "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.
No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media
No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors
GITHUB_REPOSactivepieces

Rank

70

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

Traction

No public download signal

Freshness

Updated 2d ago

OPENCLAW
GITHUB_REPOScherry-studio

Rank

70

AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs

Traction

No public download signal

Freshness

Updated 5d ago

MCPOPENCLAW
GITHUB_REPOSAionUi

Rank

70

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

Traction

No public download signal

Freshness

Updated 6d ago

MCPOPENCLAW
GITHUB_REPOSCopilotKit

Rank

70

The Frontend for Agents & Generative UI. React + Angular

Traction

No public download signal

Freshness

Updated 23d ago

OPENCLAW
Agent hubMore from this sourceOpenClaw agents
Machine Appendix

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_OPENCLEW",
      "generatedAt": "2026-04-16T23:36:39.090Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Liush2yuxjtu",
    "href": "https://github.com/liush2yuxjtu/telebutton",
    "sourceUrl": "https://github.com/liush2yuxjtu/telebutton",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-14T22:23:52.272Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-14T22:23:52.272Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/liush2yuxjtu-telebutton/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Sponsored

Ads related to telebutton and adjacent AI workflows.