OpenClaw 部署与飞书机器人接入指南

2.1.3 Docker 手动部署（进阶稳定）

如果你更喜欢用 Docker 进行环境隔离，可以通过 SSH 连接到服务器后执行以下命令：

# 1. 拉取官方镜像
docker pull openclaw/openclaw:2026.3.8

# 2. 创建数据目录
mkdir -p /opt/openclaw/{config,skills,agents,logs,feishu-config}

# 3. 启动容器
docker run -d \
  --name openclaw \
  --restart always \
  -p 18789:18789 \
  -v /opt/openclaw/config:/app/config \
  -v /opt/openclaw/skills:/app/skills \
  -v /opt/openclaw/feishu-config:/app/feishu-config \
  -e TZ=Asia/Shanghai \
  openclaw/openclaw:2026.3.8

# 4. 进入容器进行初始化
docker exec -it openclaw bash openclaw init --feishu

2.2 方案 B：本地 Windows 11 部署（测试、隐私优先）

适合个人测试或数据不想上传云端的场景。

2.2.1 安装系统依赖

1. 安装 Node.js：
   • 下载 Node.js 官网的 LTS 版（22.x 或 24.x）。
   • 安装时务必勾选 'Add to PATH'。
   • 安装后打开 PowerShell，输入 node -v 和 npm -v 验证版本。
2. 安装 Git：从 Git 官网下载安装包，保持默认选项，确保 'Git Bash Here' 和 'Add Git to PATH' 被勾选。
3. 安装 Visual C++ Redistributable：Win10/Win11 通常需要此运行库，从微软官网下载安装 x64 版本。

2.2.2 配置 PowerShell 与 npm 镜像

1. 以管理员身份打开 PowerShell。

配置 npm 国内镜像（加速下载）：

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

解除脚本执行限制（关键步骤）：

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

*按 Y 确认。

2.2.3 一键安装 OpenClaw

在 PowerShell 中执行官方 Windows 安装脚本：

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

等待脚本自动运行完成。

2.2.4 初始化与启动

打开控制面板：

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789，进入 OpenClaw 图形化管理界面。

运行配置向导（首次安装）：

openclaw onboard --install-daemon

此向导会引导你设置模型提供商（可先跳过或临时选择，后续会修改）。

启动 Gateway 服务：

openclaw gateway start

第三部分：配置 AI 模型（以阿里云百炼为例）

无论你采用哪种部署方式，安装完成后，都需要告诉 OpenClaw 使用哪个大模型。你可以通过修改配置文件或在 Web UI 中完成。

3.1 配置文件方式

OpenClaw 的配置文件通常位于 ~/.openclaw/openclaw.json（Linux/Mac）或 C:\Users\你的用户名\.openclaw\openclaw.json（Windows）。在配置文件的 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} 引用，更安全。

3.2 使用 Onboarding 向导

如果你不想手动编辑文件，也可以在终端重新运行 openclaw onboard 命令，在交互式菜单中选择'Model/auth provider'，然后选择'阿里云百炼'并粘贴你的 API Key。

第四部分：接入飞书机器人（核心步骤）

这是让 OpenClaw 进入飞书群聊的关键环节。

4.1 在飞书开放平台创建应用

1. 访问 飞书开放平台，登录你的企业账号。
2. 点击**'创建应用'** -> '企业自建应用'，填写应用名称（如'我的小龙虾助手'）和描述。
3. 创建完成后，进入应用详情页，点击左侧**'凭证与基础信息'**，获取 App ID 和 App Secret（保存好，后面要用）。

4.2 配置 OpenClaw 飞书通道

1. 获取事件订阅地址： 添加通道后，OpenClaw 会生成一个用于接收飞书事件的 HTTP 地址（通常是 https://你的公网 IP 或域名:18789/api/v1/channels/feishu/webhook 或类似格式）。
   • 如果是本地部署，需要使用内网穿透工具（如 ngrok）将本地地址暴露到公网。
   • 如果是云服务器，请确保使用的是公网 IP，并且防火墙（以及阿里云安全组）已放行 18789 端口。

在 OpenClaw 中添加飞书通道： 在你的 OpenClaw 服务器终端（或本地 PowerShell）中执行：

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

*参考 QQ Bot 的添加逻辑。

4.3 配置飞书应用的事件订阅

1. 回到飞书开放平台的应用管理后台。
2. 点击左侧**'事件订阅'**。
3. 在'请求地址配置'中，粘贴上一步获取的 OpenClaw 事件订阅地址。
4. 点击**'加密策略'**后面的'编辑'，添加事件。
   • 搜索并添加 message 相关的权限和事件（如 接收消息），这是机器人能收到并回复消息的基础。
5. 添加完成后，点击'保存'。

4.4 配置权限与发布

1. 权限管理：在左侧'权限管理'中，添加机器人需要的权限。通常至少需要：
   • im:message
   • im:message:send_as_bot （以机器人的身份发送消息）
   • im:chat （获取群聊信息）
2. 发布版本：点击左侧'版本管理与发布'，创建一个版本并提交审核（需企业管理员审核）。或者，如果你是企业管理员，可以直接点击'申请发布'，然后在审核中通过。

4.5 将机器人添加到飞书群

1. 在飞书客户端，打开你想让机器人工作的群聊。
2. 点击群设置 -> '群机器人' -> '添加机器人'。
3. 搜索你刚才创建的应用名称（如'我的小龙虾助手'），点击添加。

第五部分：验证与使用

1. 检查 OpenClaw 状态： 在服务器终端执行 openclaw status 或 openclaw doctor，确保 Gateway 正在运行，且飞书通道状态正常。
2. 在飞书群中互动：
   • 在飞书群里直接 @ 你的机器人，发送一条消息，比如'你好'。
   • 如果配置正确，机器人会调用配置好的大模型进行思考，并回复消息。
   • 进阶技巧：OpenClaw 支持多智能体，你可以配置多个飞书机器人账号加入同一个群，分别响应不同领域的问题（如一个负责编程，一个负责文案），实现'一群多助手'。

常见问题排查

• 提示 openclaw: command not found： npm 全局安装目录未添加到 PATH。执行 npm prefix -g 找到路径（如 /usr/local），然后将 /usr/local/bin 添加到系统的 PATH 环境变量中。
• 飞书机器人无回复：
  1. 检查飞书开放平台的事件订阅地址是否验证通过。
  2. 检查服务器防火墙和安全组是否放行了 18789 端口。
  3. 查看 OpenClaw 日志：openclaw gateway status 或查看 /var/log/openclaw/ 下的日志文件。
  4. 确认 API Key 是否有效，余额是否充足。
• 服务启动失败/内存不足： OpenClaw 需要至少 2GB 可用内存（建议 4GB）。如果是低配服务器，建议增加 Swap（交换分区）或升级配置。

通过以上步骤，你应该已经成功将 OpenClaw 接入飞书，拥有一个 24 小时在线的 AI 协作了。