OpenClaw + Feishu - EvoLink.AI

概要

OpenClaw は、チャットアプリケーションと AI エージェントの橋渡しをするオープンソースの AI エージェント Gateway です。集中型 Gateway プロセスを通じて、Telegram、WhatsApp、Discord、Feishu（Lark）などのチャットプラットフォームを AI コーディングエージェントに接続し、チャットウィンドウ内で直接 AI プログラミングのやり取りを可能にします。 OpenClaw で EvoLink API をカスタムモデルプロバイダーとして設定し、Feishu Bot を接続することで、EvoLink の Claude モデル（Claude 4.6 Opus、Claude 4.5 Sonnet、Claude 4.5 Haiku など）を使用して、Feishu 上で直接 AI アシスタントとのコーディング会話ができます。 Feishu チャネルは WebSocket ロングコネクション モードでメッセージを受信するため、パブリック URL は不要です。 本ガイドの内容：

OpenClaw Gateway のインストールと設定
ボット機能を持つ Feishu エンタープライズアプリケーションの作成
EvoLink API をカスタムモデルプロバイダーとして設定
接続の確認と利用開始

システム環境チェック

インストールを開始する前に、環境チェックツールを実行して、システムが OpenClaw の要件を満たしていることを確認することをお勧めします。

チェックツールのダウンロード

GitHub Releases からプラットフォームに対応したチェックツールをダウンロードしてください：

プラットフォーム	ファイル名
Windows	`openclaw-checker-win-x64.exe`
macOS (Intel)	`openclaw-checker-macos-x64`
macOS (Apple Silicon)	`openclaw-checker-macos-arm64`
Linux	`openclaw-checker-linux-x64`

チェック項目

ツールは以下の条件を自動的にチェックします：

✅ Node.js バージョン（>= 22.12.0 が必要）
✅ npm が利用可能
✅ Git が利用可能
✅ ネットワーク接続性（github.com、npmjs.org、evolink.ai）

チェックに失敗した場合、ツールは具体的な修正提案を提供します。

前提条件

設定を始める前に、以下を準備してください：

1. Node.js のインストール

OpenClaw は npm 経由でインストールされ、Node.js 22 以上が必要です。

Windows
macOS

Node.js 公式サイトにアクセスし、Windows インストーラー（.msi ファイル）をダウンロードして実行します。インストール後、PowerShell を開いて確認します：

node --version
npm --version

インストール中の権限問題を避けるため、管理者権限で PowerShell を実行することをお勧めします。

方法 1：インストーラーを使用Node.js 公式サイトにアクセスし、macOS インストーラー（.pkg ファイル）をダウンロードして実行します。方法 2：Homebrew を使用

brew install node

インストール後、ターミナルを開いて確認します：

node --version
npm --version

インストール中に権限問題が発生した場合は、コマンドの前に sudo を追加する必要があるかもしれません。

2. EvoLink API キーの取得

EvoLink Dashboard にログイン
ダッシュボードで API Keys を見つけ、「新しいキーを作成」ボタンをクリックし、生成されたキーをコピー
API キーは通常 sk- で始まります

3. Feishu アカウントの準備

Feishu Open Platform でアプリケーションを作成するには、Feishu エンタープライズアカウントが必要です。

ステップ 1：OpenClaw のインストール

ターミナルで以下のコマンドを実行します：

npm install -g openclaw@latest

Feishu プラグインをインストールします：

openclaw plugins install @openclaw/feishu

ステップ 2：オンボーディング

オンボーディングコマンドを実行します。OpenClaw が初期設定をガイドし、バックグラウンドデーモンサービスをインストールします：

openclaw onboard --install-daemon

1. インストールの確認

システムがリスク免責事項を表示します。確認して続行してください：

2. インストールモードの選択

インストールモードの選択を求められたら、Quickstart を選択します：

3. プロバイダーの選択

モデルプロバイダーの選択を求められたら、Skip を選択します。後ほど EvoLink をカスタムプロバイダーとして手動で設定します：

4. モデルの選択

有効にするモデルの選択を求められたら、All を選択します：

5. デフォルトモデルの選択

デフォルトモデルの選択を求められたら、Keep current を選択します：

ステップ 3：Feishu アプリケーションの作成

1. Feishu Open Platform にログイン

Feishu Open Platform にアクセスし、Feishu アカウントでログインします。

Lark（国際版）の場合は、https://open.larksuite.com/app を使用し、設定で domain: "lark" を指定してください。

2. アプリケーションの作成

企業自作アプリケーションを作成 をクリックし、アプリケーション名と説明を入力して、アイコンを選択します。

3. 認証情報の取得

認証情報と基本情報 ページで、以下をコピーします：

App ID（形式：cli_xxx）
App Secret

App Secret は安全に保管してください。他人と共有しないでください。

4. 権限の設定

権限管理 ページで、一括インポート をクリックし、以下の JSON を貼り付けて必要な権限をすべてインポートします：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

5. ボット機能の有効化

左サイドバーで アプリ機能 をクリックし、ボット カードを見つけて、メニューステータス を有効に切り替えます。有効にしたら、ボット名と説明を入力します。ユーザーが Feishu でボットを検索したりチャットしたりする際に、これらの情報が表示されます。

6. イベントサブスクリプションの設定

イベントサブスクリプションを設定する前に、以下を確認してください：

Feishu チャネルの設定が完了していること（ステップ 4 を参照）
Gateway が実行中であること（openclaw gateway status で確認）

イベントサブスクリプション ページで：

ロングコネクションでイベントを受信 を選択（WebSocket モード）
イベントを追加：im.message.receive_v1（メッセージ受信）

Gateway が実行されていないか、チャネルが追加されていない場合、ロングコネクションの設定は保存に失敗します。

7. アプリケーションの公開

バージョン管理とリリース に移動し、バージョンを作成して、審査に提出し公開します。エンタープライズ自作アプリケーションは通常、自動的に承認されます。

ステップ 4：OpenClaw の設定

OpenClaw の設定は ~/.openclaw/openclaw.json に集約されています。主な設定領域は 3 つあります：

plugins.entries.* — 読み込むプラグインを制御
channels.* — チャネル接続とアカウント認証情報を制御
models.providers.* — モデルプロバイダーを制御

1. Feishu チャネルの追加

手動設定
CLI コマンド

~/.openclaw/openclaw.json を開きます：Feishu プラグインを有効にします（plugins.entries）：

"plugins": {
  "entries": {
    "feishu": {
      "enabled": true
    }
  }
}

Feishu チャネルの認証情報を設定します（channels.feishu）：

"channels": {
  "feishu": {
    "enabled": true,
    "dmPolicy": "pairing",
    "accounts": {
      "main": {
        "appId": "cli_xxx",
        "appSecret": "your-app-secret",
        "botName": "My AI Assistant"
      }
    }
  }
}

Feishu の認証情報は channels.feishu.accounts の下に配置する必要があります。plugins.entries.feishu の下ではありません。間違った場所に配置すると Unrecognized key エラーが発生します。

環境変数で設定することもできます：

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

以下のコマンドを実行し、Feishu を選択して、プロンプトに従って App ID と App Secret を入力します：

openclaw channels add

新しいバージョンの OpenClaw では、このコマンドに設定の競合が発生する場合があります。手動設定を推奨します。

2. EvoLink API の設定

同じ openclaw.json で、models フィールドを見つけて、EvoLink をカスタムモデルプロバイダーとして追加します：

"models": {
  "providers": {
    "evolink-anthropic": {
      "api": "anthropic-messages",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "claude-fable-5", "name": "Claude Fable 5" },
        { "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
        { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
        { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
        { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
        { "id": "claude-sonnet-5", "name": "Claude Sonnet 5" },
        { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
        { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
        { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
      ]
    },
    "evolink-google": {
      "api": "google-generative-ai",
      "baseUrl": "https://direct.evolink.ai/v1beta",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
        { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
      ]
    },
    "evolink-openai": {
      "api": "openai-completions",
      "baseUrl": "https://direct.evolink.ai/v1",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gpt-5.4", "name": "GPT-5.4" },
        { "id": "gpt-5.2", "name": "GPT-5.2" },
        { "id": "gpt-5.1", "name": "GPT-5.1" },
        { "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
        { "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
        { "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
        { "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
        { "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
        { "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
        { "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
        { "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
      ]
    }
  }
}

"your-evolink-api-key" を EvoLink Dashboard から取得した実際の API キーに置き換えてください。

3. デフォルトモデルの設定

agents フィールドで、デフォルトモデルを設定します：

"model": {
  "primary": "evolink-anthropic/claude-opus-4-6"
}

4. Gateway の再起動

設定を反映するために OpenClaw Gateway を再起動します：

openclaw gateway restart

手動で別のプロセスを起動するのではなく、必ず openclaw gateway restart を使用してください。そうしないとポート競合エラーが発生します。

設定が正しく読み込まれたことを確認します：

openclaw gateway status

ステップ 5：接続の確認

1. Feishu でボットを検索

Feishu を開き、作成したボット名を検索して、会話を開始します。

2. ペアリングコードの取得

ボットに任意のメッセージを送信します。ボットがペアリングコードを返します。

3. ペアリングの完了

新しいターミナルウィンドウを開き、以下を実行します：

openclaw pairing approve feishu <pairing-code>

<pairing-code> をボットが返した実際のコードに置き換えてください。山括弧 <> は削除してください。

4. 接続のテスト

ペアリングが完了したら、Feishu でボットにメッセージを送信します：

こんにちは、自己紹介をしてください

AI の応答を受信できれば、統合は完了です。

アクセス制御

ダイレクトメッセージのアクセス

デフォルトは dmPolicy: "pairing" です。未知のユーザーにはペアリングコードが送信され、管理者の承認が必要です：

openclaw pairing list feishu        # 承認待ちの一覧を表示
openclaw pairing approve feishu <CODE>  # 承認

channels.feishu.allowFrom でユーザー Open ID の許可リストを設定することもできます。

グループアクセス

グループポリシーは channels.feishu.groupPolicy で制御します：

"open" — グループ内の全ユーザーを許可（デフォルト）
"allowlist" — groupAllowFrom のユーザーのみ許可
"disabled" — グループメッセージを無効化

デフォルトでは、ボットは @メンションされた場合のみ応答します（requireMention: true）。

よく使うコマンド

コマンド	説明
`openclaw gateway status`	Gateway のステータスを確認
`openclaw gateway restart`	Gateway サービスを再起動
`openclaw logs --follow`	リアルタイムログを表示
`openclaw pairing list feishu`	承認待ちのペアリングリクエストを表示
`openclaw plugins list`	インストール済みプラグインを表示

トラブルシューティング

問題	解決方法
グループでボットが応答しない	ボットを @メンションしたか確認してください。`groupPolicy` が `"disabled"` になっていないか確認してください
ボットがメッセージを受信しない	アプリが公開・承認されているか確認してください。イベントサブスクリプション `im.message.receive_v1` が設定されているか確認してください。WebSocket ロングコネクションモードが選択されているか確認してください
App Secret が漏洩した	Feishu Open Platform で App Secret をリセットし、設定を更新して Gateway を再起動してください
メッセージの送信に失敗する	`im:message:send_as_bot` 権限が付与されているか確認してください。`openclaw logs --follow` でログを確認してください

​概要

​システム環境チェック

​チェックツールのダウンロード

​チェック項目

​前提条件

​1. Node.js のインストール

​2. EvoLink API キーの取得

​3. Feishu アカウントの準備

​ステップ 1：OpenClaw のインストール

​ステップ 2：オンボーディング

​1. インストールの確認

​2. インストールモードの選択

​3. プロバイダーの選択

​4. モデルの選択

​5. デフォルトモデルの選択

​ステップ 3：Feishu アプリケーションの作成

​1. Feishu Open Platform にログイン

​2. アプリケーションの作成

​3. 認証情報の取得

​4. 権限の設定

​5. ボット機能の有効化

​6. イベントサブスクリプションの設定

​7. アプリケーションの公開

​ステップ 4：OpenClaw の設定

​1. Feishu チャネルの追加

​2. EvoLink API の設定

​3. デフォルトモデルの設定

​4. Gateway の再起動

​ステップ 5：接続の確認

​1. Feishu でボットを検索

​2. ペアリングコードの取得

​3. ペアリングの完了

​4. 接続のテスト

​アクセス制御

​ダイレクトメッセージのアクセス

​グループアクセス

​よく使うコマンド

​トラブルシューティング

概要

システム環境チェック

チェックツールのダウンロード

チェック項目

前提条件

1. Node.js のインストール

2. EvoLink API キーの取得

3. Feishu アカウントの準備

ステップ 1：OpenClaw のインストール

ステップ 2：オンボーディング

1. インストールの確認

2. インストールモードの選択

3. プロバイダーの選択

4. モデルの選択

5. デフォルトモデルの選択

ステップ 3：Feishu アプリケーションの作成

1. Feishu Open Platform にログイン

2. アプリケーションの作成

3. 認証情報の取得

4. 権限の設定

5. ボット機能の有効化

6. イベントサブスクリプションの設定

7. アプリケーションの公開

ステップ 4：OpenClaw の設定

1. Feishu チャネルの追加

2. EvoLink API の設定

3. デフォルトモデルの設定

4. Gateway の再起動

ステップ 5：接続の確認

1. Feishu でボットを検索

2. ペアリングコードの取得

3. ペアリングの完了

4. 接続のテスト

アクセス制御

ダイレクトメッセージのアクセス

グループアクセス

よく使うコマンド

トラブルシューティング