适用范围
本页适用于客户端 1.14.2.498、内置 OpenClaw 2026.6.8。当前版本没有面向普通用户的自定义 MCP 图形入口,因此通过内置 CLI 配置。应用内工具是否加载成功,需要配置后继续确认。
当前版本未发现普通用户可用的自定义 MCP 图形入口。本页因此只提供高级兼容步骤, 不展示无法确认是否属于默认内容的客户端主页元素。
1. 先确认版本
升级后路径和运行时配置方式可能变化。版本不一致时先停止,不要直接复制旧配置。
$AutoClawRoot = Join-Path $env:ProgramFiles "AutoClaw"
$Node = Join-Path $AutoClawRoot "resources\node\node.exe"
$OpenClaw = Join-Path $AutoClawRoot "resources\gateway\openclaw\openclaw.mjs"
(Get-Item (Join-Path $AutoClawRoot "AutoClaw.exe")).VersionInfo.ProductVersion
& $Node $OpenClaw --version本文实测输出为 1.14.2.498 和 OpenClaw 2026.6.8。

2. 隐藏输入测试凭据
在 PowerShell 中读取 APP_SECRET,不把它发送到 AutoClaw 对话、截图、Git 或共享目录。
$AutoClawRoot = Join-Path $env:ProgramFiles "AutoClaw"
$Node = Join-Path $AutoClawRoot "resources\node\node.exe"
$OpenClaw = Join-Path $AutoClawRoot "resources\gateway\openclaw\openclaw.mjs"
$StateDir = Join-Path $env:USERPROFILE ".openclaw-autoclaw"
$SourceConfig = Join-Path $StateDir "openclaw.json"
$AppId = Read-Host "请输入点签测试 APP_ID"
$SecretValue = Read-Host "请输入点签测试 APP_SECRET" -AsSecureString
$SecretPointer = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecretValue)
try {
$AppSecret = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($SecretPointer)
} finally {
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($SecretPointer)
}静态 Header 会保存在本机 AutoClaw 配置中。请只在自己可控的 Windows 账号中使用测试凭据。
3. 添加服务,再运行探测
$HadOpenClawConfigPath = Test-Path Env:OPENCLAW_CONFIG_PATH
$PreviousOpenClawConfigPath = $env:OPENCLAW_CONFIG_PATH
$env:OPENCLAW_CONFIG_PATH = $SourceConfig
try {
& $Node $OpenClaw mcp add dianqian-contract `
--url "https://mcp.fs-url.com/mcp" `
--transport "streamable-http" `
--header ("X-Dianqian-App-Id=" + $AppId) `
--header ("X-Dianqian-App-Secret=" + $AppSecret) `
--header "X-Dianqian-Environment=sandbox"
& $Node $OpenClaw mcp tools dianqian-contract `
--include "dianqian_find_signers,dianqian_create_contract,dianqian_list_contracts,dianqian_get_contract,dianqian_revoke_contract"
& $Node $OpenClaw mcp doctor dianqian-contract --probe
} finally {
Clear-Variable AppSecret, AppId, SecretValue -ErrorAction SilentlyContinue
if ($HadOpenClawConfigPath) {
$env:OPENCLAW_CONFIG_PATH = $PreviousOpenClawConfigPath
} else {
Remove-Item Env:OPENCLAW_CONFIG_PATH -ErrorAction SilentlyContinue
}
Clear-Variable PreviousOpenClawConfigPath, HadOpenClawConfigPath -ErrorAction SilentlyContinue
}如果提示同名服务已存在,先执行 mcp list查看,不要反复添加。配置后清空当前 PowerShell 会话中的敏感变量。
这表示凭据未通过认证。请重新核对 APP_ID、APP_SECRET 和测试环境权限,再运行探测。
4. 自行检查连接
换成有效测试凭据后,重新执行 mcp doctor --probe。成功判据是命令成功退出,并且探测结果没有 401、403 或超时。 这只能证明 CLI 能访问远程 MCP。
CLI 探测通过后,还需要在 AutoClaw 应用内确认五个工具是否出现,并先做一次只读查询。 探测成功后可以完全退出 AutoClaw(包括托盘进程)再重开;如果应用内仍看不到工具, 说明应用和 Gateway 可能没有读取同一份配置。 这条兼容路径面向技术人员,不建议普通用户照着命令行操作。
