OpenFang インストールおよび初期化ガイド：ゼロから最初のAgent起動まで

Slug: openfang-install-setup-guide カテゴリ: usage-guides (使用ガイド) ターゲットキーワード: OpenFang インストール, OpenFang 設定チュートリアル, OpenFang 入門ガイド 検索意図: 情報収集（OpenFangのデプロイ方法を知りたい） 目標文字数: 約1800文字言語: ja

OpenFangとは？

OpenFangは、Rustで構築されたプロダクションレベルのAgent OSです。従来のAIチャットフレームワークとは異なり、OpenFangは完全なAgentランタイム環境を提供します。180msのコールドスタート、40MBのメモリ消費、16層のセキュリティ保護、40種類以上のチャネルアダプターを備えています。ローカルでの単純な自動化タスクから、7×24時間稼働するクロスプラットフォームの自律型Agentクラスターの構築まで、OpenFangなら実現可能です。

本記事では、OpenFangのインストールから初期化、そして最初のAgentを動かすまでをゼロから解説します。

システム要件

インストールを始める前に、システムが以下の最低要件を満たしていることを確認してください：

コンポーネント	最低要件	推奨構成
OS	Linux / macOS / Windows (WSL2)	Ubuntu 22.04+
メモリ	512 MB	2 GB+
ディスク容量	100 MB	1 GB+
ランタイム	Rust 1.75+	Rust 1.80+
ネットワーク	HTTPSアウトバウンド通信	安定したインターネット接続

OpenFangの設計哲学は「軽量性優先」です。Raspberry Pi 4（4GBモデル）でもスムーズに動作します。

ステップ1：Rustツールチェーンのインストール

OpenFangはRustで記述されているため、まずはRustツールチェーンをインストールする必要があります：

# Rustup（Rustツールチェーンマネージャー）のインストールcurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh# 環境変数の再読み込みsource "$HOME/.cargo/env"# インストールの確認rustc --versioncargo --version

すでにRustがインストールされている場合は、最新の安定版に更新することをお勧めします：

rustup update stable

ステップ2：OpenFangのインストール

OpenFangには複数のインストール方法がありますが、Cargoを使用した直接インストールを推奨します：

# crates.ioから最新バージョンをインストールcargo install openfang# インストールの確認openfang --version

ソースコードからビルドしたい場合（高度なカスタマイズが必要なユーザー向け）：

git clone https://github.com/openfang/openfang.gitcd openfangcargo build --release./target/release/openfang --version

Dockerユーザーは公式イメージも利用可能です：

docker pull openfang/openfang:latestdocker run -d --name openfang -v ./config:/app/config openfang/openfang

ステップ3：設定の初期化

インストール完了後、初期化コマンドを実行して設定ファイルを作成します：

# デフォルト設定ディレクトリの作成openfang init# 設定ファイルの場所# Linux/macOS: ~/.config/openfang/config.toml# Windows:     %APPDATA%\openfang\config.toml

初期化後に生成される config.toml ファイルの主要な設定項目は以下の通りです：

[core]name = "my-first-agent"          # Agent名workspace = "./workspace"         # 作業ディレクトリlog_level = "info"                # ログレベル: trace, debug, info, warn, error[claude]api_key = "${ANTHROPIC_API_KEY}"  # 環境変数から読み込みmodel = "claude-sonnet-5"         # デフォルトモデルmax_tokens = 4096[security]sandbox_mode = "strict"           # サンドボックスモード: off, basic, strictnetwork_policy = "allowlist"      # ネットワークポリシーallowed_domains = ["api.anthropic.com"][channels]# 少なくとも1つのチャネルアダプターを設定してください

重要な設定のポイント：

api_key：環境変数参照（${VAR_NAME} 形式）をサポートしています。設定ファイルに直接APIキーを書き込まないでください。
sandbox_mode：本番環境では strict モードを推奨します。
network_policy：allowlist モードはホワイトリストに登録されたドメインのみアクセスを許可し、blocklist モードはブラックリストのドメインをブロックします。
channels：少なくとも1つのチャネルアダプターが必要です。設定しないとAgentは外部と通信できません。

ステップ4：Anthropic API Keyの設定

OpenFangはClaude API（Anthropic経由）に依存しているため、APIキーの設定が必要です：

# 環境変数の設定export ANTHROPIC_API_KEY="sk-ant-..."# シェルの設定ファイルに追記することを推奨echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrcsource ~/.bashrc

APIキーは Anthropic Console から取得できます。

ステップ5：チャネルアダプターの選択と設定

OpenFangは40種類以上のチャネルアダプターをサポートしており、様々なプラットフォームでAgentと対話可能です。よく使われるものは以下の通りです：

アダプター	用途	設定難易度
CLI	コマンドライン対話	⭐
WhatsApp	WhatsApp経由でのAgent利用	⭐⭐
Telegram	Telegram Bot統合	⭐⭐
Discord	Discord Bot統合	⭐⭐⭐
Slack	Slackワークスペース統合	⭐⭐⭐
Web Chat	Webチャットウィジェット	⭐⭐

Telegramを例にしたチャネル設定：

[channels.telegram]enabled = truebot_token = "${TELEGRAM_BOT_TOKEN}"allowed_users = ["@your_username"]

ステップ6：最初のAgentを起動する

設定が完了したら、Agentを起動します：

# 基本的な起動openfang start# 設定ファイルを指定して起動openfang start --config ./my-config.toml# バックグラウンド実行openfang start --daemon# 実行ログの確認openfang logs --follow

起動に成功すると以下のように表示されます：

⚡ OpenFang v1.0.0├─ Agent: my-first-agent├─ Model: claude-sonnet-5├─ Sandbox: strict├─ Channels: cli└─ Ready. Type /help for commands.

CLIチャネルでは、直接Agentと対話できます：

> /help> 今日の天気を調べて> このGitHubリポジトリのコード構造を分析して

ステップ7：インストールの検証

組み込みの診断コマンドを実行して、すべてが正常か確認します：

# ヘルスチェックopenfang doctor# 以下のような出力が表示されればOKです：# ✅ Rust toolchain: 1.80.0# ✅ Config file: valid# ✅ API key: configured# ✅ Network: ok (latency 45ms)# ✅ Workspace: writable# All checks passed.

よくある質問

インストール時に "error: linker `cc` not found" と表示される場合は？

Cコンパイラが不足していることが原因です。Ubuntu/Debianの場合は以下を実行してください：

``bash sudo apt update && sudo apt install build-essential`

macOSの場合はXcode Command Line Toolsをインストールしてください：

`bash xcode-select --install``

起動時に "API key not configured" というエラーが出る場合は？

以下の点を確認してください：
1. 環境変数 ANTHROPIC_API_KEY が設定されているか確認：echo $ANTHROPIC_API_KEY
2. 設定ファイルで "${ANTHROPIC_API_KEY}" 形式（引用符付き）で参照しているか確認
3. 設定ファイルを再読み込み：openfang reload

Raspberry PiでOpenFangを動かすには？

OpenFangの軽量設計はARMアーキテクチャに最適です：

``bash # Raspberry PiにRustをインストール curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 依存関係のインストール sudo apt install libssl-dev pkg-config

# コンパイルインストール（ARM最適化） cargo install openfang --features arm-optimized``

Raspberry Pi 4（4GB）であれば、3〜5個の軽量Agentを同時に実行可能です。

設定ファイルにYAMLは使えますか？

現在はTOML形式のみサポートしています。必要に応じて、オンラインツール等でYAMLをTOMLに変換してください。

OpenFangを最新バージョンにアップグレードするには？

bash
cargo install openfang --force
openfang migrate  # 設定フォーマットに変更がある場合

次のステップ

OpenFangのインストールと初期化、お疲れ様でした！次は以下を参考にしてください：

OpenFang Hands 設定ガイド：Agentの機能モジュールを用途別に設定する方法
OpenFang マルチチャネルアダプター設定：複数のチャネルを同時に設定し、Agentをどこでも利用可能にする方法
OpenFang セキュリティベストプラクティス：Agentを攻撃から守るための対策