OpenClaw 专项问题

OpenClaw 是 AI 代理网关，支持通过飞书、Telegram、Discord 等渠道接入模型。基础安装与使用见 OpenClaw 配置教程，本页只收录常见问题。

安装与初始化

# 安装
npm install -g openclaw@latest

# 初始化引导
openclaw onboard --install-daemon

引导流程：选择 QuickStart → 跳过供应商选择 → 选择全模型 → 保持默认模型 → 选择通知渠道（飞书 / Telegram / Discord）→ 配置 Skills 和 Hooks（推荐勾选 session-memory）。

启动后默认 Web UI 地址为 http://127.0.0.1:18789/。

配置 provider 时报 403 block

OpenClaw 属于外接客户端，不同 provider 必须分别配置对应的分组、协议和 User-Agent，不能共用一套。

Claude provider

API 端点：https://api.wow3.top
API 协议：Anthropic Messages
请求头：
  Authorization: Bearer sk-***
  User-Agent: claude-cli/2.0.76 (external, cli)

Codex provider

API 端点：https://api.wow3.top/v1
API 协议：OpenAI Responses
请求头：
  Authorization: Bearer sk-***
  User-Agent: codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal

国产模型 provider

请求头：
  Authorization: Bearer sk-***
  User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0

不要复用 UA

把 Claude 的 User-Agent 直接用在 Codex provider 上会被拒；国产模型 provider 也不要省略浏览器型 UA。

同一个实例能同时接多种模型吗？

可以。同一个 OpenClaw 可以同时接 Claude、Codex 和国产模型，但每个 provider 要分别选对应分组、分别填对应 User-Agent，不能混用。

飞书渠道配置要点

1. 前往 open.feishu.cn 创建企业自建应用，添加机器人能力
2. 在权限管理中筛选 im，全选相关权限
3. 创建版本并发布，记录 App ID 和 App Secret
4. 把 App ID 和 App Secret 填入引导界面，或用命令行写入：

openclaw config set -- channels.feishu.appId "你的AppID"
openclaw config set -- channels.feishu.appSecret "你的AppSecret"

5. 在飞书开放平台的事件配置页，添加「接收消息」事件
6. 重新创建一个版本并发布——否则订阅事件不生效
7. 在飞书工作台找到机器人发送消息，拿到配对码后执行：

openclaw pairing approve feishu 你的配对码

配置订阅事件时 OpenClaw 必须在运行

飞书需要回调验证，所以配置订阅事件时 OpenClaw 要处于运行状态，可用 openclaw gateway 手动启动。

群组消息响应策略怎么选？

策略	适用场景
所有消息均回复	私人测试群
仅 @ 机器人时回复	多人工作群（推荐）
不在群组中回复	只做私聊