文档中心

ArkClaw 企业版

请输入

ClawInstance

UpdateClawInstanceChannel - 更新ArkClaw实例消息渠道

更新ArkClaw实例的消息渠道。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：UpdateClawInstanceChannel

要执行的操作，取值：UpdateClawInstanceChannel。

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

ImClientId string 必选示例值：cli_a924872c19389***

IM渠道凭证ID，请根据IM渠道类型来确定凭证ID。

飞书：飞书应用的App ID。

钉钉：钉钉应用的Client ID。

企业微信：企业微信的BotID。

ImClientSecret string 必选示例值：JKHro45ot50-m0veg*****

IM渠道凭证密钥，请根据IM渠道类型来确定凭证密钥。

飞书：飞书应用的AppSecret。

钉钉：钉钉应用的ClientSecret。

企业微信：企业微信应用的Secret。

ImType string 必选示例值：Feishu

IM渠道类型。支持：

Feishu：飞书应用。

Dingtalk：钉钉应用。

Wecom：企业微信应用。

InstanceId string 必选示例值：ci-yemjf738cgwr****

ArkClaw实例ID。查询实例ID的方式请参见ListClawInstances。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=UpdateClawInstanceChannel&Version=2026-05-01 HTTP/1.1​
Host: https://arkclaw.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260605T104035Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260605/cn-beijing/arkclaw/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "ImClientId": "cli_a924872c19389***",​
  "ImClientSecret": "JKHro45ot50-m0veg*****",​
  "ImType": "Feishu",​
  "InstanceId": "ci-yemjf738cgwr****"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "20260605184043213226096****",​
    "Action": "UpdateClawInstanceChannel",​
    "Version": "2026-05-01",​
    "Service": "arkclaw",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidImType.Malformed	The specified ImType is malformed.	参数ImType不合法。
400	MissingParameter.ImClientId	The required parameter ImClientId is not supplied.	参数ImClientId不能为空。
400	MissingParameter.ImClientSecret	The required parameter ImClientSecret is not supplied.	参数ImClientSecret不能为空。
400	MissingParameter.ImType	The required parameter ImType is not supplied.	参数ImType不能为空。
400	MissingParameter.InstanceId	The required parameter InstanceId is not supplied.	参数InstanceId不能为空。
404	InvalidInstance.NotFound	The specified Instance does not exist.	指定ArkClaw实例不存在。
412	OperationDenied.InstanceNotRunning	The operation is denied because the instance is not in running status.	指定的操作被拒绝，因为实例未处于运行中状态。
429	FlowLimitExceeded	The request was rejected due to flow control.	请求触发限流。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.06.05 21:31:13

这个页面对您有帮助吗？

有用

无用