37b 飞书机器人与 MCP 搭建

# 全局安装 OpenClaw
npm install -g openclaw
 
# 验证安装
openclaw --version
 
# 初始化项目目录
mkdir ~/hackquest-agent && cd ~/hackquest-agent
openclaw init

hackquest-agent/
├── .openclaw/
│   ├── config.json          ← 主配置文件
│   ├── memory/              ← 记忆系统存储目录
│   └── logs/                ← 运行日志
├── skills/                  ← Skill 文件目录
│   └── example.md           ← 示例 Skill
└── mcp/                     ← MCP 配置目录
    └── servers.json         ← MCP Server 配置

# 启动 daemon 模式
openclaw daemon start
 
# 查看运行状态
openclaw daemon status
 
# 停止
openclaw daemon stop
 
# 查看日志
openclaw daemon logs --tail 100

{
  "name": "hackquest-agent",
  "model": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "fallback": "claude-haiku-4-20250514"
  },
  "daemon": {
    "enabled": true,
    "port": 3100,
    "logLevel": "info",
    "maxConcurrent": 5
  },
  "memory": {
    "enabled": true,
    "persistPath": ".openclaw/memory"
  },
  "plugins": [],
  "mcp": {
    "configPath": "mcp/servers.json"
  }
}

{
  "plugins": [
    {
      "name": "feishu",
      "config": {
        "appId": "cli_xxxxxxxxxxxx",
        "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "mode": "websocket",
        "eventTypes": [
          "im.message.receive_v1",
          "drive.file.bitable_record_changed_v1"
        ]
      }
    }
  ]
}

Lark 服务器 → HTTPS → Cloudflare Tunnel → localhost:3100 → OpenClaw

# macOS
brew install cloudflared
 
# Linux
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared
chmod +x cloudflared
sudo mv cloudflared /usr/local/bin/
 
# 登录 Cloudflare（首次使用）
cloudflared tunnel login
 
# 创建隧道
cloudflared tunnel create hackquest-agent
 
# 配置隧道路由
cloudflared tunnel route dns hackquest-agent agent-webhook.hackquest.io

tunnel: <TUNNEL_ID>
credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
 
ingress:
  - hostname: agent-webhook.hackquest.io
    service: http://localhost:3100
  - service: http_status:404

# 启动隧道（生产环境用 systemd 管理）
cloudflared tunnel run hackquest-agent

{
  "plugins": [
    {
      "name": "feishu",
      "config": {
        "appId": "cli_xxxxxxxxxxxx",
        "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "mode": "webhook",
        "webhookPort": 3100,
        "webhookPath": "/lark/event",
        "verificationToken": "xxxxxxxxxxxxxxxx",
        "encryptKey": "xxxxxxxxxxxxxxxx",
        "eventTypes": [
          "im.message.receive_v1",
          "drive.file.bitable_record_changed_v1"
        ]
      }
    }
  ]
}

https://agent-webhook.hackquest.io/lark/event

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic/lark-mcp@latest"],
      "env": {
        "LARK_APP_ID": "cli_xxxxxxxxxxxx",
        "LARK_APP_SECRET": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "LARK_BASE_URL": "https://open.feishu.cn"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://readonly:password@localhost:5432/hackquest"
      }
    }
  }
}

# 查看已配置的 MCP Server
openclaw mcp list
 
# 测试单个 MCP Server 连接
openclaw mcp test lark-mcp
openclaw mcp test github
openclaw mcp test postgres
 
# 查看某个 MCP Server 提供的工具列表
openclaw mcp tools lark-mcp

# hello-world
 
当用户发送包含"你好"、"hello"、"测试"的消息时，回复一条欢迎消息。
 
## 触发条件
用户消息包含"你好"、"hello"、"hi"、"测试"等问候词。
 
## 执行步骤
1. 识别用户的飞书昵称
2. 回复一条包含用户昵称的欢迎消息
3. 简要介绍自己能做什么
 
## 输出格式
回复消息格式：
- 第一行：问候语 + 用户昵称
- 第二行：自我介绍（一句话）
- 第三行：列出 3-5 个核心能力
 
## 示例输出
你好，张三！👋
我是 HackQuest AI Agent，你的团队智能助手。
我可以帮你：
• 创建和管理需求/缺陷
• 查询项目数据和生成报表
• 搜索知识库回答问题
• 查看 GitHub PR 和代码
• 生成工作总结和 OKR 报告

# 重新加载 Skill（如果 daemon 已运行，Skill 会自动热加载）
openclaw skill reload
 
# 查看已加载的 Skill 列表
openclaw skill list
 
# 本地测试（不经过飞书，直接在终端对话）
openclaw chat
> 你好

# test-mcp
 
测试 MCP 工具连接是否正常。
 
## 触发条件
用户消息包含"测试 MCP"、"测试工具"。
 
## 执行步骤
1. 调用 lark-mcp 获取当前用户信息
2. 调用 github MCP 获取仓库列表
3. 汇总测试结果
 
## 输出格式
以表格形式展示每个 MCP 工具的连接状态：
| 工具 | 状态 | 说明 |