> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 阿里云部署 OpenClaw 并接入 APIONE

> 先验证服务器上的模型连接，再接入网关与消息渠道。

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

## 部署准备

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

## 配置模型

按 [OpenClaw 接入教程](https://apione.ai/docs/guides/openclaw.md)合并 `models.providers.apione`，将默认模型设为 `apione/YOUR_APIONE_MODEL_ID`。镜像可能以 `admin`、其他用户或容器运行；应修改服务实际读取的配置，不能只改 SSH 用户的文件。

```bash theme={null}
openclaw models list
openclaw gateway restart
openclaw gateway status
```

在本地 TUI 或受保护的 Dashboard 中发送简单消息。确认 APIONE 用量记录后，再进入下一步。

## 接入钉钉等渠道

按当前渠道插件的说明配置应用 ID、Secret 和机器人信息。若使用钉钉 AI 卡片，需要在卡片平台创建模板，并按插件要求配置模板 ID 与卡片写入、流式更新权限。先测试单人对话，再测试群聊和流式消息。

API 模型密钥、钉钉应用密钥与网关登录凭据是三类不同凭据，应分别管理。不要为了验证模型而把管理端口直接开放到公网。

## 可选：搜索与浏览器

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

## 排错顺序

先验证服务器网络，再验证 APIONE 模型请求，随后验证 Gateway，最后检查渠道回调。这样可以区分密钥、服务用户、模型权限和消息平台的问题。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.