需完成密钥获取、配置加载、代理中转、安全验证及模型路由五步:一、在开发者平台创建绑定域名/IP的API密钥并存入环境变量;二、通过后端代理透传请求,流式处理SSE响应;三、前端引入SDK初始化聊天组件;四、配置Webhook并用Secret Token验签;五、设置模型路由规则实现动态调度。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望将ClawBot的API接入第三方系统,需完成密钥获取、配置加载、代理中转、安全验证等关键环节。以下是实现此集成的具体步骤:
一、在ClawBot开发者平台创建并配置API密钥
ClawBot要求所有外部请求必须携带有效的API密钥进行身份认证,该密钥需绑定可信域名或IP白名单,未正确配置将触发401 Unauthorized错误。
1、访问ClawBot官方开发者控制台,使用管理员账号登录。
2、进入「API管理」→「新建密钥」页面,填写应用名称(如“ERP对接系统”)及授权范围。
3、在「绑定域名」字段中输入第三方系统的主域名(例如:erp.company.com),若为内网系统则填写对应出口IP段。
4、点击确认后,系统生成唯一API Key字符串,该密钥仅显示一次,请立即复制并安全存储。
5、将密钥值写入第三方系统环境变量CLAWBOT_API_KEY,或存入加密配置中心供服务调用。
二、通过后端代理服务透传请求并处理流式响应
为避免前端直接暴露密钥、规避CORS限制,并统一日志与熔断策略,必须通过自有后端代理ClawBot API请求。
1、在第三方系统后端新增路由:/api/clawbot/v1/chat,支持POST方法。
2、该路由接收客户端原始JSON payload(含message、session_id等字段),不修改结构直接转发。
3、构造对ClawBot官方接口https://api.clawbot.ai/v1/chat的下游请求,在headers中添加Authorization: Bearer 您的API Key。
4、设置下游响应头Content-Type为text/event-stream,并启用流式读取,逐块转发SSE数据至客户端。
5、对返回的HTTP状态码做分级处理:2xx直接透传,400/401返回标准化错误体,5xx触发本地降级逻辑。
三、加载前端SDK并初始化嵌入式聊天组件
前端需通过官方SDK快速注入轻量级聊天窗口,该方式不侵入现有DOM结构,适配PC与移动端自适应布局。
1、在第三方系统HTML页面的


















