跳转到主要内容
云端部署时,配置文件、运行用户和网络环境都在服务器上。建议先让 OpenClaw 通过 APIONE 完成一轮对话,再连接钉钉等外部渠道。

部署准备

  1. 在阿里云控制台选择当前可用的 OpenClaw 镜像,或按 OpenClaw 官方说明安装。实例规格、价格与镜像版本以控制台为准。
  2. 登录服务器,确认运行 OpenClaw 的实际用户和 Home 目录。
  3. 备份该用户的 ~/.openclaw/openclaw.json,保留网关和渠道配置。
  4. 为服务器单独创建 APIONE API Key,并确认出站 HTTPS 可以访问 api.apione.ai。

配置模型

按 OpenClaw 接入教程合并 models.providers.apione,将默认模型设为 apione/YOUR_APIONE_MODEL_ID。镜像可能以 admin、其他用户或容器运行;应修改服务实际读取的配置,不能只改 SSH 用户的文件。
在本地 TUI 或受保护的 Dashboard 中发送简单消息。确认 APIONE 用量记录后,再进入下一步。

接入钉钉等渠道

按当前渠道插件的说明配置应用 ID、Secret 和机器人信息。若使用钉钉 AI 卡片,需要在卡片平台创建模板,并按插件要求配置模板 ID 与卡片写入、流式更新权限。先测试单人对话,再测试群聊和流式消息。 API 模型密钥、钉钉应用密钥与网关登录凭据是三类不同凭据,应分别管理。不要为了验证模型而把管理端口直接开放到公网。

可选:搜索与浏览器

搜索服务需要自己的账户和凭据,费用不包含在 APIONE 模型调用中。浏览器自动化需要服务器安装浏览器及相应依赖;按镜像系统配置可执行路径和 headless 模式,再检查 openclaw browser status。中文乱码时补齐字体。无需为了模型接入关闭浏览器沙箱。

排错顺序

先验证服务器网络,再验证 APIONE 模型请求,随后验证 Gateway,最后检查渠道回调。这样可以区分密钥、服务用户、模型权限和消息平台的问题。
返回集成目录 · 模型选择 · 错误排查