问题背景

在使用 OpenClaw 多 Agent 系统时，我们遇到了一个典型的问题：同一个 Agent 在多个地方同时运行，导致频道占用冲突。具体表现为小智在飞书和 QQBot 频道出现 “access not configured” 错误，无法正常工作。

问题现象

当同一个 Agent 在多个地方运行时，会出现以下问题：

• 频道占用冲突：多个实例争夺同一个频道连接
• 配对状态混乱：消息路由到错误的实例
• 访问错误：出现 “access not configured” 错误

根本原因分析

经过排查，发现问题的根本原因是：Linux 上的小智实例与当前运行的小智实例发生冲突，导致频道被两个相同的小智占用，引发匹配问题。

解决方案

步骤一：识别冲突实例

首先检查是否有多个相同 Agent 在运行：

# 查看运行的 Agent 进程
ps aux | grep 小智

# 或检查 OpenClaw 状态
openclaw status

步骤二：关闭冲突实例

关闭 Linux 上的重复实例：

# 停止 Linux 上的 Agent 服务
openclaw agent stop 小智

# 或终止相关进程
kill <pid>

步骤三：验证修复

确认小智可以正常通过飞书和 QQBot 工作：

1. 发送测试消息到飞书小智
2. 发送测试消息到 QQBot 小智
3. 确认响应正常，无 “access not configured” 错误

预防措施

基本原则

确保每个 Agent 只在一个地方运行

多平台运行方案

如果需要在多个平台运行，使用以下方法避免冲突：

• 不同 Agent ID：为每个实例分配唯一 ID
• 不同账户配置：使用独立的账户配置文件
• 单一主实例：只保留一个活跃实例，其他作为备份

检查清单

• 部署新实例前检查是否已有运行实例
• 定期审查运行的 Agent 列表
• 记录每个 Agent 的运行位置
• 设置监控告警检测重复实例

总结

这是一个典型的多实例冲突问题。当同一个 Agent 在多个地方运行时，会导致频道占用冲突、配对状态混乱。解决方案是关闭重复实例，并建立预防措施确保每个 Agent 只在一个地方运行。

关键要点：

• 发现问题：access not configured 错误
• 排查原因：多实例冲突
• 解决方案：关闭重复实例
• 预防措施：单一实例原则