Skip to main content

OpenClaw 是什么

OpenClaw 是开源、自托管的个人 AI 助手和 Gateway,可以把 WhatsApp、Slack、Discord、Telegram、iMessage 和 WebChat 等聊天渠道连接到 AI 代理。配置自定义 OpenAI 兼容和 Anthropic 兼容模型提供商后,它可以通过 Capriole AI 发送受支持的模型请求。

前置条件

开始前请确保你已经拥有以下内容。

安装

配置

配置 GPT 提供商。
配置 Claude、Grok、GLM 和 Kimi Chat Completions 提供商。
配置 Anthropic 提供商。
允许默认代理使用已经配置的 Capriole AI 模型。

运行 OpenClaw

启动 Gateway。
在另一个终端中打开 TUI。

支持的模型

OpenClaw 可以通过 Capriole AI 使用 OpenAI latest、GPT 5.6 Thinking、GPT 5.6、GPT 5.5、GPT 5.4 mini、Fable 5、Opus 5、Grok 4.5、GLM 5.2、Kimi K3、Claude latest、Opus 4.8、Opus 4.7、Opus 4.6 和 Sonnet 4.6。Fable 5 和 Opus 5 可以使用 Chat Completions 兼容提供商,也可以使用 Anthropic Messages 提供商。
  • openai-latest
  • openai/gpt-5.6-terra
  • openai/gpt-5.6-luna
  • openai/gpt-5.5
  • openai/gpt-5.4-mini
  • anthropic/claude-fable-5
  • anthropic/claude-opus-5
  • xai/grok-4.5
  • zai/glm-5.2
  • moonshot/kimi-k3
  • claude-latest
  • claude-fable-5
  • claude-opus-5
  • claude-opus-4-8
  • claude-opus-4-7
  • claude-opus-4-6
  • claude-sonnet-4-6

故障排除

为什么 GPT 请求失败

确认 models.providers.capriole-ai-openai.api 已设为 "openai-responses",并且 baseUrlhttps://api.caprioletech.com/v1

为什么 Grok、GLM 或 Kimi 请求失败

确认 models.providers.capriole-ai-compatible.api 已设为 "openai-completions",并且 baseUrlhttps://api.caprioletech.com/v1

为什么 Anthropic 请求失败

确认 models.providers.capriole-ai-anthropic.api 已设为 "anthropic-messages",并且 Anthropic baseUrl 是不含 /v1https://api.caprioletech.com

为什么身份验证失败

在启动 openclaw gateway 的终端和启动 openclaw tui 的终端中分别导出 CUSTOM_API_KEY

为什么 OpenClaw 提示模型不被允许或不可用

运行 openclaw models list,然后确认所选模型和 agents.defaults.models Allowlist 都包含对应的 Capriole AI 模型引用,例如 capriole-ai-openai/openai-latestcapriole-ai-compatible/xai/grok-4.5capriole-ai-compatible/moonshot/kimi-k3capriole-ai-anthropic/claude-latest 如果 Capriole AI 模型显示为缺失,请使用上方所示的完整对象更新模型条目。当前 OpenClaw 版本配置自定义提供商模型时,只提供 idname 还不够。

为什么 Gateway 无法启动

运行 openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor。先修复 Schema、gateway.mode 或服务问题,再重新尝试。

为什么端口 18789 无法使用

选择另一个本地端口,并在 Gateway 和客户端配置中使用相同端口。对于服务模式安装,更改端口后运行 openclaw doctor --fixopenclaw gateway install --force

说明

  • OpenClaw 自定义提供商要求提供商 API 模式与 Capriole AI 端点系列匹配。
  • OpenClaw 2026.4.21 可以通过 openai-completions,使用 Grok 4.5、GLM 5.2 和 Kimi K3 完成本地 exec 工具工作流。
  • Capriole AI 处理模型请求。OpenClaw 仍可通过自身的 Gateway、渠道和代理设置决定助手的最终行为。
  • 官方参考资料包括 OpenClaw 安装OpenClaw 自定义提供商OpenClaw 模型提供商OpenClaw 故障排除
最后修改于 2026年8月18日