当前位置：码云笔记 > 后端 > OpenClaw 安装配置及飞书对接详细指南
终末观者终末观者 后端

OpenClaw 安装配置及飞书对接详细指南

AI 概述
OpenClaw是开源AI助手框架，支持多种大模型和通信渠道接入。安装需Node.js 18.x及以上版本等，安装后要配置MiniMax大模型，需修正URL和API类型。配置飞书机器人需创建应用、设置权限、开启长连接模式、订阅事件等，并在OpenClaw中添加相应配置。使用中可能会遇到MiniMax API 404、飞书收不到消息、权限不足等问题，可按相应方法解决。此外，还介绍了常用命令、注意事项，并提供了OpenClaw、飞书开放平台、MiniMax API的参考链接。
目录
文章目录隐藏
  1. 一、OpenClaw 简介
  2. 二、安装 OpenClaw
  3. 三、配置 MiniMax 大模型
  4. 四、配置飞书机器人
  5. 五、故障排除
  6. 六、常用命令
  7. 七、注意事项
  8. 八、参考链接

OpenClaw 安装配置及飞书对接详细指南

一、OpenClaw 简介

OpenClaw 是开源 AI 助手框架，支持多种大模型和通信渠道接入。它可以作为本地运行的 AI Gateway，通过 WebSocket、Webhook 等方式连接飞书、Slack、Discord 等平台，快速部署自定义 AI 助手。

二、安装 OpenClaw

2.1 环境要求

  • Node.js 18.x 或更高版本；
  • Windows 10/11 或 WSL2；
  • MiniMax API Key（或其他支持的大模型）。

2.2 安装步骤

  1.  全局安装 OpenClaw： 
    npm install -g openclaw
  2. 验证安装： 
    openclaw --version
  3. 查看帮助： 
    openclaw --help

三、配置 MiniMax 大模型

3.1 问题描述

安装完成后，首次与 OpenClaw 聊天时遇到 404 错误：

404 <html><head><title>404 Not Found</title></head><body><center><h1>404 Not Found</h1></center><hr><center>nginx</center></body></html>

3.2 原因分析

通过 Direct API 测试发现：

  • 错误的 URL：https://api.minimaxi.com/anthropic/v1；
  • 正确的 URL：https://api.minimaxi.com/anthropic；
  • API 类型需要设置为 anthropic-messages。

3.3 配置文件位置

OpenClaw 的配置文件位于用户目录：

  • Windows：C:\Users\Administrator\.openclaw\openclaw.json；
  • 注意：如果通过 MSYS2/WSL 环境运行，配置可能读取 MSYS2 的 HOME 目录。

3.4 配置步骤

打开配置文件：

notepad C:\Users\Administrator\.openclaw\openclaw.json

在 models.providers 下添加 MiniMax 配置：

{
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimaxi.com/anthropic",
        "apiKey": "你的 MiniMax API Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax M2.5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 15,
              "output": 60,
              "cacheRead": 2,
              "cacheWrite": 10
            },
            "contextWindow": 204800,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/MiniMax-M2.5"
      }
    }
  }
}

保存配置文件

重启 Gateway：

openclaw gateway stop
openclaw gateway

3.5 验证配置

openclaw doctor

或测试聊天：

openclaw tui --message "你好"

四、配置飞书机器人

4.1 创建飞书应用

创建企业自建应用：

  1. 登录 飞书开发者后台
  2. 点击顶部「创建企业自建应用」按钮
  3. 填写应用信息：
    • 应用名称：例如「OpenClaw AI 助手」
    • 应用描述：简要说明应用用途
    • 应用图标：上传机器人头像（建议 200x200px）
  4. 选择应用归属：企业/个人
  5. 点击「创建」完成应用创建

获取应用凭证：

创建成功后，进入「凭证与基础信息」页面，记录以下信息（这些信息需要填入 OpenClaw 配置）：

  • App ID：以 cli_ 开头；
  • App Secret：32 位字符串；
  • Verification Token：用于验证回调请求（启用事件订阅后显示）；
  • Encrypt Key：如果启用加密（开启后显示）。

注意：这些凭证包含敏感信息，请妥善保管。

4.2 配置应用权限

在飞书开发者后台 → 权限管理 添加以下权限：

权限名称 权限标识
接收消息 im.message.receive_v1
发送消息 im.message.message_asrobot
联系人只读 contact:contact.base:readonly 或 contact:contact:readonly
发送消息-单聊 im.chat.message.chat_id

添加权限后需要点击”批量开通”，并确认应用身份权限。

4.3 开启长连接模式

为了使用 WebSocket 长连接接收消息，需要：

  1. 进入「事件与回调」页面；
  2. 点击「开启事件订阅」；
  3. 在事件订阅方式中选择「使用长连接接收事件/回调」；
  4. 系统会自动生成Verification Token和Encrypt Key；
  5. 保存这些凭证，稍后需要填入 OpenClaw 配置。

选择理由：WebSocket 模式无需公网服务器，适合本地开发环境；Webhook 模式需要公网可访问的地址，适合生产环境。

4.4 订阅事件

在飞书开发者后台 → 事件与回调：

  1. 点击”添加事件”；
  2. 搜索 im.message.receive_v1（接收消息）；
  3. 点击”确认添加”；
  4. 按照指引确认。

4.5 配置 OpenClaw 飞书连接

在 openclaw.json 中添加飞书配置：

{
  "channels": {
    "feishu": {
      "appId": "cli_xxxxxxxxxxxxxx",
      "verificationToken": "你的 Verification Token",
      "appSecret": "你的 App Secret",
      "encryptKey": "你的 Encrypt Key",
      "connectionMode": "websocket",
      "domain": "feishu",
      "enabled": true,
      "groupPolicy": "open",
      "allowFrom": ["*"],
      "accountId": "default"
    }
  },
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "feishu",
        "accountId": "default"
      }
    }
  ]
}

4.6 发布应用

为了让其他人能使用你的飞书机器人，需要发布应用：

  1. 在飞书开发者后台进入「版本管理」页面；
  2. 点击「创建版本」，填写版本号和更新说明；
  3. 点击「发布」按钮；
  4. 发布成功后，所有公司成员都可以搜索并添加该机器人。

发布前检查：

  • 确认所有必需权限已开通；
  • 确认事件订阅已配置；
  • 确认机器人头像、名称、描述信息完善。

4.7 添加机器人到群聊

发布应用后，可以将机器人添加到飞书群聊：

  1. 打开飞书客户端，进入目标群聊；
  2. 点击群聊设置 → 添加成员；
  3. 搜索你的机器人名称；
  4. 选择机器人并添加到群聊；
  5. 在群聊中 @机器人，发送测试消息。

如果配置正确，机器人应该能够响应消息。

4.8 配置说明

配置项 说明
connectionMode 连接模式：websocket（长连接）或 webhook（回调）
allowFrom 允许发消息的用户，[“*”] 表示允许所有人
groupPolicy 群聊策略：open 允许所有群聊
accountId 账号标识，默认 default

五、故障排除

5.1 MiniMax API 404 错误

问题：返回 404 nginx 错误；

原因：API URL 配置错误；

解决：参见本文档”配置 MiniMax 大模型”章节。

5.2 飞书 WebSocket 连接成功但收不到消息

问题：日志显示WebSocket client started，但发消息后没有任何响应

排查步骤：

  1. 查看日志确认连接状态： 
    openclaw logs
  2. 确认openclaw status显示飞书渠道状态为running
  3. 最常见原因：没有订阅”接收消息”事件

解决：

  • 在飞书开发者后台 → 事件与回调 → 添加im.message.receive_v1事件
  • 点击”确认添加”并按照指引完成

5.3 权限不足错误

问题：日志显示

Access denied. One of the following scopes is required:
[contact:contact.base:readonly, contact:contact:access_as_app, ...]

解决：

  1. 在飞书开发者后台 → 权限管理；
  2. 添加缺失的权限（如 contact:contact.base:readonly）；
  3. 点击”批量开通”；
  4. 在”应用身份”确认权限；
  5. 重启 Gateway。

5.4 重复插件警告

问题：日志显示

plugin feishu: duplicate plugin id detected

原因：插件被重复加载

解决：检查配置，确保没有重复的插件配置

5.5 配置文件位置问题

问题：配置修改不生效；

原因：可能存在多个配置文件；

排查：

  • Windows 原生：C:\Users\Administrator\.openclaw\openclaw.json
  • MSYS2/WSL：D:\msys64\home\Administrator\.openclaw\openclaw.json

使用 openclaw doctor 查看实际加载的配置文件路径

六、常用命令

6.1 Gateway 管理

# 启动 Gateway
openclaw gateway

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看 Gateway 状态
openclaw status

# 查看详细状态
openclaw status --deep

6.2 日志查看

# 查看日志
openclaw logs

# 实时查看日志
openclaw logs --follow

6.3 测试聊天

# 使用 TUI 聊天
openclaw tui --message "你好"

# 使用 Agent 模式
openclaw agent --message "你好"

6.4 配置检查

# 运行诊断
openclaw doctor

七、注意事项

  1. 应用状态：飞书应用需要在开发者后台点击”发布”，否则只有开发者本人能测试；
  2. 权限申请：添加权限后一定要点击”批量开通”，并确认应用身份；
  3. 事件订阅：必须订阅 im.message.receive_v1 才能接收消息；
  4. 长连接模式：WebSocket 长连接需要在飞书后台选择”使用长连接接收事件/回调”；
  5. 公网地址：如果使用 Webhook 模式，需要有公网可访问的地址。

八、参考链接

  • OpenClaw 官方文档
  • 飞书开放平台
  • MiniMax API 文档

以上关于OpenClaw 安装配置及飞书对接详细指南的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。

「点点赞赏，手留余香」

赞 17 赏

给作者打赏，鼓励TA抓紧创作！

微信微信 支付宝支付宝

还没有人赞赏，快来当第一个赞赏的人吧！

声明：本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权/违法违规/事实不符，请将相关资料发送至 admin@mybj123.com 进行投诉反馈，一经查实，立即处理！
重要：如软件存在付费、会员、充值等，均属软件开发者或所属公司行为，与本站无关，网友需自行判断
码云笔记 » OpenClaw 安装配置及飞书对接详细指南

终末观者 普通

分享到：

相关推荐

发表回复