インストール可能な Skill
TwtAPI をすぐ導入できる Skill として届ける
ユーザーに API ドキュメントやリクエスト実装から始めさせたくないなら、インストール可能な Skill として渡す方が簡単です。ホスト gateway はすでに用意されているため、skill_key を生成して OpenClaw や互換 runner で短い設定をするだけで始められます。
セットアップは短時間です
公開 Skill がホスト入口を処理するので、通常は次の 3 ステップだけで十分です。
Dashboard で skill_key を生成
clawhub install twtapi を実行
TWTAPI_SKILL_KEY を環境変数または設定に追加
Skill を使う理由
API をインストール可能な入口にすると導入が進みやすい
まず API を統合するのではなく、すぐに TwtAPI を使いたいユーザーには Skill の方が向いています。
導入ハードルが低い
最初に必要なのは実装ではなくインストールと設定だけなので、開始が速くなります。
製品として渡しやすい
素の API リファレンスよりも、使い始められる入口として説明しやすくなります。
認証を分離できる
専用の skill_key を使うことで、メイン API 資格情報と用途を分けて管理できます。
Agent ワークフロー向け
互換 runner では TwtAPI の機能を agent や自動化フローから直接使えます。
向いている場面
生の API より Skill が向いているケース
目的が素早い利用開始であり、独自統合ではない場合は Skill の方が自然です。
非開発者への提供
API 実装ではなく機能そのものを使いたいユーザーには Skill の方がわかりやすいです。
社内展開
インストールコマンドと設定テンプレートを共有するだけで、複数メンバーに広げられます。
Agent / 自動化基盤
runner や automation から Twitter データ機能を使いたいとき、Skill 形式は相性が良いです。
クイックスタート
公開 Skill は 3 ステップで導入できます
gateway 層はすでにホストされているので、ユーザー側は key と短いローカル設定だけです。
1. Skill Key を生成
Dashboard の Skill タブで `tsk-` から始まる skill_key を生成または更新します。
2. 公開 Skill をインストール
対応環境で `clawhub install twtapi` を実行して公開 Skill を導入します。
3. 設定して再起動
`TWTAPI_SKILL_KEY` を環境変数または設定ファイルに追加し、runner を再起動します。
セットアップテンプレート
通常はこの 3 つの断片で十分です
公開 Skill の標準セットアップとして、そのままユーザーに渡せます。
インストールコマンド
まず公開 `twtapi` Skill パッケージをインストールします。
その後に生成した skill_key を設定して、クライアントまたは runner を再起動します。
clawhub install twtapi
環境変数
もっとも簡単なのは skill_key を環境変数に入れる方法です。
`tsk-your-skill-key` を Dashboard の実際の値に置き換えてください。
export TWTAPI_SKILL_KEY="tsk-your-skill-key"
設定テンプレート
設定ファイル方式のクライアントなら Skill エントリを直接書けます。
例の key を置き換えて保存したら、runner を再起動してください。
{
"skills": {
"entries": {
"twtapi": {
"enabled": true,
"env": {
"TWTAPI_SKILL_KEY": "tsk-your-skill-key"
}
}
}
}
}よくある質問
よくある質問
TwtAPI を OpenClaw や互換 runner 向けのインストール可能な Skill として提供できます。公開 Skill にはホスト gateway が含まれているため、必要なのは専用の skill_key だけです。
Skill と MCP の違いは何ですか？
MCP は MCP 対応 AI クライアント向けです。Skill は skill runner 向けの、より配布しやすいインストール形式です。
gateway を自分でホストする必要はありますか？
ありません。公開 Skill にはすでに公式の hosted gateway が含まれているため、必要なのは自分の skill_key だけです。
なぜ専用の skill_key を使うのですか？
メイン API 資格情報と切り分けられるので、ローテーション、権限制御、トラブルシュートがしやすくなります。
いきなり API 統合を求める前に、まずはインストール可能な入口を用意する
立ち上がりを速くしたいなら、初日から API ドキュメントを渡すより公開 Skill の方が採用されやすいことが多いです。