基于 OpenClaw 与飞书搭建服务器运维机器人

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

第四步：接入飞书

4.1 创建飞书应用

访问飞书开放平台，创建企业自建应用。

在凭证与基础信息页面，记下 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

4.2 配置飞书 app 信息

使用 CLI 向导：

openclaw channels add

选择 Feishu，输入 App ID 和 App Secret。也可以手动在 openclaw.json 中添加：

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

4.3 重启并确认连接

openclaw gateway restart
openclaw logs --follow

看到以下日志说明飞书长连接成功：

feishu[main]: WebSocket client started
[ws] ws client ready

4.4 配置飞书事件订阅

回到飞书开放平台：

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

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

第五步：配置运维 Agent

5.1 设置 Agent 人设

编辑 ~/.openclaw/workspace/AGENTS.md，在原有内容基础上追加运维规则：

## 服务器运维规则

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

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

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

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

### 语言
- 用中文回复

5.2 配置 exec 工具

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

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

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

5.3 配置命令白名单

编辑 ~/.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 确认。

第六步：测试

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

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

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

更多使用场景：

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

安全策略总结

最终的 openclaw.json 结构

{
  "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" }
}