OpenClaw + Feishu - EvoLink.AI

개요

OpenClaw은 채팅 애플리케이션과 AI 에이전트 사이의 브릿지 역할을 하는 오픈소스 AI 에이전트 Gateway입니다. 중앙 집중식 Gateway 프로세스를 통해 Telegram, WhatsApp, Discord, Feishu (Lark) 등의 채팅 플랫폼을 AI 코딩 에이전트에 연결하여, 채팅 창에서 직접 AI 프로그래밍 상호작용을 할 수 있습니다. OpenClaw에서 EvoLink API를 커스텀 모델 제공자로 설정하고 Feishu 봇을 연결하면, Feishu에서 직접 EvoLink의 Claude 모델(Claude 4.6 Opus, Claude 4.5 Sonnet, Claude 4.5 Haiku 등)을 사용하여 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 Key 발급

EvoLink Dashboard에 로그인합니다
대시보드에서 API Keys를 찾아 ‘새 키 생성’ 버튼을 클릭한 후, 생성된 Key를 복사합니다
API Key는 보통 sk-로 시작합니다

3. Feishu 계정 준비

Feishu 오픈 플랫폼에서 애플리케이션을 생성하려면 Feishu 기업 계정이 필요합니다.

Step 1: OpenClaw 설치

터미널에서 다음 명령어를 실행합니다:

npm install -g openclaw@latest

Feishu 플러그인을 설치합니다:

openclaw plugins install @openclaw/feishu

Step 2: 온보딩

온보딩 명령어를 실행합니다. OpenClaw이 초기 설정을 안내하고 백그라운드 데몬 서비스를 설치합니다:

openclaw onboard --install-daemon

1. 설치 확인

시스템에 위험 고지 사항이 표시됩니다. 확인하여 진행합니다:

2. 설치 모드 선택

설치 모드를 선택하라는 메시지가 나타나면 Quickstart를 선택합니다:

3. 제공자 선택

모델 제공자를 선택하라는 메시지가 나타나면 Skip을 선택합니다. 나중에 EvoLink를 커스텀 제공자로 수동 설정할 것입니다:

4. 모델 선택

활성화할 모델을 선택하라는 메시지가 나타나면 All을 선택합니다:

5. 기본 모델 선택

기본 모델을 선택하라는 메시지가 나타나면 Keep current를 선택합니다:

Step 3: Feishu 애플리케이션 생성

1. Feishu 오픈 플랫폼 로그인

Feishu 오픈 플랫폼에 접속하여 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 채널 설정이 완료되었는지 (Step 4 참조)
Gateway가 실행 중인지 (openclaw gateway status로 확인)

이벤트 구독 페이지에서:

장기 연결을 사용하여 이벤트 수신 (WebSocket 모드)을 선택합니다
이벤트 추가: im.message.receive_v1 (메시지 수신)

Gateway가 실행 중이지 않거나 채널이 추가되지 않은 경우, 장기 연결 설정 저장에 실패합니다.

7. 애플리케이션 배포

버전 관리 및 릴리스로 이동하여 버전을 생성하고, 검토를 제출한 후 배포합니다. 기업 자체 구축 애플리케이션은 보통 자동으로 승인됩니다.

Step 4: OpenClaw 설정

OpenClaw의 설정은 ~/.openclaw/openclaw.json에 집중되어 있습니다. 세 가지 주요 설정 영역이 있습니다:

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 Key로 교체하세요.

3. 기본 모델 설정

agents 필드에서 기본 모델을 설정합니다:

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

4. Gateway 재시작

설정을 적용하기 위해 OpenClaw Gateway를 재시작합니다:

openclaw gateway restart

수동으로 다른 프로세스를 시작하지 말고 반드시 openclaw gateway restart를 사용하세요. 그렇지 않으면 포트 충돌 오류가 발생합니다.

설정이 올바르게 로드되었는지 확인합니다:

openclaw gateway status

Step 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 오픈 플랫폼에서 App Secret을 재설정하고, 설정을 업데이트한 후 Gateway를 재시작하세요
메시지 전송 실패	`im:message:send_as_bot` 권한이 부여되었는지 확인하세요. `openclaw logs --follow`로 로그를 확인하세요

​개요

​시스템 환경 확인

​확인 도구 다운로드

​확인 항목

​사전 준비 사항

​1. Node.js 설치

​2. EvoLink API Key 발급

​3. Feishu 계정 준비

​Step 1: OpenClaw 설치

​Step 2: 온보딩

​1. 설치 확인

​2. 설치 모드 선택

​3. 제공자 선택

​4. 모델 선택

​5. 기본 모델 선택

​Step 3: Feishu 애플리케이션 생성

​1. Feishu 오픈 플랫폼 로그인

​2. 애플리케이션 생성

​3. 자격 증명 확인

​4. 권한 설정

​5. 봇 기능 활성화

​6. 이벤트 구독 설정

​7. 애플리케이션 배포

​Step 4: OpenClaw 설정

​1. Feishu 채널 추가

​2. EvoLink API 설정

​3. 기본 모델 설정

​4. Gateway 재시작

​Step 5: 연결 확인

​1. Feishu에서 봇 찾기

​2. 페어링 코드 받기

​3. 페어링 완료

​4. 연결 테스트

​접근 제어

​다이렉트 메시지 접근

​그룹 접근

​자주 사용하는 명령어

​문제 해결

개요

시스템 환경 확인

확인 도구 다운로드

확인 항목

사전 준비 사항

1. Node.js 설치

2. EvoLink API Key 발급

3. Feishu 계정 준비

Step 1: OpenClaw 설치

Step 2: 온보딩

1. 설치 확인

2. 설치 모드 선택

3. 제공자 선택

4. 모델 선택

5. 기본 모델 선택

Step 3: Feishu 애플리케이션 생성

1. Feishu 오픈 플랫폼 로그인

2. 애플리케이션 생성

3. 자격 증명 확인

4. 권한 설정

5. 봇 기능 활성화

6. 이벤트 구독 설정

7. 애플리케이션 배포

Step 4: OpenClaw 설정

1. Feishu 채널 추가

2. EvoLink API 설정

3. 기본 모델 설정

4. Gateway 재시작

Step 5: 연결 확인

1. Feishu에서 봇 찾기

2. 페어링 코드 받기

3. 페어링 완료

4. 연결 테스트

접근 제어

다이렉트 메시지 접근

그룹 접근

자주 사용하는 명령어

문제 해결