人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载导读macOS 应用本身不解析 Skills而是通过 OpenClaw Gateway 网关统一展示与管理 Skills。本文围绕 docs/zh-CN/platforms/mac/skills.md 展开先讲清楚skills.status、skills.install、skills.update三个网关方法如何驱动 macOS 设置 UI再结合仓库源码Gateway 服务端、macOS Swift 客户端与内置 Skills 示例深入说明资格判定、首选安装器选择、密钥存储位置与远程模式语义。读完后你将能完全理解 macOS 设置页里每个开关、按钮和缺失提示背后的完整调用链并掌握直接编写openclaw.json精确控制 Skills 的实战方法。架构总览macOS 应用为何不解析 SkillsmacOS 应用OpenClaw.app通过 Gateway 网关展示 OpenClaw Skills它不会在本地解析 Skills。这意味着所有 Skill 发现、资格评估、安装与配置更新都发生在 Gateway 一侧应用侧只负责“展示 触发”它通过 WebSocket 向网关发起 RPC 请求再把响应渲染成设置界面。网关侧负责“计算 执行”加载 Skills、评估资格、运行安装器、写回配置文件。这条边界在 GatewayConnection.swift 中体现得非常直接Swift 端把skills.status、skills.install、skills.update注册为GatewayConnection.Method枚举成员见该文件enum Method一节并提供了对应的skillsStatus()、skillsInstall(name:installId:timeoutMs:)、skillsUpdate(skillKey:enabled:apiKey:env:)类型化方法而 skills.ts 则实现了这三个方法的服务端处理逻辑。从网关的权限模型看skills.status属于operator.read只读作用域skills.install与skills.update属于operator.admin管理作用域具体映射见 method-scopes.ts。也就是说任何人都能查看 Skills 状态但只有管理员权限的客户端才能触发安装或修改配置。数据来源skills.status返回什么skills.statusGateway 网关返回所有 Skills 以及资格eligibility和缺失的要求missing requirements包括内置 Skills 的允许列表阻止情况。它要求的字段定义在src/agents/skills-status.ts的SkillStatusReport与SkillStatusEntry类型中name/descriptionSkills 名称与描述source来源标记openclaw-bundled、openclaw-managed、openclaw-workspace、openclaw-extra等bundled是否为内置 SkillsfilePath/baseDirSKILL.md文件路径与其所在目录skillKey配置键默认等于 Skills 名称若定义了metadata.openclaw.skillKey则用后者primaryEnv/emoji/homepage主环境变量名、UI 表情符号、官网链接always/disabled/blockedByAllowlist/eligible四个布尔状态位requirements/missing全部要求与缺失项各自分为bins、env、config三组见src/shared/requirements.ts的Requirements类型configChecks每个requires.config路径的逐项检查结果{ path, satisfied }不会回传敏感值install可供 UI 展示的安装选项列表{ id, kind, label, bins }。资格是如何算出来的资格要求来源于每个SKILL.md中的metadata.openclaw.requires但最终是否“有资格eligible”由buildSkillStatusskills-status.ts综合判定eligible !disabled !blockedByAllowlist requirementsSatisfied其中requirementsSatisfied由evaluateEntryRequirementsForCurrentPlatformentry-status.ts计算规则如下对应 requirements.tsrequires.bins全部二进制都必须在PATH中缺失时返回缺失列表requires.anyBins至少一个二进制存在即可requires.env环境变量已存在或在skills.entries.key.env/apiKey中提供requires.configopenclaw.json中对应路径必须为真值browser.enabled等路径有默认真值见 config.ts 的DEFAULT_CONFIG_VALUESmetadata.openclaw.os平台必须匹配当前process.platformdarwin/linux/win32。另外还有两个特殊入口always: true的 Skills 跳过所有资格门控直接视为有资格若skills.allowBundled白名单被配置不在白名单中的内置Skills 会被blockedByAllowlist: true标记托管/工作区 Skills 不受影响详见isBundledSkillAllowedconfig.ts。一个关键安全设计只读客户端拿不到敏感值server.skills-status.test.ts 专门验证了这一点即使channels.discord.token已写入配置skills.status返回的configChecks中satisfied仍为true但响应里绝不包含原始值——测试断言JSON.stringify(res.payload)不含该密钥。这是 macOS 设置 UI 能够安全展示“配置是否满足”而无需暴露敏感数据的基础。macOS 设置 UI 的实际渲染SwiftUI 设置页 SkillsSettings.swift 完整消费了上述数据模型Swift 侧对应结构体定义在 SkillsModels.swift列表按name排序顶部提供All / Ready / Needs Setup / Disabled四个过滤器SkillsFilter每行展示emoji、名称、描述、来源标签Bundled / Managed / Workspace / Extra / Plugin以及homepage链接“Website”未满足时显示缺失摘要“Missing binaries: …”“Missing env: …”“Requires config: …”并对configChecks逐项渲染 ✓/✗有缺失环境变量时行内出现 “Set API Key”对应primaryEnv或 “Set ENV” 按钮点击后弹出SecureField安全输入框EnvEditorView有可用安装选项且存在缺失二进制时展示安装按钮详见下文安装操作否则显示启停开关。整个页面的刷新链路是SkillsSettingsModel.refresh()→GatewayConnection.shared.skillsStatus()→ 网关skills.status处理器 →buildWorkspaceSkillStatus(workspaceDir, …)。每次增删改操作完成后模型都会再次refresh()保证 UI 与网关侧状态一致。安装操作metadata.openclaw.install与skills.install安装器规格定义metadata.openclaw.install定义安装选项支持brew / node / go / uv / download五种类型对应 types.ts 的SkillInstallSpec。仓库内置 Skills 提供了大量真实范例例如 skills/gemini/SKILL.md--- name: gemini description: Gemini CLI for one-shot QA, summaries, and generation. homepage: https://ai.google.dev/ metadata: { openclaw: { emoji: ✨, requires: { bins: [gemini] }, install: [ { id: brew, kind: brew, formula: gemini-cli, bins: [gemini], label: Install Gemini CLI (brew), }, ], }, } ---各安装器类型的必要字段与行为依据buildInstallCommand见 skills-install.tskind必填字段实际执行的命令brewformulabrew install formula找不到 brew 时返回“brew not installed”提示nodepackage依skills.install.nodeManager选择npm install -g --ignore-scripts/pnpm add -g --ignore-scripts/yarn global add --ignore-scripts/bun add -g --ignore-scriptsgomodulego install module缺 go 时先尝试 brew/apt 自动安装uvpackageuv tool install package缺 uv 时尝试 brew 安装downloadurl必填、archivetar.gz/tar.bz2/zip、extract默认按扩展名自动识别、stripComponents、targetDir默认~/.openclaw/tools/skillKey由 skills-install-download.ts 单独处理下载与解压所有安装器字段都经过严格校验brew formula、npm 包名、go module、uv 包名各有安全正则防选项注入见 frontmatter.ts 的normalizeSafe*系列函数。安装器规格还可以带os: [darwin|linux|win32]按平台过滤选项normalizeInstallOptions中会先剔除当前平台不适用的条目。首选安装器选择一次只展示一个当提供多个安装器时Gateway 网关仅展示一个首选安装器。源码中selectPreferredInstallSpecskills-status.ts实现了一个表驱动优先级链配置了install.preferBrew且 brew 可用 → 选 brewuv安装器node安装器brew 可用时 → brewgo安装器download安装器优先于不可用的 brew兜底brew 规格用于展示“缺 brew”的描述性错误而非“无安装器”最后一个兜底第一个安装器。即文档所述“如果可用则使用 brew否则使用来自skills.install的 node 管理器默认 npm”。唯一的例外如果所有安装器都是download类型网关会列出每个条目便于用户查看可用构件。注UI 上对“仅缺失部分二进制”的 SkillsSkillRow.installOptions会过滤出bins与缺失集合有交集的安装选项见 SkillsSettings.swift保证用户只看到能补全缺口的那一个。应用如何调用安装macOS 应用调用skills.install在 Gateway 网关主机上运行安装器。Swift 端skillsInstall(name:installId:timeoutMs:)把{ name, installId, timeoutMs }发给网关网关处理器skills.ts调用installSkillskills-install.ts执行安装。值得注意的实现细节超时被钳制在1000ms ~ 900000ms之间默认 300000ms即 5 分钟Swift UI 传的正是timeoutMs: 300_000安装前会先对 Skill 目录执行代码安全扫描scanDirectoryWithSummary发现 critical/warn 模式会在结果中附加warnings非内置来源如 workspace 里的第三方 Skill触发安装时会追加“Verify the install recipe is trusted”警告体现“第三方 Skills 视为不受信任代码”的安全立场download类型强制要求目标路径落在该 Skill 专属的 tools 根目录内Refusing to install outside the skill tools directory见 skills-install-download.tsUI 中 “Install on Gateway” 与 “Install on This Mac” 两个按钮远程模式时并排显示都调用同一个网关方法选 “This Mac” 时若当前不是 Local 模式Swift 端会先把connectionMode切到.local见 SkillsSettings.swift。环境变量与 API 密钥skills.entries与skills.update密钥存储在配置文件的什么位置macOS 应用将密钥存储在~/.openclaw/openclaw.json的skills.entries.skillKey下。例如为nano-banana-pro配置 Gemini 密钥{ skills: { entries: { nano-banana-pro: { enabled: true, apiKey: GEMINI_KEY_HERE, env: { GEMINI_API_KEY: GEMINI_KEY_HERE, }, }, peekaboo: { enabled: true }, sag: { enabled: false }, }, }, }要点entries下的键默认映射到Skills 名称若 Skills 定义了metadata.openclaw.skillKey则使用该键见resolveSkillKeyfrontmatter.ts名称含连字符时用引号包裹键名JSON5 允许带引号键名apiKey是primaryEnv的便捷字段env中同名变量仅在进程中尚未设置时注入env-overrides.ts 的hasExternallyManagedValue判断enabled: false直接禁用该 Skills即使它是内置/已安装的config是可选的自定义单 Skills 字段容器自定义键必须放在这里。skills.update的工作方式skills.update更新enabled、apiKey和env。网关实现skills.ts是原地补丁式更新先浅拷贝cfg.skills与entries再按需设置enabled、apiKey、env空字符串表示删除对应环境变量最后writeConfigFile(nextConfig)整体写回。细节apiKey会经过normalizeSecretInput规范化——测试 skills.update.normalizes-api-key.test.ts 验证了嵌入的 CR/LF 会被剥除abc\r\ndef→abcdef防止密钥注入Swift 端skillsUpdate支持enabled、apiKey、env三个可选参数setEnabled/updateEnv分别对应 UI 上的开关与“Set API Key / Set ENV”输入框SkillsSettings.swiftskills.entries.*.env与apiKey会在该智能体轮次开始时注入到宿主机进程中而非沙箱运行结束后恢复原始环境applySkillEnvOverrides返回一个createEnvReverter见 env-overrides.ts危险环境变量名如OPENSSL_CONF会被拦截避免影响宿主运行行为。沙箱隔离时的注意点若会话处于沙箱隔离Docker状态宿主机注入的env/apiKey不会进入容器。需要改用agents.defaults.sandbox.docker.env或单智能体agents.list[].sandbox.docker.env或将变量烘焙进自定义沙箱镜像requires.bins的二进制也必须在容器内存在可通过setupCommand安装。详见 docs/zh-CN/tools/skills-config.md 的“沙箱隔离的 Skills 环境变量”一节。远程模式安装与配置都发生在网关主机文档的核心结论之一安装 配置更新发生在 Gateway 网关主机上不是本地 Mac。在远程模式下macOS 应用只是一个“瘦客户端”它通过网关的 WebSocket 接口发起skills.install与skills.update真正执行brew install/npm install -g/go install/uv tool install与写回~/.openclaw/openclaw.json的进程是网关主机上的 Node 进程。Swift 端 GatewayConnection.swift 还内置了连接恢复逻辑本地模式请求失败时会自动拉起网关进程重试[150, 400, 900]ms退避远程模式失败时会尝试重建 tailnet 隧道保证操作可用性。一个相关的延伸能力当网关运行在Linux上但连接了允许system.run的macOS 节点时OpenClaw 会把仅限 macOS 的 Skills 视为有资格前提是所需二进制存在于该节点上。网关通过system.which/system.run探测节点二进制skills-remote.ts 的refreshRemoteNodeBins并在skills.status的资格评估中计入remote.hasBin见evaluateRequirementsFromMetadataWithRemoterequirements.ts此时智能体应通过nodes工具通常是nodes.run在这些节点上执行 Skills。如果 macOS 节点随后离线Skills 仍然可见但调用可能失败直到节点重新连接。深入Skills 从哪来、何时刷新、占多少 Token为了让你在 macOS 设置页外也能完整驾驭 Skills这里补充几个与“网关如何感知 Skills”直接相关的机制加载位置与优先级网关从多个位置加载 Skills 并按名称合并后写入者覆盖先写入者workspace.tsworkspace workspace/skills最高 → .agents 项目级 / 个人级 → managed ~/.openclaw/skills → bundled 内置 → extraDirs最低会话快照与热重载OpenClaw 在会话开始时对有资格的 Skills 做快照SkillSnapshot同一会话后续轮次复用对 Skills 或配置的更改在下一个新会话生效。默认情况下网关会监视 Skills 文件夹skills.load.watch: trueSKILL.md变化后经watchDebounceMs默认 250ms防抖并提升快照版本号refresh.ts刷新后的列表在下一个智能体轮次被获取——即“热重载”。新的有资格远程节点出现时也会触发刷新。Token 开销是可计算的当 Skills 有资格时网关把紧凑 XML 列表注入系统提示词formatSkillsForPrompt成本是确定性的total 195 Σ (97 len(name_escaped) len(description_escaped) len(location_escaped))即 ≥1 个 Skills 时基础开销 195 字符每个 Skills 额外 97 字符 三个字段的 XML 转义长度 会展开为实体。按 OpenAI 风格约 4 字符/token 粗估每个 Skills ≈ 24 token。另在 workspace.ts 中系统提示词里的 Skills 文件路径会用~压缩家目录前缀每个路径可省约 5–6 token。配置参考速查表完整的 Skills 配置 schema 见 docs/zh-CN/tools/skills-config.md与 macOS UI 相关的核心字段汇总如下配置路径作用默认值skills.allowBundled内置 Skills 白名单未列出者被阻止未设置 全部允许skills.load.extraDirs附加 Skills 目录最低优先级无skills.load.watch监视 Skills 文件夹并刷新快照trueskills.load.watchDebounceMs监视事件防抖毫秒数250skills.install.preferBrew可用时优先 brew 安装器trueskills.install.nodeManagernode 安装器偏好npm/pnpm/yarn/bunnpmskills.entries.skillKey.enabled禁用/启用单个 Skills未设置 启用skills.entries.skillKey.apiKey主环境变量便捷字段无skills.entries.skillKey.env注入的环境变量仅当未设置时无小结macOS 上的 OpenClaw Skills 设置页是“网关计算、应用展示”架构的典型样例skills.status负责把资格、缺失要求与安装选项安全地呈现给 UIskills.install在网关主机上执行受校验的安装器brew 优先、node 兜底、download 特殊列出skills.update以补丁方式维护~/.openclaw/openclaw.json中的skills.entries.skillKey。理解这条链路后无论是排查“Skill 为什么显示 Needs Setup”还是为某个内置 Skill 配置密钥你都能精准定位到对应的配置键与网关方法而不必依赖 UI 黑盒。赞分享人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载相关推荐OpenClaw macOS 客户端 Skills 设置全解析网关代理的技能状态、安装动作与密钥管理OpenClaw macOS 客户端 Skills 设置全解析网关代理的技能状态、安装动作与密钥管理 本文基于仓库文档 docs/platforms/mac/人工智能大模型LLM 网关AI Agent即时通讯openclaw-cn macOS 技能管理完全指南Gateway 驱动的 Skills 设置界面、资格判定与安装流程openclaw cn macOS 技能管理完全指南Gateway 驱动的 Skills 设置界面、资格判定与安装流程 macOS 桌面端如何展示、安装和配置人工智能AI Agent即时通讯后端本地部署语音OpenClaw 自托管多通道 AI 网关从安装接入到 Gateway 启动与安全锁定的全解OpenClaw 自托管多通道 AI 网关从安装接入到 Gateway 启动与安全锁定的全解 OpenClaw 是一个运行在任意操作系统上的 自托管多通道网关人工智能大模型LLM 网关AI Agent即时通讯上一篇宝塔面板v7.7.0经典服务器管理工具的深度解析下一篇AI as Workspace 完整使用指南从零开始构建智能工作环境创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考