OpenClaw无明文凭证解决方案

OpenClaw 核心挑战

Agent ID Guard 核心能力

一句话总结：OpenClaw 负责"怎么调"，Agent ID Guard 负责"谁能调、凭什么调、调了之后怎么追"。

核心组件与协作流程

OpenClaw Secret 协议

Alibaba-Cloud-IDaaS CLI 实现了 OpenClaw Secret Provider exec 规范，通过 stdin/stdout 完成凭证交换：

请求（stdin）：

{ 
  "protocolVersion": 1, 
  "provider": "idaas", 
  "ids": ["model_key", "oss_key"]
}

响应（stdout）：

{
  "protocolVersion": 1,
  "values": { "model_key": "sk-xxxxxxxxxxxx" },
  "errors": { "oss_key": { "message": "unauthorized" } }
}

CLI 内部工作流：读取 stdin 请求 → 基于 Profile 认证获取 AT_pam → 逐个调用 Credential API 获取凭证 → 组装标准响应输出到 stdout。

OpenClaw目前支持按照上述协议工作动态获取凭据的场景清单如下：

认证方式对比与选型指南

Alibaba-Cloud-IDaaS CLI 支持多种认证方式，适用于不同部署环境：

Agent 凭证隔离原理

多 Agent 场景下，每个 Agent 在 IDaaS 中注册为独立 Client，通过不同的 Profile 对应不同的 Client ID 和授权策略：

每个 Agent 只能获取其被授权的凭证，权限边界清晰，互不交叉。

PKCS#7 工作负载身份认证原理

在阿里云轻量服务器/无影部署场景下，CLI 使用 PKCS#7 实例身份实现零密钥认证：

核心优势：整个认证过程不需要任何 AK/SK 或 Client Secret，ECS 实例身份由阿里云平台签发，不可伪造。

IDaaS 配置

1. 登录IDaaS EIAM 控制台。

2. 定位目标 EIAM 实例，单击操作列下的访问控制台。

3. 在左侧导航栏，单击Agent ID 身份安全。

4. 在Agent ID 身份安全页面，单击注册Agent身份。

5. 单击 Agent 节点进入 Agent 配置流程。

6. 记录生成的 Agent ID（如 app_ngfs**********************）

7. 在 Agent 配置页面单击右上角添加节点，添加大模型。

8. 添加大模型节点服务，可以选择已有大模型 API Key 凭据或者添加一个新的凭据。

9. 创建凭据时填写凭据名称、API Key 标识（如 default_model，此为 OpenClaw 中引用的 ID）、 API Key 值。

详细配置步骤可参考Agent 身份安全配置指导。

RAM 及 ECS 配置

1. RAM 中创建权限策略，使用脚本编辑方式，写入如下内容。其中 <InstanceId> 替换为 IDaaS EIAM 实例 ID（在IDaaS EIAM 控制台页面查看），<ApplicationId> 替换为前面步骤中注册的 Agent ID。

   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "eiam:GenerateOauthToken",
         "Resource": [
           "acs:eiam:*:*:instance/<InstanceId>/application/<ApplicationId> "
         ]
       }
     ]
   }

2. RAM 中创建角色，信任主体类型选择 云服务，信任主体名称选择云服务器 ECS ，并关上述权限策略。

3. 在部署 OpenClaw 的 ECS 实例中授予 RAM 角色。

Alibaba-Cloud-IDaaS CLI 配置

1. 安装 CLI 工具。可以在Github下载windows、mac、linux对应平台版本的 CLI 工具。

   # 下载预编译二进制（以 Linux amd64 为例）
   wget https://github.com/aliyunidaas/alibaba-cloud-idaas/releases/download/v0.1.0-preview11/alibaba-cloud-idaas-linux-0.1.0-preview11-amd64.tgz
   tar -zxvf alibaba-cloud-idaas-linux-0.1.0-preview11-amd64.tgz
   chmod +x alibaba-cloud-idaas
   # 如果 openclaw 的用户不是当前用户，需要修改 alibaba-cloud-idaas 的所有者，本文以 root 用户为例
   chown root alibaba-cloud-idaas
   # 将二进制文件移动到 PATH 目录下
   mv alibaba-cloud-idaas /usr/local/bin/alibaba-cloud-idaas

2. 配置 CLI Profile。创建配置文件 ~/.cloud_idaas/idaas-cli.json，其中 profile 子对象的名称（即openclaw-agent）在 openclaw 集成中会用到。

   {
     "version": "1",
     "current_profile": "openclaw-agent",
     "profile": {
       "openclaw-agent": { 
         "agent": {
           "instance_id": "idaas_wrws**********************",
           "developer_api_endpoint": "eiam-developerapi.cn-hangzhou.aliyuncs.com",
           "access_token_provider": {
             "open_api": {
               "instance_id": "idaas_wrws**********************",  // 和上面的 instance_id 保持一致。
               "application_id": "app_ngf****",
               "audience": "urn:cloud:idaas:pam",
               "scope_values": [".all"],
               "type": "ecs_ram_role",
               "role_arn": "acs:ram::***:role/****"
             }
           }
         }
       }
     }
   }

   配置字段说明：

   字段	说明	获取方式
   instance_id	IDaaS 实例 ID	在IDaaS EIAM 控制台页面的IDaaS实例ID/描述列下查看。
   developer_api_endpoint	Developer API 地域端点	根据实例所在地域填写，如 eiam-developerapi.cn-hangzhou.aliyuncs.com。可从云身份服务 (IDaaS EIAM)-阿里云OpenAPI开发者门户中获取。
   application_id	Agent ID	Agent 身份安全对应的 Agent ID。
   role_arn	ECS 绑定的 RAM 角色的 ARN	阿里云 RAM 控制台中对应角色的详情页面获取。

3. 验证 CLI 连通性。

   # 测试 openclaw-secret 子命令
   echo '{ "protocolVersion": 1, "provider": "idaas", "ids": ["default_model"] }' \
     | /usr/local/bin/alibaba-cloud-idaas openclaw-secret -p openclaw-agent
   
   # 预期输出
   {
     "protocolVersion": 1,
     "values": {
       "default_model": "sk-aac*****************************"
     }
   }

OpenClaw 配置

1. 在 OpenClaw 配置文件（~/.openclaw/openclaw.json）中修改 model 中的 apiKey。如果是刚安装好的 OpenClaw，正常配置 OpenClaw 模型后，再进行配置文件修改。

   {
     ...
     "models": {
       "mode": "merge",
       "providers": {
         "qwen": {
           "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
           "apiKey": "sk_*****",    // 需要修改的字段，其余字段保持不变
           // 修改后的 apiKey
           "apiKey": {
             "source": "exec",
             "provider": "idaas",
             "id": "default_model" 
           },
           "api": "openai-completions",
           "models": [
             {
               "id": "qwen3.5-plus",
               "name": "qwen3.5-plus (Custom Provider)",
               "reasoning": false,
               "input": [
                 "text"
               ],
               "cost": {
                 "input": 0,
                 "output": 0,
                 "cacheRead": 0,
                 "cacheWrite": 0
               },
               "contextWindow": 16000,
               "maxTokens": 4096
             }
           ]
         }
       }
     }
   }

2. 在 OpenClaw 配置文件（~/.openclaw/openclaw.json）中添加 secrets 配置。

   {
     "secrets": {
       "providers": {
         "idaas": {
           "source": "exec",
           "command": "/usr/local/bin/alibaba-cloud-idaas",
           "args": ["openclaw-secret", "-p", "openclaw-agent"], // 最后一个参数为 CLI 工具中的 profile 子对象名称
           "passEnv": ["HOME"],
           "jsonOnly": true
         }
       }
     }
   }

3. （可选）如果存在多个 Agent （配置步骤参考IDaaS 配置），可以配置多 Agent 凭证隔离，本文以 PKCS7 认证为例。需在 Alibaba-Cloud-IDaaS CLI Profile 和 OpenClaw 配置文件中分别添加多个配置。

   1. 参考IDaaS 配置，注册多个 Agent 身份。

   2. Alibaba-Cloud-IDaaS CLI 配置（~/.cloud_idaas/idaas-cli.json）中新增 Profile：

      {
        "version": "1",
        "profile": {
          "researcher-agent": {
            "agent": {
              "instance_id": "idaas_wrws****",
              "developer_api_endpoint": "eiam-developerapi.cn-hangzhou.aliyuncs.com",
              "access_token_provider": {
                "client_credentials": {
                  "token_endpoint": "https://zi******.aliyunidaas.com/api/v2/iauths_system/oauth2/token",
                  "client_id": "app_res**********************",
                  "scope": "urn:cloud:idaas:pam|.all",
                  "application_federated_credential_name": "alibabacloudp7",
                  "client_assertion_pkcs7": {
                    "provider": "alibaba_cloud",
                    "alibaba_cloud_mode": "normal",
                    "alibaba_cloud_idaas_instance_id": "idaas_wrws****"
                  }
                }
              }
            }
          },
          "writer-agent": {
            "agent": {
              "instance_id": "idaas_wrws****",
              "developer_api_endpoint": "eiam-developerapi.cn-hangzhou.aliyuncs.com",
              "access_token_provider": {
                "client_credentials": {
                  "token_endpoint": "https://zi******.aliyunidaas.com/api/v2/iauths_system/oauth2/token",
                  "client_id": "app_wrt**********************",
                  "scope": "urn:cloud:idaas:pam|.all",
                  "application_federated_credential_name": "alibabacloudp7",
                  "client_assertion_pkcs7": {
                    "provider": "alibaba_cloud",
                    "alibaba_cloud_mode": "normal",
                    "alibaba_cloud_idaas_instance_id": "idaas_wrws****"
                  }
                }
              }
            }
          }
        }
      }

      配置字段说明：

      字段	说明	获取方式
      instance_id	IDaaS 实例 ID	在IDaaS EIAM 控制台页面的IDaaS实例ID/描述列下查看。
      developer_api_endpoint	Developer API 地域端点	根据实例所在地域填写，如 eiam-developerapi.cn-hangzhou.aliyuncs.com。可从云身份服务 (IDaaS EIAM)-阿里云OpenAPI开发者门户中获取。
      token_endpoint	Token 获取地址	Agent 身份安全对应的 Agent 中生成SDK配置后查看。
      client_id	Agent 认证使用的客户端 ID	Agent 身份安全对应的 Agent 中生成SDK配置后查看。
      application_id	Agent ID	Agent 身份安全对应的 Agent ID。
      alibaba_cloud_idaas_instance_id	IDaaS 实例 ID	同instance_id。

   3. OpenClaw 配置添加多个 Provider，args 中的最后一个参数注意替换成对应的 Alibaba-Cloud-IDaaS CLI Profile 中对应的子对象名称：

      {
        "secrets": {
          "providers": {
            "researcher": {
              "source": "exec",
              "command": "/usr/local/bin/alibaba-cloud-idaas",
              "args": ["openclaw-secret", "-p", "researcher-agent"],
              "passEnv": ["HOME"],
              "jsonOnly": true
            },
            "writer": {
              "source": "exec",
              "command": "/usr/local/bin/alibaba-cloud-idaas",
              "args": ["openclaw-secret", "-p", "writer-agent"],
              "passEnv": ["HOME"],
              "jsonOnly": true
            }
          }
        }
      }

4. 启动 OpenClaw 进行验证。

   # 重启 OpenClaw Gateway
   openclaw gateway restart
   
   # 正常对话验证模型是否可正常使用
   opeclaw tui