可安装 Skill
把 TwtAPI 变成可以直接安装使用的 Skill
如果你不想从 API 文档和脚本开始，可以直接使用可安装的 Skill。托管网关已经准备好，只需要登录生成 skill_key，然后在 OpenClaw 或兼容运行器里完成安装。
安装流程很短
公开 Skill 已经准备好调用入口，通常只需要完成下面 3 件事。
登录 Dashboard 生成 skill_key
执行 clawhub install twtapi
把 TWTAPI_SKILL_KEY 写入环境变量或配置文件
为什么做成 Skill
把 API 变成可安装入口，上手会更直接
Skill 更适合那些不想直接对接接口、但又希望尽快开始使用 TwtAPI 能力的团队。
降低上手门槛
不需要先研究接口、鉴权和请求参数，安装后就可以直接调用。
安装后就能直接用
相比从文档和请求参数开始，Skill 更像一个可以马上装好就用的入口。
认证与主 API 隔离
skill_key 独立于主 API Key，适合把不同用途和权限边界分开管理。
适合 AI 执行流程
在兼容的 Skill 运行器里，AI 可以直接复用 TwtAPI 能力完成检索和执行。
适用场景
哪些场景更适合 Skill
如果目标是尽快用起来，而不是自己集成接口，Skill 的体验会更顺。
给非开发成员使用
如果团队成员只想直接使用能力，不想自己写请求代码或读 API 文档，Skill 会更合适。
内部工具快速分发
团队内部可以用统一的安装命令和配置模板，让不同成员更快开始使用 TwtAPI。
AI 执行与自动化流程
需要把 Twitter 数据能力接给 AI 执行器或自动化系统时，Skill 会更自然。
快速开始
3 步完成公开 Skill 安装
托管网关已经准备好，只需要拿到 key 并完成本地配置。
1. 登录生成 Skill Key
进入 Dashboard 的 Skill 标签页，生成或重置以 `tsk-` 开头的 skill_key。
2. 安装公开 Skill
在支持的环境里执行 `clawhub install twtapi`，安装公开的 TwtAPI Skill。
3. 写入配置并重启
把 `TWTAPI_SKILL_KEY` 写入环境变量或配置文件，然后重启 skill runner。
安装模板
照着这三段配置即可
下面的命令和配置片段可以直接作为公开 Skill 的安装模板。
安装命令
先安装公开的 `twtapi` Skill 包。
安装完成后，再补充 skill_key 配置即可开始使用。
clawhub install twtapi
环境变量
最简单的做法是把 skill_key 放到环境变量里。
把示例里的 `tsk-your-skill-key` 替换成 Dashboard 里生成的真实值。
export TWTAPI_SKILL_KEY="tsk-your-skill-key"
配置模板
如果客户端支持配置文件，也可以直接写入 Skill 配置。
把模板里的 key 替换后保存，再重启客户端或运行器。
{
"skills": {
"entries": {
"twtapi": {
"enabled": true,
"env": {
"TWTAPI_SKILL_KEY": "tsk-your-skill-key"
}
}
}
}
}常见问题
你可能会问
把 TwtAPI 作为可安装 Skill 接入 OpenClaw 等兼容客户端。公开 Skill 已内置托管网关，使用时只需要独立的 skill_key。
Skill 和 MCP 有什么区别？
MCP 更适合把工具暴露给支持 MCP 的 AI 客户端；Skill 更像一个可安装的使用形态，适合通过 skill runner 直接安装和调用。
需要自己托管网关吗？
不需要。当前公开 Skill 已内置官方托管网关，用户只需要自己的 skill_key。
为什么要单独用 skill_key？
因为它能把 Skill 的使用和主 API 凭证隔离开，便于权限控制、轮换和问题排查。