使用指南API 参考AI 应用

OpenClaw

OpenClaw 是一个开源、自托管的个人 AI 智能体与网关平台。它能够将 Telegram、Discord、WhatsApp 等多渠道消息无缝连接到运行在本地硬件上的 AI 代理,支持多代理协同路由、持久记忆与自主工具调用,让开发者掌控专属的私有 AI 助手。

✨ AI 一键配置

复制下方提示词发送给您的 AI 助手,即可自动完成环境探测与安装配置:

AI 配置提示词 (Prompt)
点击卡片任意位置复制
请参考 OpenRely 官方文档(https://openrely.ai/zh/docs/apps/openclaw)帮我配置当前机器的 OpenClaw:
1. 获取密钥:若我尚未提供 API 密钥,请先提醒我前往 OpenRely 控制台(https://api.openrely.ai/keys)创建并输入
2. 环境安装:检查本机是否已安装 OpenClaw,若未安装则运行 curl -fsSL https://openclaw.ai/install.sh | bash 并执行 openclaw onboard
3. 配置文件:修改 ~/.openclaw/openclaw.json,在 models.providers 中添加 openrely 提供商:
baseUrl 为 https://api.openrely.ai/v1,api 为 openai-completions,apiKey 填入 <我的_API_KEY>;
将 agents.defaults.model.primary 设置为主模型(如 openrely/<主模型标识>,支持的模型列表可随时查阅 OpenRely 模型定价中心 https://api.openrely.ai/pricing)
4. 验证就绪:执行 openclaw gateway status 检查服务状态,并运行 openclaw dashboard 打开控制台验证

🔑 准备


🚀 步骤

安装与初始化 OpenClaw

OpenClaw 支持在 macOS 与 Linux 环境下一键安装:

# 1. 执行官方一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

# 2. 运行基础引导向导
openclaw onboard --install-daemon

向导将完成基础网关进程初始化与守护进程注册。

配置 OpenRely 端点与模型

OpenClaw 使用 ~/.openclaw/openclaw.json 管理多模型网关配置。打开该文件,在 models.providers 中声明 openrely 自定义提供商:

{
  models: {
    mode: "merge",
    providers: {
      openrely: {
        baseUrl: "https://api.openrely.ai/v1",
        apiKey: "sk-your-openrely-api-key", // 亦可使用环境变量 "${OPENRELY_API_KEY}"
        api: "openai-completions",
        models: [
          { id: "<主模型标识>", name: "Primary Model" },
          { id: "<备用模型标识>", name: "Fallback Model" }
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "openrely/<主模型标识>",
        fallbacks: ["openrely/<备用模型标识>"],
      },
    },
  },
}

启动与验证

检查 OpenClaw 网关守护进程状态,并打开可视化控制面板:

# 1. 检查网关运行状态
openclaw gateway status

# 2. 打开可视化管理看板
openclaw dashboard

您也可以在终端中执行以下命令,确认已加载的模型列表中包含 openrely/ 前缀的模型:

openclaw models list

若能成功在控制面板中发起对话并流式回复,即表示已成功接入 OpenRely。


💡 常用

在 OpenClaw 运维与日常管理中,常用的控制指令:

指令说明
openclaw dashboard唤起浏览器打开可视化 Web 管理面板
openclaw gateway status查看当前网关守护进程状态与端口监听
openclaw gateway restart重启网关进程以快速重载最新的配置文件
openclaw models list列出全量已注册的模型与提供商状态

❓ 常见问题

遇到其他调用报错或计费疑问?请查阅完整的 常见问题与排障指南。

这篇文档对您有帮助吗?

OpenClaw | OpenRely Docs