基于 OpenClaw 和飞书搭建本地服务器运维 Agent

接入飞书

创建应用

访问飞书开放平台创建企业自建应用。在凭证与基础信息页面记下 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 向导输入 App ID 和 App Secret：

openclaw channels add

选择 Feishu 即可。也可以手动在 openclaw.json 中添加配置：

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

验证连接

重启 Gateway 并查看日志：

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 等命令，收集信息后返回一份结构化的服务器状态报告。更多场景如查看日志、检查磁盘空间、重启服务等均可尝试。

最终的 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" }
}

参考资料

• OpenClaw GitHub