• 官方主页：https://openclaw.ai
• 项目文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
  

OpenClaw 完全开源，你可以在 OpenClaw 的 GitHub 仓库 浏览源码、提交 Issue 或参与贡献。本教程涵盖安装、配置，以及将 OpenClaw 对接 New API 的完整步骤。

省流版

OpenClaw一键部署网址：https://openclaw.unreachablecity.vip/

Step1: 进行OpenClaw配置前准备

1. 在Oasis API网站注册登录

   • 国际版链接：https://chatbot.unreachablecity.club
   • 国内版链接：https://chatbot.cn.unreachablecity.club

2. 创建API令牌

   • 国际版链接：https://chatbot.unreachablecity.club/console/token
   • 国内版链接：https://chatbot.cn.unreachablecity.club/console/token

3. 在模型广场挑选一个模型

   • 国际版链接：https://chatbot.unreachablecity.club/pricing
   • 国内版链接：https://chatbot.cn.unreachablecity.club/pricing

Step2: 进行OpenClaw配置时：

1. Q: I understand this is personal-by-default ..., continue?

   选Yes

2. Q: Model/auth provider

   往下按，选Custom Provider

3. Q: API Base URL

   国际版填：https://chatbot.unreachablecity.club/v1
   国内版填：https://chatbot.cn.unreachablecity.club/v1

4. Q: How do you want to provide this API key?

   选Paste API key now

5. Q: API Key

   填创建的创建API令牌密钥

6. Q: Endpoint compatibility

   选OpenAI-compatible

7. Q: Model ID

   复制模型广场挑选的模型名称

Step3: 等待Verification successful后

8. Q: Endpoint ID

   默认，直接回车

9. Q: Model alias(optional)

   默认，直接回车

其他配置的与常规配置无异

🌟 核心特性

多渠道集成

• 多渠道集成：支持 Telegram、Discord、WhatsApp、iMessage 等多种消息渠道，也可通过插件扩展更多平台
• 单一网关：通过一个 Gateway 进程统一管理所有渠道
• 语音支持：支持 macOS/iOS/Android 语音交互
• Canvas 界面：可渲染交互式 Canvas 界面

自托管与数据安全

• 完全自托管：运行在你自己的机器或服务器上
• 开源透明：MIT 开源协议，代码完全透明
• 数据本地化：上下文和技能存储在你的本地计算机，而非云端

智能代理能力

• 持续运行：支持后台常驻运行，拥有持久记忆
• 计划任务：支持 cron 定时任务
• 会话隔离：按代理/工作区/发送者隔离会话
• 多代理路由：支持多代理协同工作
• 工具调用：原生支持工具调用和代码执行

📦 接入前准备

准备信息

• Node.js 22 或更高版本
• 一个可用的 New API 地址（通常以 /v1 结尾）
  • 如果在Oasis AI API平台配置，形如：https://chatbot.unreachablecity.club/v1
• 一个可用的 New API API Key
  • 如果在Oasis AI API平台配置，是由API令牌生成

在开始接入 New API 之前，建议先按 OpenClaw 官方当前推荐流程把 Gateway 和 Control UI 跑起来。这样后续排查问题时，更容易区分是 OpenClaw 本身未启动，还是模型提供商配置有误。

1. 安装 OpenClaw（macOS/Linux）

curl -fsSL https://openclaw.ai/install.sh | bash

其他安装方式可参考 OpenClaw 官方文档：Getting Started。

2. 运行引导向导

openclaw onboard --install-daemon

该向导会完成基础认证、Gateway 设置，以及可选的渠道初始化。这里的目标是先把 OpenClaw 跑起来，后面再把默认模型切到 New API。

3. 检查 Gateway 与 Control UI

openclaw gateway status

openclaw dashboard

如果浏览器能打开 Control UI，说明 OpenClaw 基础运行已经正常。这个阶段不需要先配置 Telegram、Discord、飞书等消息渠道。

4. 定位配置文件

OpenClaw 的配置文件通常位于 ~/.openclaw/openclaw.json，你可以在引导向导生成的基础上继续修改。

export NEWAPI_API_KEY="sk-your-newapi-key"

{
  models: {
    mode: "merge",
    providers: {
      newapi: {
        baseUrl: "https://chatbot.unreachablecity.club/v1",
        apiKey: "${NEWAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "kimi-k2.5", name: "Kimi K2.5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "newapi/gemini-2.5-flash",
        fallbacks: ["newapi/kimi-k2.5"],
      },
      models: {
        "newapi/gemini-2.5-flash": { alias: "flash" },
        "newapi/kimi-k2.5": { alias: "kimi" },
      },
    },
  },
}

openclaw dashboard

openclaw models list