检查服务状态

openclaw 中文openclaw 2026-04-09 2

我来为您详细介绍 AI 小龙虾 OpenClaw 安装后的飞书集成配置步骤。

检查服务状态-第1张图片-OpenClaw下载中文-AI中文智能体

前期准备

确认 OpenClaw 已正常运行

# 或
systemctl status openclaw

获取服务器公网信息

服务器公网 IP 地址
确保 80/443 端口可访问
建议配置域名（飞书要求 HTTPS）

飞书开放平台配置

创建企业自建应用

访问飞书开放平台
进入「开发者后台」
创建新应用 → 企业自建应用
填写应用名称、描述等信息

配置应用权限

必选权限：
- 获取用户 user_id
- 获取用户基础信息
- 以应用身份读取通讯录
- 获取用户邮箱信息
- 获取用户手机号
- 获取用户组织架构信息
- 获取与发送单聊、群组消息
- 接收消息与事件

配置事件订阅

在应用后台找到「事件订阅」

添加事件：

im.message.receive_v1        # 接收消息
im.message.message_read_v1   # 消息已读

设置请求地址 URL：

https://你的域名或IP:端口/openclaw/api/feishu/webhook

获取凭证信息

记录以下关键信息：

应用凭证：
- App ID: 
- App Secret: 
- Verification Token: 
- Encrypt Key: （如果启用了加密）

OpenClaw 配置文件修改

修改配置文件

# config/config.yaml 或相关配置文件
feishu:
  enabled: true
  app_id: "cli_xxxxxxxxxxxx"        # 替换为你的 App ID
  app_secret: "xxxxxxxxxxxxxxxxxxxx" # 替换为你的 App Secret
  verification_token: "xxxxxxxxxxxx"  # 替换为 Verification Token
  encrypt_key: ""                    # 如果启用加密则填写
  webhook:
    path: "/openclaw/api/feishu/webhook"
    port: 8080                       # 根据实际情况调整
  bot:
    name: "AI小龙虾助手"
    avatar_key: "openclaw_avatar"
  message:
    enable_group: true              # 是否启用群聊
    enable_private: true            # 是否启用私聊
    support_types: ["text", "image", "file"]
  api:
    base_url: "https://open.feishu.cn/open-apis"
    timeout: 30

数据库配置（如果需要）

-- 创建飞书用户映射表（OpenClaw 未自动创建）
CREATE TABLE IF NOT EXISTS feishu_users (
    id INT PRIMARY KEY AUTO_INCREMENT,
    feishu_user_id VARCHAR(64) UNIQUE,
    openclaw_user_id VARCHAR(64),
    name VARCHAR(255),
    avatar VARCHAR(512),
    department VARCHAR(255),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

启动服务

重启 OpenClaw 服务

# Docker 方式
docker-compose down
docker-compose up -d
# 或直接重启
docker restart openclaw
# Systemd 方式
systemctl restart openclaw

验证服务

# 检查日志
docker logs -f openclaw
# 或查看日志文件
tail -f /var/log/openclaw/app.log

测试连通性

# 测试 webhook 端点
curl -X POST https://你的域名/openclaw/api/feishu/webhook \
  -H "Content-Type: application/json" \
  -d '{"challenge":"test123"}'

飞书应用发布

版本管理与发布

在飞书开发者后台创建版本
填写版本号、更新说明
申请可用范围（全员或部分成员）
提交审核

测试环境配置

# 开发环境特殊配置（如果需要）
development:
  feishu:
    redirect_uri: "http://localhost:3000/auth/callback"
    test_users: ["user_id1", "user_id2"]

常见问题排查

Webhook 验证失败

症状：飞书提示「请求地址验证失败」解决：

确认服务器时间同步
检查 Verification Token 是否正确
确认 HTTPS 证书有效
检查防火墙/安全组设置

收不到消息

检查步骤：

# 1. 检查服务是否运行
netstat -tlnp | grep 8080
# 2. 检查日志
grep "feishu" /var/log/openclaw/app.log
# 3. 测试回调
curl -X POST http://localhost:8080/openclaw/api/feishu/webhook \
  -H "Content-Type: application/json" \
  -d @test_payload.json

权限问题

确认应用已获得所有必要权限
检查用户是否在可用范围
重新申请权限并发布新版本

高级配置（可选）

消息加解密

feishu:
  encrypt_key: "your_encrypt_key_here"
  enable_encrypt: true

多租户支持

multi_tenant:
  enabled: true
  tenants:
    - app_id: "app_id_1"
      departments: ["dept_id_1"]
    - app_id: "app_id_2"
      departments: ["dept_id_2"]

监控配置

monitoring:
  feishu_webhook:
    enabled: true
    metrics_path: "/metrics"
    alert_rules:
      - name: "webhook_error_rate"
        threshold: "5%"