OpenClaw 中文文档
本页内容

本页内容

查看 Markdown以纯文本查看本页在 ChatGPT 中打开针对本页提问在 Claude 中打开针对本页提问

CLI 命令

JSON 输出形状

这些是注册表读取命令发出的机器可读形状，以及它们描述的保存的服务器配置形状。

JSON 输出形状

脚本和仪表盘请使用 --json。字段集可能会随着时间增长，因此消费者应忽略未知键。

读取命令将无效配置、未知服务器和禁用命名检查报告为 { "ok": false, "error": { "type": "cli_error", "message": "..." } }，并带有非零退出。一旦 doctor 或 probe 生成报告，错误将保留在该报告中，而不是生成第二个 JSON 文档。

状态 --json
json
{  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "configured": true,      "enabled": true,      "ok": true,      "transport": "streamable-http",      "launch": "streamable-http https://mcp.example.com/mcp",      "auth": "oauth",      "authStatus": {        "hasTokens": true,        "requiresAuthorization": false,        "hasClientInformation": true,        "hasCodeVerifier": false,        "hasDiscoveryState": true,        "hasLastAuthorizationUrl": false,        "state": "authorized"      },      "requestTimeoutMs": 20000,      "connectionTimeoutMs": 5000,      "toolFilter": {        "include": ["search", "read_*"],        "exclude": []      },      "supportsParallelToolCalls": true    }  ]}
医生--json
json
{  "ok": true,  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "ok": true,      "issues": [        {          "level": "warning",          "message": "OAuth credentials are not authorized; run openclaw mcp login docs"        }      ]    }  ]}

当任何已启用的检查服务器出现 error-level 问题时，doctor --json 退出非零。报告 warning 和 info 问题，但不会使命令本身失败。

探头--json
json
{  "generatedAt": "2026-05-31T09:00:00.000Z",  "servers": {    "docs": {      "launch": "streamable-http https://mcp.example.com/mcp",      "tools": 2,      "codexApprovalMode": "auto",      "approvalHint": "tools have no safety annotations; calls require approval in prompting session postures",      "resources": true,      "listChanged": {        "tools": true,        "resources": false,        "prompts": false      }    }  },  "tools": ["docs__read_page", "docs__search"],  "diagnostics": []}

probe --json 打开实时 MCP 客户端会话并直接打印其结果；与 status/doctor 不同，输出没有顶级 path 字段。每台服务器均包含其有效的codexApprovalMode；当该模式为 auto 并且发现的工具没有安全注释时，会出现 approvalHint。提示描述的是提示姿势下的批准要求，而不是默认的完全权限姿势。仅当服务器实际通告该功能时，resources 和 prompts 密钥才会出现（没有提示的服务器会忽略 prompts 密钥，而不是报告 false）。当诊断存在或选定的启用服务器未连接时，该命令会在退出非零之前打印完整的结果，因此自动化可以检查部分成功。使用 probe 进行可达性和功能证明，而不是用于静态配置审核。

示例配置形状：

json
{  "mcp": {    "servers": {      "context7": {        "command": "uvx",        "args": ["context7-mcp"]      },      "docs": {        "url": "https://mcp.example.com",        "transport": "streamable-http",        "requestTimeoutMs": 20000,        "connectionTimeoutMs": 5000,        "supportsParallelToolCalls": true,        "auth": "oauth",        "oauth": {          "scope": "docs.read"        },        "sslVerify": true,        "clientCert": "/path/to/client.crt",        "clientKey": "/path/to/client.key",        "toolFilter": {          "include": ["search_*"],          "exclude": ["admin_*"]        },        "codex": {          "defaultToolsApprovalMode": "approve"        }      }    }  }}
本页有帮助吗？