OpenClaw 安装与飞书接入实操

在本地 Windows 11 上部署

本地部署更适合测试，或者你不想把数据放到云端。

安装依赖

先装这几个基础组件：

1. Node.js：下载官网 LTS 版，22.x 或 24.x 都可以，安装时记得勾选 Add to PATH。装完后用 node -v 和 npm -v 看一下版本是否正常。
2. Git：按默认选项安装，确保 'Git Bash Here' 和 'Add Git to PATH' 被勾上。
3. Visual C++ Redistributable：Win10 / Win11 一般都要这个运行库，装 x64 版本。

配置 PowerShell 和 npm 镜像

用管理员身份打开 PowerShell，然后把 npm 源切到国内镜像，下载会快很多。

npm config set registry https://registry.npmmirror.com/

再把脚本执行限制放开一点，不然很多安装脚本跑不起来：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

提示时按 Y。

安装和启动

执行官方 Windows 安装脚本：

iwr -useb https://openclaw.ai/install.ps1 | iex

等它跑完后，先打开控制面板：

openclaw dashboard

浏览器会打开 http://127.0.0.1:18789，这就是本地的管理界面。

首次安装时，再跑一次初始化向导：

openclaw onboard --install-daemon

如果要把后台服务拉起来：

openclaw gateway start

配置模型提供商

装好 OpenClaw 只是第一步，真正能不能用，关键还是模型配置。这个地方如果填错，后面飞书接得再完整也没用。

直接改配置文件

OpenClaw 的配置文件一般在这些位置：

• Linux / Mac：~/.openclaw/openclaw.json
• Windows：C:\Users\你的用户名\.openclaw\openclaw.json

在 models.providers 里加入阿里云百炼配置，或者其他兼容 OpenAI 格式的服务：

{
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的阿里云百炼 API-KEY",
        "api": "openai-completions",
        "models": [
          {"id": "qwen-plus", "name": "通义千问-Plus", "contextWindow": 128000, "maxTokens": 8192},
          {"id": "qwen-max", "name": "通义千问-Max", "contextWindow": 128000, "maxTokens": 8192}
        ]
      }
    }
  }
}

apiKey 也可以用环境变量 ${BAILIAN_API_KEY}，这样比直接写进文件里安全一点。

用 Onboarding 向导配置

不想手改文件的话，直接再跑一次：

openclaw onboard

在交互菜单里选 Model/auth provider，然后选阿里云百炼，把 API Key 粘进去就行。

接入飞书机器人

这一步才是重点。前面的安装都只是铺路，飞书通道打通了，OpenClaw 才算真正进入可用状态。

在飞书开放平台创建应用

1. 打开 飞书开放平台，用企业账号登录。
2. 点击 创建应用 -> 企业自建应用，填应用名和描述，比如'我的小龙虾助手'。
3. 创建完后进应用详情页，在左侧 凭证与基础信息 里拿到 App ID 和 App Secret，先保存好。

配置 OpenClaw 的飞书通道

OpenClaw 会给你一个接收飞书事件的 HTTP 地址，通常长得像这样：https://你的公网 IP 或域名:18789/api/v1/channels/feishu/webhook。

如果是本地部署，这个地址一般得借助 ngrok 之类的内网穿透工具暴露到公网；如果是云服务器，记得确认公网 IP 可访问，防火墙和阿里云安全组也要放行 18789。

在 OpenClaw 服务器终端执行：

# 格式：openclaw channels add --channel feishu --token "你的 AppID:你的 AppSecret"
openclaw channels add --channel feishu --token "cli_xxxxxxxx:你的 App Secret"

配置飞书事件订阅

回到飞书开放平台后台，打开 事件订阅：

1. 在'请求地址配置'里填上 OpenClaw 提供的事件订阅地址。
2. 在'加密策略'后面点编辑，补上需要的事件。
3. 至少要加和消息相关的权限和事件，比如 message、接收消息，不然机器人收不到群消息。
4. 保存配置。

配权限并发布

这一步经常被忽略，但不配权限，机器人就是个摆设。

常用权限一般包括：

• im:message
• im:message:send_as_bot
• im:chat

然后去 版本管理与发布 创建版本并提交审核。企业管理员的话，流程会短一些，按企业内部的审核方式走就行。

把机器人拉进群

在飞书客户端里打开目标群聊，进群设置，找到 群机器人 -> 添加机器人，搜索你刚才创建的应用名称并添加进去。

验证是否跑通

装完后别急着庆祝，先确认链路真的通了。

在服务器上执行：

openclaw status

或者：

openclaw doctor

确认 Gateway 在跑，飞书通道状态正常。然后去飞书群里 @ 机器人，发一句'你好'。如果配置没问题，它会调模型回复你。

OpenClaw 还有一个比较实用的点是支持多智能体。你可以把不同的飞书机器人放进同一个群里，一个管代码，一个管文案。不是每个场景都需要这样拆，但在多人协作时确实省事。

常见故障怎么排

• openclaw: command not found：通常是 npm 全局安装目录没进 PATH。先用 npm prefix -g 看路径，比如 /usr/local，再把 /usr/local/bin 加到系统 PATH。
• 飞书机器人没回复：先看事件订阅地址是不是已经通过验证，再检查 18789 端口有没有放行，接着看 OpenClaw 日志，命令可以用 openclaw gateway status，或者直接翻 /var/log/openclaw/ 下面的日志。最后别忘了确认 API Key 有没有过期、余额够不够。
• 服务启动失败或内存不够：2GB 可用内存是底线，4GB 会舒服很多。低配机器上我会先加 Swap，不行再考虑升级实例。

把这些步骤走完，OpenClaw 基本就能在飞书里稳定跑起来了。真正麻烦的地方不是安装，而是模型、事件订阅和端口这三处细节，漏一个就会卡住。