OpenClaw集成指南

本页说明如何将kmsg安全地接入OpenClaw或其他MCP客户端。

基本模型

集成包含两个独立接口。

• 请求与响应: kmsg mcp-server
• 实时事件: kmsg watch --json

MCP服务器提供kmsg_read、kmsg_send和kmsg_send_image。watch并非MCP工具；若要实时自动回复，需要一个supervisor把事件转交给OpenClaw。

推荐架构

复制kmsg watch --json
    ↓ one JSON object per event
supervisor / OpenClaw
    ↓ reasoning and approval
kmsg_send through MCP

将长时间运行的监控流与短时MCP调用分开，便于独立处理重启、去重和审批。

使用前检查

复制kmsg status --verbose
kmsg chats --limit 20
kmsg send "聊天名称" "连接测试" --dry-run

MCP配置

复制kmsg mcp-server

客户端配置示例:

复制{
  "mcpServers": {
    "kmsg": {
      "command": "/absolute/path/to/kmsg",
      "args": ["mcp-server"],
      "env": {
        "KMSG_MCP_TIMEOUT_SECONDS": "30",
        "KMSG_DEFAULT_LAYOUT": "preserve",
        "KMSG_DEFAULT_BACKGROUND_SAFE": "true"
      }
    }
  }
}

实时监控

复制kmsg watch "聊天名称" --json

每个事件向stdout写入一个JSON对象，诊断日志写入stderr。supervisor应负责重启、去重、速率限制和审批策略。

工具契约

kmsg_read

复制{
  "name": "kmsg_read",
  "arguments": {
    "chat": "聊天名称",
    "limit": 20,
    "background_safe": true
  }
}

background_safe=true只读取已经显示的匹配窗口，不会启动、激活、登录、搜索或调整KakaoTalk窗口。

kmsg_send

复制{
  "name": "kmsg_send",
  "arguments": {
    "chat": "聊天名称",
    "message": "你好",
    "confirm": true
  }
}

• confirm=true: 不发送，返回CONFIRMATION_REQUIRED
• confirm=false或省略: 立即发送
• dry_run=true: 不操作UI，只检查目标与内容

kmsg_send_image

复制{
  "name": "kmsg_send_image",
  "arguments": {
    "chat": "聊天名称",
    "image_path": "/absolute/path/image.png",
    "confirm": true
  }
}

运行模式

推荐: 先生成草稿，再审批

1. 通过kmsg_read或watch事件获取上下文。
2. AI智能体生成回复草稿。
3. 人或策略引擎检查收件目标与内容。
4. 仅将获批请求以confirm=false发送。

个人聊天中的误发成本较高，因此推荐把此流程作为默认模式。

完全自动回复

仅在supervisor限制了允许的聊天、发送频率、重试次数、最大长度、禁用词和紧急停止开关时启用。

故障排除

• 在command中使用可执行kmsg的绝对路径
• 运行kmsg status --verbose检查权限和KakaoTalk状态
• background-safe失败时，先显示目标聊天窗口
• 同一连接内不要混用不同MCP帧格式

完整字段与响应示例请参阅英文OpenClaw指南。