Xikapi 接入文档

OpenClaw 安装指南 ​

OpenClaw 通常由 CLI、Gateway 和控制台界面组成。CLI 负责管理配置、模型、Skills 和 Channels；Gateway 负责运行后台服务和通讯入口。

安装前准备 ​

安装前请确认：

  • 已准备一枚 Xikapi API Key
  • 已安装 Node.js，推荐 Node 24，至少 Node 22.14+
  • Windows 用户优先使用 WSL2，原生 Windows 也可安装
  • 终端可以访问 GitHub、npm 和 OpenClaw 安装脚本

检查 Node.js：

bash
node --version

快速安装 ​

macOS / Linux / WSL2：

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

Windows PowerShell：

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

如果你只想先安装 CLI，暂不进入初始化向导：

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

Windows PowerShell：

powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

使用 npm 安装 ​

如果你已经自行管理 Node.js，也可以使用 npm 全局安装。这个方式适合已经熟悉 Node.js 环境、希望自己控制 CLI 安装位置的用户。

第一步，安装 OpenClaw CLI（推荐）：

bash
npm install -g openclaw@latest

第二步，检查 CLI 是否可用：

bash
openclaw --version
openclaw doctor

第三步，确认 CLI 正常后，再进入初始化向导并安装后台服务：

bash
openclaw onboard --install-daemon

也就是说，npm install -g openclaw@latest 只是安装 CLI；openclaw onboard --install-daemon 是后续初始化 OpenClaw 和安装 daemon 的步骤，不是同一个安装动作。

初始化 OpenClaw ​

运行初始化向导：

bash
openclaw onboard --install-daemon

向导会引导你配置模型供应商、API Key 和 Gateway。完成后检查 Gateway：

bash
openclaw gateway status

正常情况下，Gateway 会监听本机端口。然后打开控制台：

bash
openclaw dashboard

常见问题 ​

openclaw 命令不存在 ​

先检查全局 npm 路径：

bash
npm prefix -g
echo "$PATH"

如果全局 bin 目录不在 PATH 中，需要把它加入 shell 配置文件。

Gateway 没有启动 ​

检查状态：

bash
openclaw gateway status
openclaw doctor

必要时重启：

bash
openclaw gateway restart

安全建议 ​

  • 不要把 Xikapi API Key 写进前端代码或公开仓库
  • 不要随意安装来源不明的 OpenClaw 插件或 Skill
  • 生产环境建议单独创建低权限令牌
  • 高成本模型应绑定独立令牌分组
  • 定期运行 openclaw doctor 检查配置

参考链接 ​