Deploy OpenClaw AI Agent on macOS with Docker and Feishu Integration

Overview

OpenClaw is an AI agent that runs locally and can execute shell commands, manipulate files, and control browsers. It can be accessed via multiple channels such as Telegram, WhatsApp, Slack, and Feishu.

Prerequisites

macOS machine, Docker, Git, and Node.js.

Install Node.js

Download the LTS macOS .pkg installer from https://nodejs.org/en/download/ and install it.

Install Git

Download the macOS .dmg installer from https://git-scm.com/download/mac and install it.

Install Docker

Install Docker Desktop compatible with your macOS version and start Docker.

Install and configure OpenClaw

Clone the repository and run the Docker setup script:

git clone https://github.com/openclaw/openclaw
cd openclaw
./docker-setup.sh

When the script finishes, a UI screen indicates successful installation.

Select QuickStart and choose the MiniMax model (free token quota for first‑time users). Skip the chat tool selection if you plan to use Feishu.

Fix gateway token error

If you encounter the error

disconnected (1008): unauthorized: gateway token missing (set gateway.remote.token to match gateway.auth.token)

, edit the generated openclaw.json file and replace the placeholder token with your own gateway token, then copy the file into the container and restart the gateway:

docker cp /Users/mac/openclaw/openclaw.json openclaw-openclaw-gateway-1:/home/node/.openclaw/openclaw.json
docker-compose restart openclaw-gateway

Also fill the token in the Gateway Access UI.

Install and configure Feishu plugin

Register a Feishu enterprise application (not a personal account) and obtain the App ID and App Secret. Required permissions include message read/write and bot send.

Install the Feishu plugin via Docker:

docker compose run --rm openclaw-cli plugins install @m1heng-clawd/feishu

Insert your Feishu App ID and App Secret into ~/.openclaw/openclaw.json under the feishu channel configuration, then restart the gateway: docker compose restart openclaw-gateway In the Feishu admin console, go to Events & Callbacks → Subscription Method Edit , select Long Connection , add the Message Receive event, and save.

Feishu channel configuration example

{
  "channels": {
    "feishu": {
      "appId": "YOUR_APP_ID",
      "appSecret": "YOUR_APP_SECRET",
      "domain": "feishu",
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "groupPolicy": "open",
      "requireMention": true,
      "enabled": true,
      "mediaMaxMb": 30,
      "renderMode": "auto"
    }
  }
}

Verification

Open http://127.0.0.1:18789/?token=YOUR_TOKEN in a browser, send a message to the MiniMax model, and confirm a reply appears.

From a Feishu chat, send a command to the bot; if the computer executes the task and the UI shows the response, the setup is successful.