OpenClaw 接入教程

适合什么场景

OpenClaw 适合想把 AI 接入自动化工作流的用户。它通常用于连接浏览器、工具、任务队列、消息渠道或后台代理，让 AI 不只是回答问题，还能参与执行任务。

自动化工具权限更大，新手建议先在测试环境跑通，再逐步接入真实工作流。

一、准备 JiaPi 参数

建议给 OpenClaw 单独创建一个 API Key。自动化任务可能长期运行，单独密钥更容易排查用量，也能在异常时快速停用。

二、下载和安装 OpenClaw

打开 OpenClaw 官方快速开始。

按官方文档完成安装和启动。由于 OpenClaw 的部署方式可能随版本变化，建议始终以官方快速开始为准。

启动后，确认你能打开 OpenClaw 的管理页面或控制台。

三、添加 JiaPi 模型服务

进入 OpenClaw 的模型、Provider、LLM 或 API 设置页，按下面方式填写：

1. 新建 Provider。
2. 类型选择 OpenAI Compatible、OpenAI 或 Custom。
3. 名称填写 JiaPi。
4. Base URL 填写 https://ai-api.jiapi.com/v1。
5. API Key 填写 JiaPi API Key。
6. 默认模型填写 gpt-5.4 或 JiaPi 当前可用模型。
7. 保存配置。

如果你的 OpenClaw 版本没有 OpenAI 兼容 Provider，请先查看官方文档是否提供自定义模型或网关配置。没有自定义入口时，不建议强行配置。

四、验证模型是否可用

先不要接复杂自动化。建议只做一次模型连通性测试：

请用一句中文回复：OpenClaw 已成功连接 JiaPi。

如果能正常回复，再继续配置工具权限和工作流。

五、配置第一个安全工作流

新手建议从只读任务开始，例如：

1. 总结一段文本。
2. 读取测试网页标题。
3. 生成一份待办清单。
4. 根据输入内容输出 JSON。

不要一开始就让 OpenClaw 执行这些动作：

1. 删除文件。
2. 修改生产数据库。
3. 执行服务器重启。
4. 读取 .env、私钥、密码文件。
5. 访问带有个人隐私或公司敏感数据的页面。

六、自动化权限建议

建议按下面顺序开放权限：

1. 先开放模型调用。
2. 再开放只读工具，例如读取网页标题或读取测试文件。
3. 确认行为可靠后，再开放写入类工具。
4. 生产环境动作必须保留人工确认。

可以把自动化理解成“给 AI 一套工具箱”。工具越多，能力越强，风险也越高。新手阶段先给小工具，确认它能按预期工作，再慢慢扩大范围。

七、常见问题

提示连接失败

检查：

1. Base URL 是否填写 https://ai-api.jiapi.com/v1。
2. API Key 是否完整复制。
3. OpenClaw 服务所在机器是否能访问 JiaPi。
4. 是否存在代理、防火墙或容器网络限制。

提示模型不存在

把模型名称改成 JiaPi 当前可用模型。不要直接使用其他服务商文档里的模型名。

模型能回复，但工作流不能执行

这通常不是模型配置问题，而是工具权限、工作流节点、浏览器连接或运行环境问题。建议先用最小工作流验证，再逐步增加节点。

是否可以接生产环境

可以，但不建议新手一开始就接。生产环境至少要做到：

1. 单独 API Key。
2. 最小权限。
3. 关键动作人工确认。
4. 日志记录。
5. 异常时可以快速停用。

参考入口

• OpenClaw 快速开始