mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-30 15:01:44 +00:00
Docs: normalize zh-CN terminology + tone
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
This commit is contained in:
@@ -1,9 +1,9 @@
|
||||
---
|
||||
read_when:
|
||||
- 添加或修改技能配置时
|
||||
- 添加或修改 Skills配置时
|
||||
- 调整内置允许列表或安装行为时
|
||||
summary: 技能配置结构与示例
|
||||
title: 技能配置
|
||||
summary: Skills配置结构与示例
|
||||
title: Skills配置
|
||||
x-i18n:
|
||||
generated_at: "2026-02-01T21:42:49Z"
|
||||
model: claude-opus-4-5
|
||||
@@ -13,9 +13,9 @@ x-i18n:
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# 技能配置
|
||||
# Skills配置
|
||||
|
||||
所有技能相关配置位于 `~/.openclaw/openclaw.json` 的 `skills` 下。
|
||||
所有 Skills 相关配置位于 `~/.openclaw/openclaw.json` 的 `skills` 下。
|
||||
|
||||
```json5
|
||||
{
|
||||
@@ -28,7 +28,7 @@ x-i18n:
|
||||
},
|
||||
install: {
|
||||
preferBrew: true,
|
||||
nodeManager: "npm", // npm | pnpm | yarn | bun(Gateway 运行时仍为 Node;不推荐 bun)
|
||||
nodeManager: "npm", // npm | pnpm | yarn | bun(Gateway网关运行时仍为 Node;不推荐 bun)
|
||||
},
|
||||
entries: {
|
||||
"nano-banana-pro": {
|
||||
@@ -47,32 +47,32 @@ x-i18n:
|
||||
|
||||
## 字段
|
||||
|
||||
- `allowBundled`:可选的**内置**技能允许列表。设置后,只有列表中的内置技能可用(托管/工作区技能不受影响)。
|
||||
- `load.extraDirs`:要扫描的额外技能目录(优先级最低)。
|
||||
- `load.watch`:监视技能文件夹并刷新技能快照(默认:true)。
|
||||
- `load.watchDebounceMs`:技能监视器事件的防抖时间(毫秒,默认:250)。
|
||||
- `allowBundled`:可选的**内置**Skills 允许列表。设置后,只有列表中的内置 Skills 可用(托管/工作区 Skills 不受影响)。
|
||||
- `load.extraDirs`:要扫描的额外 Skills 目录(优先级最低)。
|
||||
- `load.watch`:监视 Skills 文件夹并刷新 Skills 快照(默认:true)。
|
||||
- `load.watchDebounceMs`:Skills 监视器事件的防抖时间(毫秒,默认:250)。
|
||||
- `install.preferBrew`:可用时优先使用 brew 安装器(默认:true)。
|
||||
- `install.nodeManager`:Node 安装器偏好(`npm` | `pnpm` | `yarn` | `bun`,默认:npm)。此选项仅影响**技能安装**;Gateway 运行时应仍使用 Node(不推荐在 WhatsApp/Telegram 中使用 Bun)。
|
||||
- `entries.<skillKey>`:按技能的覆盖配置。
|
||||
- `install.nodeManager`:Node 安装器偏好(`npm` | `pnpm` | `yarn` | `bun`,默认:npm)。此选项仅影响**Skills 安装**;Gateway网关运行时应仍使用 Node(不推荐在 WhatsApp/Telegram 中使用 Bun)。
|
||||
- `entries.<skillKey>`:按 Skills 的覆盖配置。
|
||||
|
||||
按技能字段:
|
||||
按 Skills 字段:
|
||||
|
||||
- `enabled`:设为 `false` 可禁用技能,即使它是内置/已安装的。
|
||||
- `enabled`:设为 `false` 可禁用 Skills,即使它是内置/已安装的。
|
||||
- `env`:为智能体运行注入的环境变量(仅在尚未设置时生效)。
|
||||
- `apiKey`:可选的便捷字段,用于声明了主要环境变量的技能。
|
||||
- `apiKey`:可选的便捷字段,用于声明了主要环境变量的 Skills。
|
||||
|
||||
## 说明
|
||||
|
||||
- `entries` 下的键默认映射到技能名称。如果技能定义了 `metadata.openclaw.skillKey`,请使用该键。
|
||||
- 启用监视器时,技能的更改会在下一个智能体回合时生效。
|
||||
- `entries` 下的键默认映射到 Skills 名称。如果 Skills 定义了 `metadata.openclaw.skillKey`,请使用该键。
|
||||
- 启用监视器时,Skills 的更改会在下一个智能体回合时生效。
|
||||
|
||||
### 沙箱化技能与环境变量
|
||||
### 沙箱隔离 Skills 与环境变量
|
||||
|
||||
当会话处于**沙箱**模式时,技能进程在 Docker 内运行。沙箱**不会**继承主机的 `process.env`。
|
||||
当会话处于**沙箱**模式时,Skills 进程在 Docker 内运行。沙箱**不会**继承主机的 `process.env`。
|
||||
|
||||
请使用以下方式之一:
|
||||
|
||||
- `agents.defaults.sandbox.docker.env`(或按智能体 `agents.list[].sandbox.docker.env`)
|
||||
- 将环境变量烘焙到您的自定义沙箱镜像中
|
||||
- 将环境变量烘焙到你的自定义沙箱镜像中
|
||||
|
||||
全局 `env` 和 `skills.entries.<skill>.env/apiKey` 仅适用于**主机**运行。
|
||||
|
||||
Reference in New Issue
Block a user