> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw + Feishu

> Feishu（Lark）を通じて OpenClaw を 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](https://github.com/suuuuuu-1/openclaw-env-checker/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）

<img src="https://mintcdn.com/muyutechnology/nIFIx0gxdF53THw8/images/OpenClaw-Checker/check-success.png?fit=max&auto=format&n=nIFIx0gxdF53THw8&q=85&s=46f1fdbec3263845e35158b104fa5091" alt="チェック成功例" width="1778" height="1742" data-path="images/OpenClaw-Checker/check-success.png" />

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

## 前提条件

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

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

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

<Tabs>
  <Tab title="Windows">
    [Node.js 公式サイト](https://nodejs.org/ja/download)にアクセスし、Windows インストーラー（.msi ファイル）をダウンロードして実行します。

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

    ```bash theme={null}
    node --version
    npm --version
    ```

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

  <Tab title="macOS">
    **方法 1：インストーラーを使用**

    [Node.js 公式サイト](https://nodejs.org/ja/download)にアクセスし、macOS インストーラー（.pkg ファイル）をダウンロードして実行します。

    **方法 2：Homebrew を使用**

    ```bash theme={null}
    brew install node
    ```

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

    ```bash theme={null}
    node --version
    npm --version
    ```

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

### 2. EvoLink API キーの取得

* [EvoLink Dashboard](https://evolink.ai/dashboard) にログイン
* ダッシュボードで API Keys を見つけ、「新しいキーを作成」ボタンをクリックし、生成されたキーをコピー
* API キーは通常 `sk-` で始まります

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

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

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

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

```bash theme={null}
npm install -g openclaw@latest
```

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

```bash theme={null}
openclaw plugins install @openclaw/feishu
```

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

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

```bash theme={null}
openclaw onboard --install-daemon
```

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

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=fce0ba49fe04129dc943e6f63353595e" alt="Confirm Installation" width="1488" height="1420" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png" />

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

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=24fbf84b590649d1fc1d515d2ee50609" alt="Select Quickstart" width="1738" height="1540" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png" />

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

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=a4f74b3bb72312ba426ea37179232576" alt="Skip Provider Selection" width="1398" height="1272" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png" />

### 4. モデルの選択

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=701f58ca7164b7830cef3bfb713d911b" alt="Select All Models" width="1380" height="1528" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png" />

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

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

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=5ded0a9c44fd991865dbe84195862563" alt="Keep Current Model" width="1334" height="1792" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png" />

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

### 1. Feishu Open Platform にログイン

[Feishu Open Platform](https://open.feishu.cn/app) にアクセスし、Feishu アカウントでログインします。

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

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

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

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/create-app.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=68f3383cc4e84f804832d50b0a619b26" alt="Create Application" width="1650" height="611" data-path="images/OpenClaw-Feishu/create-app.avif" />

### 3. 認証情報の取得

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

* **App ID**（形式：`cli_xxx`）
* **App Secret**

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

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/get-credentials.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=8b1539f0f9fd1f382304c00aaafd4471" alt="Get Credentials" width="1650" height="728" data-path="images/OpenClaw-Feishu/get-credentials.avif" />

### 4. 権限の設定

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

```json theme={null}
{
  "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"
    ]
  }
}
```

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/configure-permissions.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=b586b4d4778a5af577cbc188cd0f196a" alt="Configure Permissions" width="1650" height="755" data-path="images/OpenClaw-Feishu/configure-permissions.avif" />

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

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

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Feishu/enable-bot.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=4acd5043b50c2a799eff3516390e6e39" alt="Enable Bot Capability" width="2888" height="1386" data-path="images/OpenClaw-Feishu/enable-bot.png" />

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

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

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

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

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

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

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/event-subscription.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=9cbb8f9f6d35b90981908f1bcd70b8ad" alt="Configure Event Subscriptions" width="1650" height="851" data-path="images/OpenClaw-Feishu/event-subscription.avif" />

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

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

## ステップ 4：OpenClaw の設定

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

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

### 1. Feishu チャネルの追加

<Tabs>
  <Tab title="手動設定">
    `~/.openclaw/openclaw.json` を開きます：

    Feishu プラグインを有効にします（`plugins.entries`）：

    ```json theme={null}
    "plugins": {
      "entries": {
        "feishu": {
          "enabled": true
        }
      }
    }
    ```

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

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

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

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

    ```bash theme={null}
    export FEISHU_APP_ID="cli_xxx"
    export FEISHU_APP_SECRET="xxx"
    ```
  </Tab>

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

    ```bash theme={null}
    openclaw channels add
    ```

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

### 2. EvoLink API の設定

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

```json theme={null}
"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" }
      ]
    }
  }
}
```

<Warning>
  `"your-evolink-api-key"` を [EvoLink Dashboard](https://evolink.ai/dashboard) から取得した実際の API キーに置き換えてください。
</Warning>

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

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

```json theme={null}
"model": {
  "primary": "evolink-anthropic/claude-opus-4-6"
}
```

### 4. Gateway の再起動

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

```bash theme={null}
openclaw gateway restart
```

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

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

```bash theme={null}
openclaw gateway status
```

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

### 1. Feishu でボットを検索

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

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

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

### 3. ペアリングの完了

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

```bash theme={null}
openclaw pairing approve feishu <pairing-code>
```

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

### 4. 接続のテスト

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

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

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

## アクセス制御

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

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

```bash theme={null}
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` でログを確認してください                                      |