OpenClaw 接入 8848API 完整指南

第 1 步：安装 OpenClaw

macOS / Linux / WSL2

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

Windows PowerShell

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

官方安装器会检查运行环境、安装 OpenClaw，并通常直接进入初始化。如果安装完成后没有自动进入，手动运行下面的命令。

openclaw onboard

第 2 步：进入初始化并选择本机模式

1. 阅读安全提示并确认继续。OpenClaw 能调用工具、读写文件和运行自动化任务，应只授予确实需要的权限。
2. 初始化方式选择 QuickStart；只有需要自定义端口、监听地址和认证方式时才选 Advanced。
3. 运行模式选择 Local / 本机 Gateway。Remote 只适合连接另一台已经部署好的 OpenClaw Gateway。

第 3 步：添加 8848API 模型提供商

1. 进入 Model / Auth 设置时，选择 Custom Provider，不要选择官方 OpenAI 登录或其他内置厂商。
2. Base URL 填 https://api.884819.xyz/v1。
3. API Key 存储方式：新手可选 Paste API key now，粘贴 8848API 的 sk- 密钥；熟悉 SecretRef 的用户可改用环境变量或密钥提供器。
4. Endpoint compatibility 选择 OpenAI-compatible（/chat/completions）。
5. Model ID 填写 8848API 当前可用模型的完整名称，大小写、横线和版本号都必须一致。
6. OpenClaw 会立即发起一次真实验证请求。验证成功才继续；失败时按提示重新检查 Base URL、Key 和模型名。
7. Endpoint ID 可保留自动生成值，也可填写容易识别的名称，例如 api8848。
8. Model alias 为可选项；不需要别名可直接留空。
9. 如果询问模型是否支持图片输入：文本模型选 No；明确支持看图的多模态模型才选 Yes。

第 4 步：完成工作区与 Gateway 设置

1. Workspace：首次使用可保留默认目录 ~/.openclaw/workspace。这里会保存助手身份、用户资料、技能说明和工作文件。
2. Gateway：QuickStart 保留默认端口 18789、本机监听和 Token 认证即可。
3. Channels：Telegram、WhatsApp、Discord 等消息通道可先跳过，确认模型能对话后再添加。
4. Daemon / 后台服务：个人电脑或服务器长期使用时建议安装，使 Gateway 能在后台运行并随系统启动。
5. Health check：不要跳过。初始化会启动 Gateway 并检查能否连接。
6. Skills：按需安装；它不是 8848API 模型接入的必选项，之后仍可补装。

第 5 步：验证是否接入成功

初始化结束后，依次执行：

openclaw status
openclaw models status
openclaw dashboard

1. openclaw status：确认 Gateway 正常运行。
2. openclaw models status：确认默认模型显示为“Endpoint ID / 模型 ID”，并且没有缺少认证。
3. openclaw dashboard：打开浏览器控制台，发送一句“你好，请只回复：连接成功”。
4. 能正常回复，并且 8848API 控制台出现对应调用记录，即说明完整接入成功。

也可以直接运行 openclaw 进入终端界面测试。

第 6 步：需要时再添加消息通道

openclaw channels add

按向导添加 Telegram、WhatsApp、Discord 等通道。通道配置与模型配置是两件事：建议先确认网页或终端对话正常，再接机器人，排错更简单。

已经安装过 OpenClaw 怎么改成 8848API？

1. 运行 openclaw configure，进入模型 / Provider 相关设置，添加 Custom Provider。
2. 如果当前配置比较乱，也可以重新运行 openclaw onboard；正常重跑不会自动清空现有数据。
3. 不要使用 --reset，除非你明确要删除配置、凭据或会话后重新开始。
4. 修改后再次执行 openclaw models status 和 openclaw dashboard 验证。

常见错误排查

验证返回 401 / Invalid API key

• 确认填写的是“令牌管理”创建的 sk- 密钥，不是登录密码。
• 检查复制时有没有多余空格、换行或遗漏字符。
• 确认令牌未被禁用、未过期且额度正常。

返回 404、HTML 页面或提示接口地址错误

• Base URL 应填 https://api.884819.xyz/v1，必须包含 /v1。
• 兼容模式应选择 OpenAI-compatible（/chat/completions）。

模型不存在 / no model

• 从 8848API 模型列表复制完整模型 ID，不要凭显示名称猜写。
• 模型名发生变化时，重新运行 openclaw configure 修改。

模型验证成功，但网页打不开

• 先执行 openclaw status 检查 Gateway。
• 如果初始化时跳过了后台服务，先在当前终端运行 Gateway，或重新配置 Daemon。
• 本机默认访问不要把 Gateway 端口直接暴露到公网。