OpenClaw 使用指南

本文用于在 Windows（CMD/PowerShell）环境下，使用 OpenClaw（原名 ClawBot ）对接 模力方舟 gitee-ai/kimi-k2.5，完成安装、初始化、配置与验证。），其他操作系统思路类似。

1. 下载与前置要求

1.1 相关链接

• GitHub：https://github.com/openclaw/openclaw
• 官网/文档：https://openclaw.ai/

1.2 环境要求

• Node.js版本高于22

2. 安装与初始化（Terminal）

下面以 npm 全局安装为例。

2.1 安装 OpenClaw 与启动

npm install -g openclaw@latest

上述为最新下载指令（2026/1/29），总文件数应高于600，若出现文件过少的异常，可尝试旧版指令 npm install -g clawdbot@latest

安装完成后请使用 openclaw onboard --install-daemon（新）或 clawdbot onboard --install-daemon（旧）启动程序 若程序成功启动将会出现如下图所示的图样：

2.2 初始配置

程序启动后，请根据弹出的的对话按照需求自行选择，初始可选择 QuickStart 来加快部署进度：

后续若不确定请选择默认值，选择模型时，可先行选择默认模型，见文档后续加入自己所需要的模型（此文档中将使用kimi-k2.5）

可先行跳过不必要的安装步骤，如选择 Select channel 和 Install missing skill dependencies 时，可以选择跳过（Skip for now），这些可在成功生成对话框后在仪表盘左侧菜单栏中进行添加, 如下图所示：

按流程直到结束即可，若未自动弹出仪表盘，请手动打开仪表盘（本地网关）： http://127.0.0.1:18789/或http://localhost:18789/。

初始配置结束后，应出现类似下图所示的报告（此时agent model中应是您之前选择的模型）：

PS：若出现Gateway service install failed或自动打开的仪表盘显示不可用，手动运行运行仪表盘即可，请根据下载时候的版本选择新旧指令：'openclaw gateway'或'clawdbot gateway'，然后进入上述网址。

2.3 json文件修改

完成基础配置后，可自行修改json文件，加入需要的模型，在如图所示的位置后，填入模力方舟 API 信息:

ps: 这三段文件可能会根据您之前的选择略有不同

参考代码如下：

{
  "models": {
    "mode": "merge",
    "providers": {
      "gitee-ai": {
        "baseUrl": "https://ai.gitee.com/v1",
        "apiKey": "您的模力方舟访问令牌",
        "api": "openai-completions",
        "models": [
          {
            "id": "Kimi-K2.5",
            "name": "Kimi-K2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

此处完成后，在 default 中，将 model，primary 后的模型改成 Kimi-K2.5：

{
  "model": {
    "primary": "gitee-ai/Kimi-K2.5"
  }
}

并在后续model中，按照和前面一样的格式加入Kimi-2.5

完成后，点击保存，即可完成部署。

然后再您之前启动服务的终端窗口中终止之前的进程（若您在进行的话），终止指令：Ctrl C。之后重新运行 'openclaw gateway' 或 'clawdbot gateway' 即可，您应当看到

agent model: gitee-ai/Kimi-K2.5

然后重新刷新或进入网关即可，此时输入内容，机器人应当会给予回应。