Openclaw的部署以及免费API集成教程

一、系统要求（Prerequisites）

操作系统：macOS、Linux（推荐 Ubuntu/Debian）、Windows（强烈建议用 WSL2，因为原生 Windows 支持有限）。

Node.js：版本 ≥22（下载：Node.js — Run JavaScript Everywhere ）。用 node -v 检查。

包管理器：npm

硬件：至少 4GB RAM，建议 Mac mini 或 VPS 24/7 运行。

二.配置 Discord Bot

去 Discord for Developers 创建 app → Bot → 开 Intents（Message Content、Server Members、Presence）。

复制 Token，填入第三步的对应配置中。

邀请 Bot 进服务器（OAuth2 URL Generator）。

获取Discord的channels ID并填入第三步中的channels access中

3.安装方式（Installation Methods）

OpenClaw 支持三种主要安装路径：脚本安装器（最快）、全局 CLI 安装、从源代码建。在这里展示使用脚本安装器来安装，这是官方最简单方式，自动检测 OS、安装 Node.js（如果缺），并跑 onboarding wizard。

Bash

运行后，它会：

安装 OpenClaw CLI

问你基本配置（workspace、channels 等）

自动安装 daemon（后台服务），让它 24/7 跑。

如果报错（如权限）：用 sudo 或检查 curl 是否安装。

4.Onboarding Wizard（初始配置，超级重要）

安装后，会自动执行初始化设置，一步一步设置即可。

它会确认模型提供商和模型名称，由于未提供OpenAI-compatible APIs的配置选项，因此需要先跳过后完成整个流程再去配置文件中设置Provider等信息

channels：选 Discord或 Telegram/WhatsApp 等，教程中采用的discord。第一步先设置Discord

Bot的权限，如果对应的Discord Bot设置好了直接填入对应信息即可，如果没有可以参照第5步配置好Discord Bot。

完成后，需要配置bot的一些技能，可以后续再按照需求进行添加

完成后按 ctrl+c 结束当前的openclaw进程，然后进入配置文件中设置我们的url和key

5.配置第三方 API（以Canopy Wave为例）

我这里用的是Canopy Wave的免费API,在Canopy Wave的官网获取API Key和调用URLCanopy Wave - The World’s Best Inference Platform For Open Models

编辑 ~/.openclaw/openclaw.json 或 .env： 添加以下内容至openclaw.json文件中

保存后：可以使用openclaw doctor来检测配置是否成功。

配置完成后使用openclaw onboard来重新加载，在配置文件中添加canopywave后，跳过Provider设置就可以在模型中看到canopywave的模型

6.启动 & 测试

启动 Gateway

openclaw gateway start

检查Gateway状态：openclaw gateway status

交互 TUI：openclaw tui

健康检查：openclaw doctor --fix

7.更新 & 维护

更新：openclaw update --channel stable。

日志：openclaw logs --follow。

卸载：npm uninstall -g openclaw + rm -rf ~/.openclaw。

8.安全提示 & 常见问题安全：

限制 allowedUsers，只给自己用。别给 AI root 权限。用 VPS（如 Hostinger）隔离。

问题：

Node 版本低：升级 Node。

API 不通：检查 key/URLWindows

问题：用 WSL2。

Daemon 不跑：检查 systemd/launchd 状态（systemctl --user status openclaw）。

如果在Windows 的 WSL2 环境下运行，但 systemd 没有启用，会导致 user-level daemon（gateway 服务）无法作为 systemd 服务启动/管理，只需启用systemd功能即可解决。