使用 OpenClaw 和飞书搭建 7x24 小时服务器运维机器人

概述

OpenClaw 是一个可在本地运行的 AI Agent 网关，通过它我们可以构建一个能随时响应指令的运维机器人。核心思路是：将飞书等聊天平台的消息路由至大模型，模型调用本地工具（如 Shell、文件系统）执行任务，再将结果自动返回给会话。

架构概览

飞书 App (WebSocket 长连接)
↕
OpenClaw Gateway (服务器上 systemd 常驻)
↕
AI 模型 (DeepSeek v3.2/GLM 4.7)
↕
服务器 Shell (受白名单限制的命令执行)

关键组件包括管理会话与渠道连接的 OpenClaw Gateway、负责收发消息的飞书插件、支持白名单策略的 exec 工具，以及自定义的模型提供商。

环境准备

• Linux 服务器（本文以 Ubuntu 为例）
• Node.js 22+
• npm 10+
• 飞书企业账号（免费创建即可）
• AI 模型 API（兼容 OpenAI 格式的接口均可）

安装与服务化

为了让机器人直接管理服务，建议采用裸机全局安装而非 Docker。

npm install -g openclaw

安装后确认命令可用。若提示 command not found，需将 npm 全局 bin 目录加入 PATH：

echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

接着将其注册为系统服务，实现开机自启与后台常驻：

openclaw gateway install
openclaw gateway start
openclaw gateway status

配置模型提供商

编辑 ~/.openclaw/openclaw.json，添加模型配置。这里以 OneRouter + DeepSeek V3.2 为例：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "onerouter/deepinfra/deepseek-v3.2"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "onerouter": {
        "baseUrl": "https://your-api-endpoint/v1",
        "apiKey": "your-api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepinfra/deepseek-v3.2",
            "name": "DeepSeek V3.2"
          }
        ]
      }
    }
  }
}

任何兼容 OpenAI API 格式的模型提供商都可以用这种方式接入。

接入飞书

创建应用

访问飞书开放平台，创建企业自建应用。在凭证与基础信息页面记下 App ID 和 App Secret。权限管理中需添加以下权限：

• im:message — 发送消息
• im:message:send_as_bot — 以机器人身份发送
• im:message.p2p_msg:readonly — 读取私聊消息
• im:message.group_at_msg:readonly — 读取群聊@消息
• im:resource — 读取资源
• contact:contact.base:readonly — 读取联系人基本信息（可选）

在应用能力中启用机器人，并安装飞书插件：

openclaw plugins install @openclaw/feishu

配置与应用对接

使用 CLI 向导添加通道：

openclaw channels add

选择 Feishu，输入 App ID 和 App Secret。也可以手动在配置文件中添加：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxxxx",
          "appSecret": "your-app-secret"
        }
      }
    }
  }
}

重启网关并查看日志确认连接成功：

openclaw gateway restart
openclaw logs --follow

看到 feishu[main]: WebSocket client started 说明长连接已建立。

事件订阅

回到飞书开放平台：

1. 事件与回调 → 选'使用长连接接收事件' → 保存
2. 添加事件 im.message.receive_v1
3. 版本管理与发布 → 创建版本 → 发布

注意：必须先启动 Gateway 建立长连接，飞书后台才能保存订阅方式。

配置运维 Agent

设定人设

编辑 ~/.openclaw/workspace/AGENTS.md，追加运维规则：

## 服务器运维规则

你同时是一个服务器运维助手，负责维护管理员在这台服务器上部署的服务。

### 工作范围
- 只管理 /home/youruser/projects 目录下的项目和服务
- 不要触碰其他用户的文件和服务

### 允许的操作
- 查看日志、进程、服务状态、端口、磁盘/内存
- 管理用户级服务（systemctl --user）
- 工作目录下的文件操作

### 禁止的操作
- rm -rf（用 trash 代替）
- sudo 操作（除非明确要求）
- 修改系统配置
- 重启其他用户的服务

### 语言
- 用中文回复

配置 exec 工具

在 openclaw.json 中添加工具配置，让 Agent 可以在服务器上执行命令：

{
  "tools": {
    "exec": {
      "host": "gateway",
      "security": "allowlist",
      "ask": "off"
    }
  }
}

• host: "gateway" — 命令直接在服务器本机执行
• security: "allowlist" — 只允许白名单命令，安全可控
• ask: "off" — 不弹审批提示（7x24 自动化需要）

设置命令白名单

编辑 ~/.openclaw/exec-approvals.json，为 Agent 配置允许执行的命令：

{
  "version": 1,
  "defaults": {
    "security": "allowlist",
    "ask": "off",
    "askFallback": "allowlist"
  },
  "agents": {
    "main": {
      "security": "allowlist",
      "ask": "off",
      "askFallback": "allowlist",
      "allowlist": [
        { "pattern": "/usr/bin/bash" },
        { "pattern": "/usr/bin/sh" },
        { "pattern": "/usr/bin/ls" },
        { "pattern": "/usr/bin/cat" },
        { "pattern": "/usr/bin/tail" },
        { "pattern": "/usr/bin/head" },
        { "pattern": "/usr/bin/find" },
        { "pattern": "/usr/bin/du" },
        { "pattern": "/usr/bin/df" },
        { "pattern": "/usr/bin/free" },
        { "pattern": "/usr/bin/ps" },
        { "pattern": "/usr/bin/top" },
        { "pattern": "/usr/bin/ss" },
        { "pattern": "/usr/bin/netstat" },
        { "pattern": "/usr/bin/journalctl" },
        { "pattern": "/usr/bin/systemctl" },
        { "pattern": "/usr/bin/git" },
        { "pattern": "/usr/bin/docker" },
        { "pattern": "/usr/bin/node" },
        { "pattern": "/usr/bin/python3" }
      ]
    }
  }
}

重要：/usr/bin/bash 和 /usr/bin/sh 必须加上，否则带管道的命令无法执行。路径可能因系统而异，用 which <command> 确认。

测试与验证

重启 Gateway 后在飞书里直接对机器人说话：

帮我看看服务器上哪些服务在运行

机器人会自动调用 systemctl、ps、ss 等命令，收集信息后返回一份结构化的服务器状态报告。

更多使用场景：

• "查看 xxx 服务的最近日志"
• "服务器磁盘还剩多少空间"
• "帮我重启一下 xxx 服务"
• "看看哪些端口在监听"

安全策略总结

层级	措施	说明
命令执行	allowlist 白名单	只允许指定的二进制文件
工作范围	AGENTS.md 规则	Agent 被指示只操作特定目录
飞书接入	pairing 配对	新用户需要管理员批准才能使用
系统权限	非 root 运行	Gateway 以普通用户身份运行

最终配置结构

{
  "plugins": { "entries": { "feishu": { "enabled": true } } },
  "agents": {
    "defaults": {
      "model": { "primary": "your-provider/your-model" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": { "...": "..." }
  },
  "tools": {
    "exec": {
      "host": "gateway",
      "security": "allowlist",
      "ask": "off"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxxxx",
          "appSecret": "your-secret"
        }
      }
    }
  },
  "gateway": { "mode": "local" }
}