Skip to content

OpenClaw 专项问题

OpenClaw 是什么?怎么安装?

OpenClaw Gateway 是 AI 代理网关,支持通过飞书、Telegram、Discord 等渠道接入 AI 模型。启动后默认 Web UI 地址 http://127.0.0.1:18789/

bash
# 安装
npm install -g openclaw@latest

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

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

OpenClaw 配置 provider 时报 403 block

OpenClaw 作为外接客户端,不同 provider 必须分别配置对应的分组和 User-Agent。

Claude provider

API 端点:https://你的请求地址
API 协议:Anthropic Messages
Headers:
  "Authorization": "Bearer sk-***"
  "User-Agent": "claude-cli/2.0.76 (external, cli)"

Codex provider

API 端点:https://你的请求地址/v1
API 协议:OpenAI Responses
Headers:
  "Authorization": "Bearer sk-***"
  "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"

国产模型 provider

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

关键提醒:不能把 Claude 的 UA 直接复用到 Codex provider,国产模型 provider 也不建议省略浏览器型 UA。

OpenClaw 同一实例能同时接多种模型吗?

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

OpenClaw 飞书渠道配置要点

  1. 前往 open.feishu.cn 创建企业自建应用,添加机器人能力
  2. 在权限管理中筛选 im,全选相关权限
  3. 创建版本并发布,记录 App IDApp Secret
  4. 将 App ID 和 App Secret 填入 OpenClaw 引导界面,或通过命令行写入
bash
openclaw config set -- channels.feishu.appId "你的AppID"
openclaw config set -- channels.feishu.appSecret "你的AppSecret"
  1. 在飞书开放平台进入事件配置页面,添加「接收消息」事件
  2. 重新创建一个版本并发布(否则订阅事件不生效)
  3. 在飞书工作台找到机器人发送消息,获取配对码后执行
bash
openclaw pairing approve feishu 你的配对码

注意:配置飞书订阅事件时 OpenClaw 必须处于运行状态,可通过 openclaw gateway 手动启动。

OpenClaw 群组消息响应策略怎么选?

  • 所有消息均回复:适合私人测试群
  • 仅 @ 机器人时回复:适合多人工作群(推荐)
  • 不在群组中回复:仅支持私聊