乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > 手把手教你部署 OpenClaw 飞书助手,配置代码全给

手把手教你部署 OpenClaw 飞书助手,配置代码全给

当前时间： 2026-05-14 09:35:55 更新时间： 2026-05-14 分类：软件教程 评论(0)

手把手教你部署 OpenClaw 飞书助手,配置代码全给

把 AI 助手装进飞书，其实没你想的那么难

前阵子 OpenClaw 在开发者圈子里火得一塌糊涂，GitHub 上 Star 数蹭蹭往上涨。很多人问我这东西到底值不值得折腾，我的回答是：如果你需要一个能 24 小时待命、数据完全自己掌控的私人 AI 助手，那它确实是目前开源方案里最靠谱的选择。

但说实话，第一次部署的时候我也踩了不少坑。官方文档写得比较分散，有些配置项不亲自试根本摸不着头脑。所以这篇文章我把整个流程梳理了一遍，你只需要跟着步骤走，基本不会卡壳。

先搞清楚 OpenClaw 到底是个啥

简单说，它是一个可以本地运行的个人 AI 助手平台。跟那些云端 AI 不一样，你的对话数据不会经过第三方服务器，完全存在自己电脑上。

它支持接飞书、微信、Telegram、Discord 这些聊天工具，模型方面 OpenAI、Claude、MiniMax、Moonshot 都能用。MIT 开源协议，免费。

项目地址在 GitHub 搜 openclaw 就能找到，目前 Star 数已经过了 25 万。

环境准备：先把地基打好

系统要求

macOS、Linux 或者 Windows 的 WSL2 都行。核心要求就一个：Node.js 版本必须是 22 或以上。

如果你还没装 Node.js，建议用 nvm 来管理版本，后面切换起来方便。

# 装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash# 装完重载一下配置source ~/.zshrc  # macOSsource ~/.bashrc  # Linux

然后装 Node.js 22：

nvm install 22nvm alias default 22node --version  # 看到 v22.x.x 就说明装好了

❝

这里多说一句，Windows 用户如果不想折腾 WSL，也可以直接用 PowerShell 跑安装脚本，但有些插件兼容性可能会有问题，还是推荐 WSL2。

安装 OpenClaw

这一步其实就一条命令的事：

npm install -g openclaw@latest

装完跑一下 openclaw --version，能看到版本号就说明没问题。

接下来创建配置目录：

mkdir -p ~/.openclaw/workspacemkdir -p ~/.openclaw/agents/main/sessionsmkdir -p ~/.openclaw/credentialschmod 700 ~/.openclaw

最后那个 chmod 700 别省，配置文件里会存 API Key，权限设严一点总没错。

配置 AI 模型：选一个顺手的

OpenClaw 本身不提供模型，它只是个”壳”，你得自己接大模型的 API。国内用户比较常用的是 MiniMax，我就以这个为例。

MiniMax 的坑：国际版和国内版是分开的

这点很多人第一次搞的时候会懵。MiniMax 有两个平台：

  • 国内版：platform.minimaxi.com，API 地址是 api.minimaxi.com
  • 国际版：platform.minimax.io，API 地址是 api.minimax.io

你的 API Key 从哪个平台申请的，就只能用对应平台的 API 地址，混用会直接报错。

注册登录后，去「API 密钥」页面创建一个 Key，格式大概是 sk-xxxxxxxxxxxx，复制好后面要用。

写配置文件

在 ~/.openclaw/ 下面创建 openclaw.json，国内版 MiniMax 的配置长这样：

{"env": {"MINIMAX_API_KEY": "你的API Key"  },"agents": {"defaults": {"model": {"primary": "minimax/MiniMax-M2.5"      }    }  },"models": {"mode": "merge","providers": {"minimax": {"baseUrl": "https://api.minimaxi.com/anthropic"      }    }  }}

如果你用的是其他模型，结构差不多，改几个关键字段就行。

比如 OpenAI：

{"env": {"OPENAI_API_KEY": "sk-xxxxxxxx"  },"agents": {"defaults": {"model": {"primary": "openai/gpt-4o"      }    }  }}

Claude 的话把 ANTHROPIC_API_KEY 和模型名换成 anthropic/claude-sonnet-4-5 就行。

❝

模型选择这块，我的建议是先用便宜模型跑通流程，等确认一切正常了再换旗舰模型。不然配置出了问题你都不知道是模型的问题还是配置的问题。

飞书插件和应用配置

装插件

openclaw plugins install @openclaw/feishu

看到 Installed plugin: feishu 就说明装好了。

创建飞书应用

去飞书开放平台（open.feishu.cn），点「创建企业自建应用」。名字随便取，比如”AI 助手”，描述写清楚用途就行。

创建完后进入「凭证与基础信息」，把 App ID 和 App Secret 复制下来。

权限配置

这一步比较繁琐但很关键。进「权限管理」，用批量导入的方式最省事，把下面这段 JSON 贴进去：

{"scopes": {"tenant": ["im:message:send_as_bot","im:message:readonly","im:chat:readonly","contact:user.base:readonly"    ]  }}

❝

如果你需要更多功能比如云文档操作、多维表格读写，可以根据需要额外开通对应权限。

启用机器人

进「应用能力」>「机器人」，点启用，填个名字。这个名字就是用户在飞书里看到的机器人名称。

事件订阅（这一步最容易漏）

进「事件与回调」>「事件订阅」：

  1. 订阅方式选「使用长连接接收事件」（WebSocket 模式）
  2. 添加事件 im.message.receive_v1

❝

为什么选 WebSocket？ 因为你不需要有公网服务器，OpenClaw 会主动连飞书。如果选 Webhook 模式你还得搞个公网 IP 或者内网穿透，麻烦得很。

发布应用

进「版本管理与发布」，创建版本，提交发布。企业自建应用一般不需要管理员审批，自己就能过。

把飞书和 OpenClaw 连起来

回到 ~/.openclaw/openclaw.json，在之前的配置基础上加上飞书频道配置：

{"env": {"MINIMAX_API_KEY": "你的API Key"  },"agents": {"defaults": {"model": {"primary": "minimax/MiniMax-M2.5"      }    }  },"models": {"mode": "merge","providers": {"minimax": {"baseUrl": "https://api.minimaxi.com/anthropic"      }    }  },"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","region": "cn","dmPolicy": "pairing","groupPolicy": "allowlist"    }  }}

几个关键字段说明一下：

  • region：cn 是国内版飞书，en 是国际版 Lark
  • dmPolicy：pairing 表示需要配对才能对话，生产环境建议用这个
  • groupPolicy：allowlist 表示只响应白名单群聊

启动和测试

启动 Gateway

openclaw gateway start

Gateway 就是 OpenClaw 的核心服务，它负责接收消息、调用模型、返回结果。

配对

如果是第一次用 DM 模式，需要配对。跑一下：

openclaw pairing list feishu

会看到一个配对码，然后在飞书里给机器人发这个码就完成配对了。

测试

打开飞书，找到你的机器人，随便发条消息比如”你好”。如果正常回复了，说明整个链路跑通了。

常见问题排查

模型加载失败

如果启动后提示模型加载有问题，试试清一下缓存：

rm -f ~/.openclaw/agents/main/agent/models.jsonopenclaw gateway restart

实在不行就停掉服务，删缓存，重新安装：

openclaw gateway stoprm -f ~/.openclaw/agents/main/agent/models.jsonopenclaw gateway installopenclaw gateway start

飞书收不到消息

大概率是事件订阅没配好。回去检查一下：

  1. 事件订阅方式是不是选的 WebSocket
  2. im.message.receive_v1 事件有没有添加
  3. 应用有没有发布成功

日志怎么看

openclaw logs --follow

实时看日志，排查问题最直观的方式。

日常运维命令

几个常用的，建议收藏：

# 查看服务状态openclaw gateway status# 启动/停止/重启openclaw gateway startopenclaw gateway stopopenclaw gateway restart# 查看频道状态openclaw channels status# 查看模型状态openclaw models list

安全方面多唠叨几句

API Key 和 App Secret 千万别往代码仓库里提交，这是最基本的安全意识。

另外建议定期更换密钥，配置文件目录权限保持 700。生产环境一定要用 dmPolicy: "pairing" 和 groupPolicy: "allowlist"，不然谁都能跟你的机器人对话，迟早出问题。

写在最后

整套流程走下来，其实核心就几件事：装环境、装 OpenClaw、配模型、建飞书应用、连起来。每一步单独拎出来都不复杂，关键是顺序别乱，配置别写错。

我自己跑了一段时间，日常用来处理一些重复性的信息整理工作还是挺顺手的。不过 Token 消耗这块确实得注意，模型选贵的跑起来成本不低，建议简单任务用便宜模型，复杂逻辑再上旗舰。

有什么问题的话可以在评论区交流，看到会回。