knownAs

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install knownas
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 knownas。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

knownAs 将 OpenClaw 网关连接到 knownas.dev 上的命名身份，并为其提供公开身份记录，以及稳定的 HTTPS API 和频道 webhook 地址。该服务会将流量转发至网关当前的公开源站，因此即使隧道重启，也无需更改公开地址。
此 Openclaw Skills 条目将引导所有者创建并验证身份、重新指向路由、检查状态，并可选择更新 webhook URL。它强调征得同意和妥善处理密钥：由用户提供 API 密钥并批准公开变更，而此技能会避免泄露凭据或发布所有者未选择分享的信息。

应用场景

为 OpenClaw 网关提供易记的公开身份和 HTTPS 端点。
在隧道重启或源站变更后，保持 API 和 webhook URL 不变。
发布经所有者批准的身份记录，其中包含显示名称、描述、联系方式和主页。
在激活路由前，验证公开源站是否能够提供 knownAs 证明令牌。
查看身份状态、路由健康状况、近期检查记录，以及与服务限额相关的流量。
列出已启用 webhook 的频道，并在获得所有者批准后，将其 URL 更新为稳定的 webhook 地址。

工作原理

使用 whoami 检查 API 密钥的作用域和账户配额，确定网关的公开源站，确认源站可访问且符合要求，并检查是否已安装 knownas 插件。
请所有者批准创建身份，并指定要发布哪些可选的公开记录详情。
创建身份，并等待其 DNS 生效。
为所选服务创建路由，通常为 api 和 webhooks；只有在所有者于同一源站后运行 MCP 服务器时，才可使用 mcp。
通过插件配置或所有者管理的纯文本文件，在 /.well-known/knownas-origin 提供每条路由的证明令牌。
请 knownas.dev 检查每条路由。检查成功后，即可验证路由，并将其源站密钥存入 OpenClaw 的密钥存储区。
分享稳定的身份、API 和 webhook 地址。今后若源站变更，请创建新的路由证明并进行验证，无需更改这些公开地址。

配置指南

系统中需提供 curl 和 jq。
由用户提供具有所需身份、清单和路由作用域的 KNOWNAS_API_KEY。
OpenClaw 网关需有可访问的公开主机名。不接受环回、私有或 IP 地址源站。
knownas 插件，或由所有者管理、以纯文本形式提供证明令牌的端点。
配置和使用
此辅助程序会读取 KNOWNAS_API_KEY，并可选读取 KNOWNAS_API_URL（默认值：https://platform.knownas.dev）。请通过捆绑的辅助程序调用 API 操作，而不要使用 curl 直接调用 API：
sh {baseDir}/scripts/knownas.sh whoami
sh {baseDir}/scripts/knownas.sh create SLUG NAME [MANIFEST.json] [SERVICE...]
sh {baseDir}/scripts/knownas.sh wait-active ID
sh {baseDir}/scripts/knownas.sh route ID SERVICE ORIGIN
sh {baseDir}/scripts/knownas.sh check ID SERVICE
创建身份、更改路由或编辑频道 webhook URL 前，请先征求同意。API 密钥必须由所有者提供；切勿索要其密码，也不要打印密钥或源站密钥。安装插件后，请通过 OpenClaw 的严格 JSON 设置配置收集到的证明令牌，不要在聊天中泄露密钥：
openclaw config set plugins.entries.knownas.config.originTokens '["",""]' --strict-json
网关提供证明后，请检查每条路由。验证成功后，源站密钥会存入 OpenClaw 的密钥存储区。其余命令请遵循此技能的设置流程；不要代替所有者创建账户或删除身份。

数据架构

身份和路由
数据 用途
身份 slug 和 ID 为网关的 knownAs 身份命名并标识该身份。免费套餐允许每个网关拥有一个身份。
公开清单 所有者可选的显示名称、描述、联系邮箱和主页。请勿包含机器、网络或聊天详情。
服务 api 用于网关端点，webhooks 用于频道 webhook；同一源站后存在 MCP 服务器时，也可选择 mcp。
路由源站 服务所指向的公开主机名；拒绝私有、环回和 IP 地址源站。
证明令牌 在 /.well-known/knownas-origin 提供的临时验证值，每行一个令牌。
源站密钥 验证成功后，辅助程序会将其以 KNOWNAS_ORIGIN_SECRET_ 的名称存入 OpenClaw 的密钥存储区；切勿打印。
状态和流量 身份状态、路由状态及最近一次检查记录，以及与报告配额限额相比较的流量。
稳定的公开 URL 根据身份 slug 生成：身份记录为 https://.knownas.dev/.well-known/agent-identity.json，API 为 https://.api.knownas.dev，webhook 为 https://.hooks.knownas.dev/
。Webhook 路径会原样转发。辅助程序命令会返回 JSON；此技能不涉及本地数据库或生成的项目文件。

高级特性

重新指向源站：
隧道重启后替换路由源站并验证新的证明令牌，同时保留相同的公开 URL。
路由验证：
平台会获取证明端点；检查结果会指出令牌缺失、超时、重定向和地址被禁止等常见故障。
安全处理密钥：
辅助程序不会将 API 密钥放在命令行中，并会在验证后将源站密钥存入 OpenClaw 的密钥存储区。
多个服务路由：
管理 API 和 webhook 路由；MCP 服务器可用时，也可选择配置 MCP 路由。
运行状态：
查看身份和路由状态、最近一次检查记录，以及与带宽限额相比的流量。
基于同意的频道更新：
列出 webhook 频道并逐一提供 URL 更改选项，保留各频道现有路径，并要求所有者批准。
明确的操作边界：
此技能不会创建账户、处理密码、删除身份、覆盖 API 403 响应或更改
gateway.trustedProxies
；必要时会引导所有者查阅相应的人类支持渠道或 OpenClaw 文档。

name: knownas description: "Give this OpenClaw a stable public name on knownas.dev: HTTPS, a public record of who runs it, and webhook and API addresses that survive tunnel restarts." homepage: https://knownas.dev