workbuddy ai需通过http集成能力调用外部服务，具体路径包括：一、配置api权限与凭证；二、创建http连接器并映射参数；三、在ai工作流中嵌入api调用节点；四、使用claw cli直连api；五、通过openclaw skill扩展api能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望WorkBuddy AI在执行任务过程中主动调用外部服务（如地图、支付、通知或数据库API），需通过其内置的HTTP集成能力完成配置。以下是实现该目标的具体操作路径：
一、确认API调用权限与凭证就绪
WorkBuddy必须拥有合法身份才能发起对外请求，这依赖于系统是否启用HTTP网关模块及凭证管理功能。私有化部署实例默认启用白名单机制，未授权域名将被拦截；公有云版本则需确保账户具备“高级集成”权限等级。
1、登录WorkBuddy客户端，点击左下角头像进入【系统设置】→【集成中心】→【API凭证管理】。
2、点击【新增凭证】，选择目标认证类型：RESTful（适用于简单Key校验）、OAuth 2.0（适用于需授权码流程的服务）、API Key（适用于多数SaaS平台）。
3、填写服务商提供的凭据字段，例如Client ID、Client Secret、API Key或Bearer Token。
4、若第三方平台要求签名验证，勾选【启用签名验证】并上传WorkBuddy生成的公钥证书（.pem格式）。
二、创建HTTP连接器并定义参数映射
连接器是将原始API封装为可复用动作单元的关键组件，它抽象了URL、请求头、参数结构和响应解析逻辑，使AI工作流无需硬编码即可调用。
1、在【集成中心】中点击【新建连接器】，选择【手动配置HTTP API】。
2、输入连接器名称（如“飞书消息推送”），填写完整端点URL：https://open.feishu.cn/open-apis/bot/v2/hook/{webhook_token}。
3、在【请求头】区域添加Content-Type: application/json，并在Webhook Token位置使用变量语法：{credentials.feishu_bot_token}。
4、在【请求体】中选择JSON格式，填入模板：{"msg_type":"text","content":{"text":"{input.message}"}}，其中{input.message}为运行时注入的用户输入变量。
5、在【响应映射】中配置成功判定条件：状态码=200且$.status_code == 0；错误码提取路径设为$.status_msg。
三、在AI工作流中嵌入API调用节点
WorkBuddy支持将已注册的连接器作为独立节点拖入流程画布，通过自然语言指令触发，并自动绑定上下文参数，实现零代码编排。
1、进入【AI工作流设计台】，新建空白流程，命名为“客户咨询自动通知飞书”。
2、从左侧组件栏拖入【HTTP API调用】节点，下拉选择已配置的“飞书消息推送”连接器。
3、点击节点右侧【参数绑定】图标，在message字段中输入表达式：{task.input.customer_name}在{task.input.time}提交了新咨询，内容为：{task.input.content}。
4、保存流程后，在对话框中输入：“把张三15:30提交的‘订单状态查询’咨询发到飞书运维群”，AI将自动解析字段并执行推送。
四、使用Claw CLI命令行方式直连API（备用方案）
当图形界面无法满足动态路由或复杂鉴权需求时，可通过Claw运行时直接发起HTTP请求，该方式绕过凭证管理模块，适用于临时调试或高阶定制场景。
1、打开WorkBuddy主界面，点击左下角头像进入【系统设置】→【Claw 设置】→【终端模式】，启用CLI访问权限。
2、在聊天窗口输入指令：claw exec curl -X POST https://api.example.com/v1/data -H "Authorization: Bearer {env.API_TOKEN}" -d '{"query":"status"}'。
3、系统将自动替换{env.API_TOKEN}为环境变量中预设的值，并执行请求，响应结果以纯文本形式返回至对话区。
4、如需持久化该命令，可在【技能市场】中搜索“http-cli-wrapper”，安装后即可将其封装为自然语言可调用的技能。
五、通过OpenClaw Skill扩展原生API能力
OpenClaw社区提供大量预置的API封装技能（如wechat-notify、dingtalk-alert），这些Skill已内置鉴权、重试、限流等工业级逻辑，可直接安装启用，避免重复开发。
1、点击左侧导航栏【技能市场】，顶部搜索框输入dingtalk-alert。
2、查看技能详情页中的【依赖项】，确认是否已安装curl、jq等基础工具；若显示“未满足”，点击【一键安装依赖】。
3、点击【安装】按钮，等待状态变为【已启用】。
4、在任意对话中输入：用钉钉机器人通知王经理，当前服务器CPU使用率已达92%，Skill将自动构造请求并发送。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
