# Send Poe Chat to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "poe-chat",
    "name": "Poe Chat",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/longmans/poe-chat",
    "canonicalUrl": "https://clawhub.ai/longmans/poe-chat",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/poe-chat",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=poe-chat",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/requirements.txt",
      "scripts/__init__.py",
      "scripts/list_models.py",
      "scripts/poe_client.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "poe-chat",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T01:15:14.909Z",
      "expiresAt": "2026-05-08T01:15:14.909Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=poe-chat",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=poe-chat",
        "contentDisposition": "attachment; filename=\"poe-chat-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "poe-chat"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/poe-chat"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/poe-chat",
    "downloadUrl": "https://openagent3.xyz/downloads/poe-chat",
    "agentUrl": "https://openagent3.xyz/skills/poe-chat/agent",
    "manifestUrl": "https://openagent3.xyz/skills/poe-chat/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/poe-chat/agent.md"
  }
}
```
## Documentation

### 适用场景

用户输入包含 @gemini、@gpt 等 @触发词，希望用 Poe 上的具体模型回答问题。
需要自动匹配最合适的具体模型名称（例如 gemini-3-flash）。
支持把本地文件上传给模型分析。

### 1) 安装依赖（只需一次）

pip install -r scripts/requirements.txt

如系统没有 python 命令，请改用 python3 执行下列命令。

### 2) 设置 Poe API Key（如未设置）

export POE_API_KEY="your_api_key"

也可以在调用时通过 --api-key 传入（优先生效）。

### 3) 查看可用模型（独立脚本）

python scripts/list_models.py

默认会在当前目录生成精简版 models.json（仅包含 id），并作为本地缓存（缓存时间 1 小时，基于文件修改时间）。

也可指定输出文件名：

python scripts/list_models.py --out models.json

如需查看完整模型信息（如 description 等），使用 --full：

python scripts/list_models.py --full --out models-full.json

### 4) 根据模型列表选择模型 ID

从 models.json 中选择要使用的模型 ID：

重点字段是 data[].id（这就是 model_id）
可结合 data[].description 判断用途和能力

示例（手动选择）：

{
  "data": [
    {"id": "gemini-3-pro", "description": "..."},
    {"id": "claude-opus-4.6", "description": "..."}
  ]
}

当用户输入 @gemini ... 时，选择包含 Gemini 的模型，并遵循以下优先级：

默认优先非 Pro（例如优先 gemini-3-flash 而不是 gemini-3-pro）
优先最新版本号（例如 2.5 优于 2.0）
只有用户明确要求 Pro/Ultra 时才选 Pro/Ultra（例如用户输入 @gemini-pro 或明确说“用Pro”）

### 5) 调用脚本（直接传入模型 ID）

python scripts/poe_client.py \\
  --message "请解释量子计算" \\
  --model-id "gemini-3-flash" \\
  --api-key "your_api_key" \\
  --file "/path/to/document.pdf"

说明：

--message 必填，内容中包含 @xxx 触发词即可（如 @gemini、@gpt）。
--file 可选，可重复多次上传多个文件。

### 行为准则

解析触发词：从用户消息中提取第一个 @xxx 触发词。
模型选择：根据 models.json 里的 data[].id 手动选择最相关的具体模型。
模型列表：通过 list_models.py 获取模型列表，内存缓存 1 小时（不持久化）。
API Key：若环境变量 POE_API_KEY 未设置，poe_client.py 会提示用户输入。
文件上传：如提供 --file，poe_client.py 使用 fastapi-poe 上传并附加到请求。
响应输出：回答正文前必须标注 具体模型名（例如 Model used: gemini-3-flash）。

### 输出格式

Model used: <具体模型名>

<模型回答内容>

如存在模型返回的附件，列出附件信息（名称、类型、URL）。
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: longmans
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T01:15:14.909Z
- Expires at: 2026-05-08T01:15:14.909Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/poe-chat)
- [Send to Agent page](https://openagent3.xyz/skills/poe-chat/agent)
- [JSON manifest](https://openagent3.xyz/skills/poe-chat/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/poe-chat/agent.md)
- [Download page](https://openagent3.xyz/downloads/poe-chat)