可安装 Skill
把 TwtAPI 交付成用户可直接安装的 Skill
如果用户不想从 API 文档和脚本开始，你可以直接给他们一个可安装的 Skill。托管网关已经准备好，用户只需要登录生成 skill_key，然后在 OpenClaw 或兼容运行器里完成安装。
安装流程很短
公开 Skill 负责托管调用入口，用户侧通常只需要完成下面 3 件事。
登录 Dashboard 生成 skill_key
执行 clawhub install twtapi
把 TWTAPI_SKILL_KEY 写入环境变量或配置文件
为什么做成 Skill
把 API 变成可安装入口，会更容易成交和交付
Skill 更适合那些不想直接对接接口、但又希望马上开始使用 TwtAPI 能力的用户。
降低上手门槛
用户不需要先研究接口、鉴权和请求参数，安装后就可以直接调用。
交付更像产品
相比“给你一份 API 文档”，Skill 更像一个可以立即使用的产品入口。
认证与主 API 隔离
skill_key 独立于主 API Key，适合把不同用途和权限边界分开管理。
适合 Agent 工作流
在兼容的 skill runner 里，AI 可以直接复用 TwtAPI 能力完成检索和执行。
适用场景
哪些场景更适合 Skill
如果目标是让用户尽快用起来，而不是自己集成接口，Skill 的体验会更顺。
面向非开发用户交付
用户只想使用能力，不想自己写请求代码或读 API 文档时，Skill 会更合适。
内部工具快速分发
团队内部可以用统一的安装命令和配置模板，把 TwtAPI 能力分发给不同成员。
Agent 与自动化工作流
需要把 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 凭证隔离开，便于权限控制、轮换和问题排查。