ClawdBot：パーソナルAIアシスタントの構築（2026）
ClawdBotのセットアップとカスタマイズに関するステップバイステップガイド
Hypereal AI TeamHyperealで構築を始めよう
Kling、Flux、Sora、Veoなどに単一のAPIでアクセス。無料クレジットで開始、数百万規模まで拡張可能。
クレジットカード不要 • 10万人以上の開発者 • エンタープライズ対応
ClawdBot: パーソナルAIアシスタントの構築 (2026年版)
ClawdBotは、日々のワークフローに合わせてカスタマイズ可能な、常駐型のAIコンパニオンを構築できるオープンソースのパーソナルAIアシスタントフレームワークです。タスク管理、ドキュメントの要約、コードの記述、あるいはルーチンワークの自動化など、ClawdBotはニーズに合わせたアシスタントを作成するためのビルディングブロックを提供します。
このガイドでは、ClawdBotをゼロからセットアップし、その挙動をカスタマイズして、お気に入りのツールやサービスと連携させる手順を説明します。
ClawdBotとは？
ClawdBotは、大規模言語モデル（LLM）をベースに構築されたモジュール式AIアシスタントフレームワークです。一般的なチャットボットとは異なり、ClawdBotはセルフホストが可能で、プライバシーを尊重し、深くカスタマイズできるように設計されています。性格、能力、統合する機能を自由に定義できます。
主な特徴
| 機能 | 説明 |
|---|---|
| マルチモデル対応 | Claude, GPT, Gemini、または Ollama を介したローカルモデルに接続可能 |
| プラグインシステム | 公式およびコミュニティ提供のプラグインで機能を拡張 |
| メモリ管理 | 設定可能な保持期間を持つ永続的な会話メモリ |
| ツール呼び出し（Tool calling） | シェルコマンド、API呼び出し、ファイル操作を実行 |
| マルチチャネル | Discord, Slack, Telegramへのデプロイ、または CLI での使用 |
| プライバシー優先 | データを完全に制御できるセルフホスト型 |
事前準備
開始する前に、以下が準備されていることを確認してください。
- Node.js 20+ がインストールされていること
- npm または pnpm パッケージマネージャー
- 1つ以上のLLMプロバイダーのAPIキー（Anthropic, OpenAI、または Ollama を介したローカルモデル）
- 操作に慣れているターミナル
ステップ 1: ClawdBotのインストール
リポジトリをクローンし、依存関係をインストールします。
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
環境設定ファイルの例をコピーします。
cp .env.example .env
ステップ 2: LLMプロバイダーの設定
.env ファイルを開き、API認証情報を追加します。ClawdBotは複数のプロバイダーを同時にサポートしているため、必要な数だけ設定できます。
# プライマリプロバイダー
ANTHROPIC_API_KEY=sk-ant-your-key-here
DEFAULT_MODEL=claude-sonnet-4-20250514
# オプション: セカンダリプロバイダー
OPENAI_API_KEY=sk-your-openai-key
OLLAMA_BASE_URL=http://localhost:11434
プロバイダー比較
| プロバイダー | 最適な用途 | コスト | レイテンシ |
|---|---|---|---|
| Anthropic Claude | 複雑な推論、コーディング | $3-15/1M tokens | 低い |
| OpenAI GPT-5 | 一般的なタスク、画像認識 | $2-30/1M tokens | 低い |
| Google Gemini | 長いコンテキスト、マルチモーダル | $1-7/1M tokens | 中程度 |
| Ollama (local) | プライバシー、オフライン使用 | 無料 (ハードウェア費用のみ) | 環境による |
ステップ 3: アシスタントの性格定義
ClawdBotは設定ファイルを使用してアシスタントの挙動を定義します。config/persona.yaml を作成または編集します。
name: "Atlas"
personality:
tone: professional
verbosity: concise
humor: subtle
instructions: |
あなたはパーソナル生産性アシスタントの Atlas です。
常に理論よりも実行可能なアドバイスを優先してください。
タスクについて尋ねられたら、まずタスクリストを確認してください。
役立つ場合は、回答を markdown 形式で構成してください。
capabilities:
- task_management
- code_review
- document_summary
- web_search
- calendar_integration
複数のペルソナファイルを作成し、切り替えて使用することも可能です。
clawdbot --persona config/persona-coding.yaml
clawdbot --persona config/persona-writing.yaml
ステップ 4: プラグインの追加
プラグインを使用してClawdBotの機能を拡張します。プラグインレジストリからインストールします。
# タスク管理プラグイン
clawdbot plugin add @clawdbot/tasks
# Web検索プラグイン
clawdbot plugin add @clawdbot/web-search
# カレンダー連携
clawdbot plugin add @clawdbot/google-calendar
# コード実行サンドボックス
clawdbot plugin add @clawdbot/code-runner
各プラグインの設定は config/plugins.yaml で行います。
plugins:
tasks:
storage: sqlite
db_path: ./data/tasks.db
web-search:
provider: tavily
api_key: ${TAVILY_API_KEY}
google-calendar:
credentials_path: ./config/google-credentials.json
code-runner:
languages: [python, javascript, bash]
timeout: 30s
sandbox: docker
ステップ 5: メモリとコンテキストの設定
ClawdBotは過去の会話を記憶し、将来のやり取りで参照できます。config/memory.yaml でメモリ設定を行います。
memory:
enabled: true
backend: sqlite
db_path: ./data/memory.db
retention:
conversations: 90d
facts: permanent
preferences: permanent
context_window:
max_messages: 50
summary_threshold: 30
会話が summary_threshold を超えると、ClawdBotはトークン制限内に収めつつコンテキストを維持するために、古いメッセージを自動的に要約します。
ステップ 6: チャネルへのデプロイ
CLI モード (デフォルト)
ターミナルでClawdBotを起動します。
clawdbot start
これでターミナル上で直接チャットが可能です。
You: 今日のタスクを要約して
Atlas: 本日の未完了タスクは3件あります。
1. PR #142 のレビュー - フロントエンドのリファクタリング (期限: 午後2時)
2. /users エンドポイントの API ドキュメント作成
3. 木曜日のスタンドアップ用スライドの準備
Discord ボット
.env に Discord の認証情報を追加します。
DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=123456789
Discord モードで起動します。
clawdbot start --channel discord
Slack ボット
SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
SLACK_SIGNING_SECRET=your-signing-secret
clawdbot start --channel slack
ステップ 7: カスタムツールの作成
会話中にClawdBotが呼び出せるカスタムツールを定義できます。tools/ ディレクトリにツールファイルを作成します。
// tools/check-website-status.ts
import { defineTool } from '@clawdbot/sdk';
export default defineTool({
name: 'check_website_status',
description: 'ウェブサイトが稼働しているか確認し、HTTPステータスコードを返します',
parameters: {
url: {
type: 'string',
description: '確認するURL',
required: true,
},
},
async execute({ url }) {
const response = await fetch(url, { method: 'HEAD' });
return {
url,
status: response.status,
ok: response.ok,
latency: response.headers.get('x-response-time'),
};
},
});
設定ファイルにツールを登録します。
tools:
custom:
- ./tools/check-website-status.ts
- ./tools/deploy-preview.ts
実用的な自動化の例
モーニングブリーフィング
毎日ブリーフィングを受け取るための cron ジョブを設定します。
# crontab エントリ - 毎日午前8時に実行
0 8 * * * clawdbot run "モーニングブリーフィングをお願い：今日のカレンダー、未完了タスク、天気の要約" --output ./briefing.md
PRレビューの自動化
# CIパイプライン内での使用
gh pr diff $PR_NUMBER | clawdbot run "このプルリクエストのdiffをレビューしてください。潜在的なバグ、セキュリティ上の問題、スタイルの問題を指摘してください。簡潔に。"
ドキュメント要約パイプライン
# フォルダ内のすべてのPDFを要約する
for file in ./documents/*.pdf; do
clawdbot run "このドキュメントを3つの箇条書きで要約して" --attach "$file" >> summaries.md
done
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| "API key not found" | .env ファイルに正しいキーが設定され、変数名が一致しているか確認してください |
| メモリデータベースがロックされている | すべての ClawdBot インスタンスを停止してから再起動してください |
| プラグインの読み込み失敗 | clawdbot plugin update を実行し、バージョンの互換性を確認してください |
| レスポンスが遅い | より高速なモデルに切り替えるか、単純なタスクにはローカルの Ollama モデルを使用してください |
| コンテキストが長すぎる | メモリ設定の max_messages を減らすか、自動要約を有効にしてください |
ClawdBotを最大限に活用するためのヒント
- ペルソナの指示を具体的にする。 アシスタントにどのように振る舞ってほしいか、より多くのコンテキストを与えるほど、結果は向上します。
- 複数のペルソナを使い分ける。 コーディング用、執筆用、プライベート用など、用途別に設定を作成しましょう。
- ツールチェーンを活用する。 ClawdBotは複雑なタスクを遂行するために、複数のツールを連続して呼び出すことができます。
- 定期的にメモリを見直す。 ClawdBotが記憶している事実を確認し、古い情報があれば修正しましょう。
- まずは CLI モードから始める。 Discord や Slack にデプロイする前に、基本機能に慣れておきましょう。
結論
ClawdBotは、自身のワークフローに完全に適合するAIアシスタントを構築するための柔軟性を提供します。シンプルなタスク管理から複雑なマルチツール自動化まで、モジュール式のアーキテクチャにより、小規模に始めて必要に応じて拡張していくことができます。
AIを活用したプロジェクトに取り組んでおり、画像生成、ビデオ作成、その他のメディアタスクのための信頼性の高いインフラが必要な場合は、Hypereal AI が ClawdBot のようなツールとシームレスに統合できる製品レベルの API を提供しています。パーソナルアシスタントのセットアップに強力なメディア生成機能を追加するために、ぜひチェックしてみてください。