OpenClaw飞书渠道ACP功能启动的实现步骤

# 查看网关状态
openclaw gateway status
# 实时查看日志，确认飞书连接正常
openclaw logs --follow

{
  "scopes": {
    "tenant": [
      "im:chat",
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_msg",
      "im:message:send_as_bot",
      "im:message:readonly",
      "im:resource",
      "docs:document.content:read",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

# OpenClaw ≥ 2026.2 已内置飞书插件，无需额外安装
openclaw channels add
# 选择 Feishu → 粘贴 App ID → 粘贴 App Secret
openclaw gateway restart

{
  "acp": {
    "enabled": true,
    "dispatch": { "enabled": true },
    "backend": "acpx",
    "defaultAgent": "codex",
    "allowedAgents": ["pi", "claude", "codex", "opencode", "gemini", "kimi"],
    "maxConcurrentSessions": 8,
    "stream": {
      "coalesceIdleMs": 300,
      "maxChunkChars": 1200
    },
    "runtime": {
      "ttlMinutes": 120
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxx",
          "appSecret": "你的AppSecret"
        }
      }
    }
  }
}

# 安装 acpx 后端插件
openclaw plugins install acpx
openclaw config set plugins.entries.acpx.enabled true
# 重启网关使配置生效
openclaw gateway restart
# 验证后端健康状态
/acp doctor

# 方案一：完全开放权限（适合受信任的个人开发环境）
openclaw config set plugins.entries.acpx.config.permissionMode approve-all
# 方案二：保守策略，写入被静默拒绝而不崩溃（适合对权限有顾虑的场景）
openclaw config set plugins.entries.acpx.config.permissionMode approve-reads
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions deny
# 修改后必须重启网关
openclaw gateway restart

# 启动一个持久化 Codex 会话，绑定到当前对话
/acp spawn codex --mode persistent --thread auto
# 查看当前会话状态
/acp status
# 按需调整运行时参数
/acp model anthropic/claude-opus-4-5
/acp permissions approve-all
/acp timeout 300
# 向运行中的会话发送引导指令（不替换上下文）
/acp steer 重点关注性能优化，继续
# 停止当前轮次（保留会话）
/acp cancel
# 关闭会话并解除绑定
/acp close

# 先查看近期会话列表
/acp sessions
# 续接指定会话
# 在飞书中告诉机器人：
# "用 sessions_spawn 工具续接我之前的 Codex 会话，resumeSessionId 是 <session-id>"

Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host.
Use runtime="subagent" from sandboxed sessions.

{
  "channels": {
    "feishu": {
      "domain": "lark",
      "connectionMode": "webhook",
      "webhookPort": 3000,
      "webhookPath": "/feishu/events",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxx",
          "appSecret": "你的AppSecret"
        }
      }
    }
  }
}

# 安装 cloudflared（macOS）
brew install cloudflared
# 暴露本地 3000 端口
cloudflared tunnel --url http://localhost:3000