OpenClaw Docker安装飞书接入精选教程

2026-06-17阅读 0热度 0

OpenClaw

在实际落地过程中，将 OpenClaw 这类 AI 网关部署到本地环境，再对接飞书机器人，能够显著提升团队协作效率。下面这份操作指南会一步步带你走通整个流程：从申请 API Key、创建飞书应用，到使用 Docker 启动服务，再到最后的桌面端配置。

通过 Docker 安装 OpenClaw 并集成飞书

一、前期准备

1. 获取 API Key

阿里云百炼
科大讯飞
或者百度等其他平台提供的 Coding Plan
记录下 API Key，后续配置中需要用到。

2. 创建飞书机器人

登录飞书开放平台 → 进入开发者后台 → 创建自建应用。
创建完成后，记录下 App ID 和 App Secret，后续配置会用到。
添加应用能力 → 启用机器人。
进入权限管理，申请以下权限：
事件与回调 → 添加一个长连接事件：
发布应用，使其生效。

2. 安装 Docker

访问 Docker 官方地址，根据你的操作系统下载对应版本即可，这里不再赘述。

安装 OpenClaw

1. 编写 docker-compose.yml

先在宿主机终端中创建新目录并进入：

mkdir /openclaw
cd openclaw

创建 docker-compose.yml 文件：

vim docker-compose.yml

在 docker-compose.yml 中填入以下配置：

macOS：

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "127.0.0.1:18789:18789"   # 映射到宿主机
      # 或者如果需要局域网访问
      # - "18789:18789"
    environment:
      - OPENCLAW_GATEWAY_BIND=0.0.0.0   # 确保监听所有接口
    volumes:
      - ./data:/home/node/.openclaw
    restart: unless-stopped

Windows：

可能需要在当前目录下执行 mkdir data 创建数据文件夹。

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      # Windows 上推荐直接用这个，方便从宿主机访问
      - "18789:18789"
      # 如果需要更严格的本地访问，可以用下面这个
      # - "127.0.0.1:18789:18789"
    environment:
      - OPENCLAW_GATEWAY_BIND=0.0.0.0
      # 可选：如果你用 WSL2，可以加这个环境变量
      - OPENCLAW_DATA_DIR=/home/node/.openclaw
    volumes:
      # Windows 路径格式（使用相对路径）
      - ./data:/home/node/.openclaw
      # 或者用绝对路径（根据你的实际位置修改）
      # - C:/Users/你的用户名/openclaw/data:/home/node/.openclaw
      # 添加 user 配置，以 root 身份运行避免权限问题
      # user: "root"
    restart: unless-stopped

2. 执行安装流程

启动容器：

docker-compose up -d

进入容器进行交互式配置：

docker exec -it openclaw openclaw configure

需要配置以下三项：

model – 配置阿里模型，根据提示填入 API Key。
channel – 选择飞书，填写飞书机器人的 App ID 和 App Secret，并选择下载飞书插件。
gateway – 配置网关，选择 Open，生成 token。

当然，你也可以在配置完成后，直接编辑 openclaw.json 文件来修改。配置文件位于 /openclaw/data/openclaw.json，内容示例如下：

{
  "meta": {
    "lastTouchedVersion": "2026.3.13",
    "lastTouchedAt": "2026-03-17T10:37:42.206Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-17T09:13:16.031Z",
    "lastRunVersion": "2026.3.13",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "modelstudio:default": {
        "provider": "modelstudio",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian":{
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "你的阿里云百炼api-Key",
        "api": "openai-completions",
        "models": [{
          "id": "qwen3.5-plus",
          "name": "千问3.5 plus",
          "reasoning": true,
          "input": ["text","image"],
          "contextWindow": 1000000,
          "maxTokens": 65536
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3-max-2026-01-23": {
          "alias": ""
        },
        "bailian/qwen3.5-plus": {}
      },
      "compaction": {
        "mode": "safeguard"
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "飞书机器人应用appId",
      "appSecret": "飞书机器人应用appSecret",
      "connectionMode": "websocket",
      "domain": "feishu",
      "botName": "机器人名称",
      "groupPolicy": "open"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": ["http://localhost:18789","http://127.0.0.1:18789"]
    },
    "auth": {
      "mode": "token",
      "token": "本机gateway配置时自动生成的token"
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    },
    "installs": {
      "feishu": {
        "source": "npm",
        "spec": "@openclaw/feishu",
        "installPath": "/home/node/.openclaw/extensions/feishu",
        "version": "2026.3.13",
        "resolvedName": "@openclaw/feishu",
        "resolvedVersion": "2026.3.13",
        "resolvedSpec": "@openclaw/feishu@2026.3.13",
        "integrity": "",
        "shasum": "",
        "resolvedAt": "2026-03-17T08:57:25.740Z",
        "installedAt": "2026-03-17T08:57:49.738Z"
      }
    }
  }
}

修改完成后，重启容器使配置生效：

docker restart openclaw

3. 配置桌面端

启动网关并查看 Dashboard 地址：

# 运行gateway
docker exec -it openclaw openclaw gateway run

# 查看Dashboard URL
docker exec -it openclaw openclaw dashboard --no-open

在浏览器中访问 http://127.0.0.1:18789，输入 token，或者直接用上面命令返回的 Dashboard URL 进入。

如果遇到 pairing required 提示，说明设备尚未配对。可以用以下命令放行当前设备：

# 1. 查看待批准的设备列表
docker exec -it openclaw openclaw devices list
# 或尝试
docker exec -it openclaw node dist/index.js devices list

# 2. 你会看到一个待处理的请求，复制它的 ID

# 3. 批准该设备（将  替换为实际的ID）
docker exec -it openclaw openclaw devices approve

最终页面效果如下：