OpenClawを使って30分でSaaSをあらゆる形のTelegramボットにする方法

Dev.to / 2026/4/20

💬 オピニオンDeveloper Stack & InfrastructureTools & Practical UsageModels & Research

要点

  • この記事は、OpenClawを使ってほぼどんなSaaSでも約30分でTelegramボット化できると説明しており、ユーザーがブラウザを開いてログインする手間を減らすことを目的としています。
  • 作るボットの特徴として、プロダクト固有の「声」(汎用的なChatGPTではない)、ドメイン知識の組み込み、絵文字や太字などのブランドに沿ったフォーマット、さらに実API呼び出しへの拡張が挙げられています。
  • 著者は、OpenClawがTelegramのAIボット開発で通常必要になる手間(Webhookホスティング、botフレームワーク、プロンプト/メモリ管理、レート制限、デプロイ)を単一のMITライセンスのAIエージェント実行環境として置き換えると主張しています。
  • ガイドは、Dockerの導入、OpenClawのコンテナイメージの取得、そしてTelegramボットの作成/設定から始まる手順を提示しています。
  • 低い参入障壁として、必要なのはDockerとOpenAIまたはAnthropicのAPIキーで、主な費用はDockerとAPIクレジットだと位置づけています。

これは DEV OpenClaw Challenge 2026:知の富への投稿です

SaaSの創業者が必ず直面する問題

あなたは美しいWebアプリを作りました。ユーザーは気に入っています。しかし摩擦は現実です。ユーザーはブラウザを開き、あなたのサイトへ移動し、ログインしてから、ようやくあなたの製品を使えるのです。

もし、Telegramでメッセージを送れるだけだったらどうでしょう?

先週、私の食事計画SaaS MealAI に、OpenClaw を使ってTelegramのインターフェースを追加しました。かかったのは30分です。Webhookのホスティングは不要。学ぶべきボットフレームワークも不要。カスタムAPIの結合コードも不要でした。

ここでは、私が実際にやった手順をそのまま説明し、あなたのSaaSでも同じことができるようにします。

あなたが作るもの

作るのは、以下を行うTelegramボットです:

  • (汎用のChatGPTではなく)あなたのプロダクトの“声”で話す
  • あなたのプロダクトのドメイン専門知識が組み込まれている
  • 絵文字・太字・構造など、ブランドに沿った形式で返信する
  • 実際のAPI呼び出しに拡張できる

所要時間:30分
費用:無料(Docker + OpenAI APIクレジット)
前提条件:Dockerの基本知識、OpenAIまたはAnthropicのAPIキー

なぜOpenClaw?

OpenClaw以前は、TelegramのAIボットを作るには:

  • Node.jsのバックエンド(grammYまたはtelegraf)
  • ホストされたWebhookエンドポイント
  • カスタムのプロンプト管理
  • セッションとメモリの取り扱い
  • レート制限ロジック
  • デプロイのパイプライン

OpenClawは、これらすべてを1つのバイナリで処理する、MITライセンスのAIエージェント実行環境です。25以上のメッセージングプラットフォーム(Telegram、WhatsApp、Discord、Slack、Signal、iMessageなど)に対応しています。あなたのエージェントはコード変更なしでそれらのどれでも動作します。

それは、メッセージングのためのAIエージェント版WordPressだと思ってください。

ステップ1:Dockerをインストール(2分)

macOSの場合はOrbStackをおすすめします。Docker Desktopより軽量です。

brew install --cask orbstack
open -a OrbStack

LinuxまたはWindowsではDocker Desktopを使います。
動作確認:


bash
docker --version

ステップ2:OpenClawをプル(2分)

作業ディレクトリを作成します:

mkdir mealai-concierge && cd mealai-concierge

事前ビルド済みイメージをプル:


bash
docker pull ghcr.io/openclaw/openclaw:latest

ステップ3:Telegramボットを作成(3分)

  1. Telegramを開き、@botfatherを検索
  2. /newbotを送信
  3. 名前とユーザー名を選択(必ず _bot で終わる必要があります)
  4. HTTP APIトークンをコピー あなたのボットURLは t.me/your_bot_username になります。 ## ステップ4:OpenClawを設定(5分) docker-compose.ymlを作成:
services:
openclaw-gateway:
image: ghcr.io/openclaw/openclaw:latest
environment:
HOME: /home/node
TZ: UTC
volumes:
- ./openclaw-config:/home/node/.openclaw
- ./openclaw-workspace:/home/node/.openclaw/workspace
ports:
- "18789:18789"
- "18790:18790"
init: true
restart: unless-stopped
command:
- node
- dist/index.js
- gateway
- --bind
- lan
- --port
- "18789"

openclaw-config/openclaw.jsonを作成:


json
{
"gateway": {
"mode": "local"
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_TELEGRAM_BOT_TOKEN_HERE",
"dmPolicy": "open",
"allowFrom": ["*"]
}
},
"agents": {
"defaults": {
"model": "openai/gpt-4o-mini"
}
}
}

openclaw-config/agents/main/agent/auth-profiles.jsonを作成:

{
"version": 1,
"profiles": {
"openai:default": {
"type": "api_key",
"provider": "openai",
"key": "sk-YOUR_OPENAI_KEY_HERE"
}
}
}

## ステップ 5 秘密のソース、 SOUL.md (10分)
これは 汎用の チャットボットを、 あなたの製品の 声に変える場所です。
openclaw-workspace/SOUL.md: を作成します:


markdown
SOUL.md MealAI Concierge
返却形式: {"translated": "翻訳されたHTML"}

あなたはMealAIコンシェルジュです。気の利いたAIの食事計画アシスタントです。

あなたの役割
忙しい人が「夕飯なに?」に答え、1週間の予定を立てられるように支援します。

パーソナリティ
あたたかく、会話的で、簡潔
食べ物についてははっきり言う(言いよどまない)
完璧より実用的に
人は現実の食べ物を食べます
あなたが得意なこと
食事プランを提案(1日 or 1週間)
買い物リストを店舗の区分ごとに整理して作成
好みに合わせる(ベジタリアン、予算重視、高たんぱく、気難しい子ども)
栄養をシンプルに説明
レシピは要点だけ、材料+5ステップで
レスポンス形式
太字で料理名
絵文字は控えめ(サラダ、パスタ、朝食)
詳細を求められない限り200語未満
ルール
「Great question!」から始めないで、すぐ答える
話題が逸れたら誘導する:「それは私のキッチンの外だ!」
必ず最後にフォローアップで締める:「買い物リストも欲しい?」
フル機能にはusemealai.comを使う旨を言及する
なぜSOUL.mdは強力なのか:
OpenClawは、毎回の会話においてシステムプロンプトのレベルでこれを注入します。モデルはユーザーメッセージの前に、常にこれらの指示を見ています。そのため、パーソナが一貫します。これは微調整ではなく、適切なアーキテクチャ層でのプロンプトエンジニアリングです。

Step 6: Start It Up(1分)

docker compose up -d

ログを確認:


bash
docker compose logs -f openclaw-gateway

次が表示されるはずです:
[telegram] [default] starting provider (@YourBotName_bot)

Step 7: Test It(2分)

Telegramを開き、ボットを見つけてこう言ってください:

  • 「こんにちは、あなたは誰?」
  • 「今夜の夕飯は何?」
  • 「私はベジタリアン。1週間の献立を計画して」 あなたのプロダクトとして返ってくるのを見てください。ChatGPTとしてではありません。 ## 魔法の正体 ここからは、OpenClawが裏側で何をしているかです: ユーザーメッセージ(Telegram) -> OpenClaw Gateway(Telegram APIのロングポーリング) -> システムプロンプトの組み立て:

あなたのSOUL.md(パーソナ)
あなたのIDENTITY.md(名前、雰囲気)
会話履歴
->
OpenAI gpt-4o-miniにルーティング
->
レスポンスをTelegram API経由で返す
あなたはボットフレームワークのコードを一行も書いていません。統合のためのレイヤー全体が、1つのSOUL.mdファイルです。

次のレベルの動き

基本が動き出したら、次を積み重ねできます:

カスタムスキルを追加(あなたの本物のAPIを呼ぶ)

あなたのSaaSデータベースから本物の献立を取得するOpenClawスキルを作りましょう。OpenClawにはプラグインSDKがあり、エージェントがユーザーのメッセージを見て、いつあなたのAPIを呼ぶかを判断できるようになっています。

1行でマルチチャネル

同じボットをWhatsApp、Discord、Signalでも使いたいですか?チャネルにもう1つ追加するだけです:


json
"channels": {
"telegram": { "enabled": true, "botToken": "..." },
"discord": { "enabled": true, "botToken": "..." },
"whatsapp": { "enabled": true }
}

1つのコードベース。すべてのプラットフォーム。
### 永続的なメモリ
openclaw-workspaceディレクトリは、あなたのボットの長期メモリです。ユーザーの嗜好、FAQ、プロダクト知識などをmarkdownファイルで置いてください。OpenClawがそれらを必要に応じて文脈的に取り込みます。
### 管理UIダッシュボード
OpenClawには、http://localhost:18789 にウェブダッシュボードが付属しています。ここで次ができます:
* すべての会話をリアルタイムで見る
* APIコストを監視する
* プロンプトをデバッグする
* モデルを切り替える
## 学び
1. プロンプトこそがプロダクトです。SOUL.mdは単なる指示ではありません。デモと、使いたいと思われるプロダクトの違いです。
2. メッセージングはウェブアプリに勝ちます。ユーザーはTelegramを開きません。常に開いているのです。そうすれば、あなたのSaaSは摩擦がゼロになります。
3. オープンソースのAIランタイムは準備ができています。OpenClawは、認証、レート制限、ログ、多チャネルといった本番向けの懸念を最初から面倒を見てくれます。
4. Dockerで十分です。Kubernetesも、サーバーレスも不要。docker compose up するだけ。
## リポジトリ
完全に動くセットアップ(シークレットは一切なし):

GitHub ロゴ shopsmartai / mealai-concierge

Telegram経由のAI食事計画コンシェルジュ。DEV OpenClaw Challenge 2026向けにOpenClawで構築。

MealAI Concierge

あなた専用のAI食事計画アシスタント—Telegramの中にあります。

OpenClawShopSmartAI によって構築。DEV OpenClaw Challenge 2026 用です。

稼働中: usemealai.com

できること

Telegramで「夕飯なに?」と聞くと、次が返ってきます:

  • パーソナライズされた週間の食事プラン
  • 店舗の区分ごとに整理された買い物リスト
  • 食事の調整(ベジタリアン、グルテンフリー、予算重視など)
  • 材料+手順付きのクイックレシピ

アーキテクチャ

ユーザー → Telegram → OpenClaw Gateway → OpenAI (gpt-4o-mini) → レスポンス
                         ↓
                   カスタムSOUL.md
                   (MealAI Conciergeのパーソナ)

クイックスタート

1. 前提条件

2. セットアップ

# このリポジトリをクローン
git clone https://github.com/shopsmartai/mealai-concierge.git
cd mealai-concierge
# 例のファイルをコピー
cp .env.example .env
cp openclaw.json.example openclaw-config/openclaw.json

# .envをOpenAIキーで編集
# openclaw.jsonをTelegramボットトークンで編集

# パーソナファイルをworkspaceにコピー
mkdir -p openclaw-workspace
cp SOUL.md IDENTITY.md openclaw-workspace/

#

クローンしてトークンを追加すれば、10分で動く食事ボットが手に入ります。SOUL.mdをあなたのプロダクトのドメインに置き換えれば、あなたのSaaSをTelegramボットに変えられます。

実際に見る

ライブボットを試す: t.me/Usemealai_bot
返却形式: {"translated": "翻訳されたHTML"}MealAIをチェック:usemealai.com
役に立ったなら、ハートを付けて、OpenClawでラップしてみたいSaaSが何か教えてください。あなたが作るものをぜひ見てみたいです。