mirror of
https://github.com/farcasclaudiu/openclaw.git
synced 2026-06-28 23:02:02 +03:00
Docs: update zh-CN translations and pipeline
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
This commit is contained in:
@@ -1,30 +1,30 @@
|
||||
---
|
||||
read_when:
|
||||
- 不运行完整智能体轮次而直接调用工具
|
||||
- 构建需要工具策略执行的自动化流程
|
||||
summary: 通过 Gateway网关 HTTP 端点直接调用单个工具
|
||||
- 不运行完整智能体回合直接调用工具
|
||||
- 构建需要工具策略强制执行的自动化
|
||||
summary: 通过 Gateway 网关 HTTP 端点直接调用单个工具
|
||||
title: 工具调用 API
|
||||
x-i18n:
|
||||
generated_at: "2026-02-01T20:38:59Z"
|
||||
generated_at: "2026-02-03T07:48:58Z"
|
||||
model: claude-opus-4-5
|
||||
provider: pi
|
||||
source_hash: 17ccfbe0b0d9bb61cc46fb21f5c09b106ba6e8e4c2c14135a11ca8d5b77b8a88
|
||||
source_path: gateway/tools-invoke-http-api.md
|
||||
workflow: 14
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# 工具调用(HTTP)
|
||||
|
||||
OpenClaw 的 Gateway网关暴露了一个简单的 HTTP 端点,用于直接调用单个工具。该端点始终启用,但受 Gateway网关认证和工具策略控制。
|
||||
OpenClaw 的 Gateway 网关暴露了一个简单的 HTTP 端点用于直接调用单个工具。它始终启用,但受 Gateway 网关认证和工具策略限制。
|
||||
|
||||
- `POST /tools/invoke`
|
||||
- 与 Gateway网关相同的端口(WS + HTTP 多路复用):`http://<gateway-host>:<port>/tools/invoke`
|
||||
- 与 Gateway 网关相同的端口(WS + HTTP 多路复用):`http://<gateway-host>:<port>/tools/invoke`
|
||||
|
||||
默认最大请求体大小为 2 MB。
|
||||
默认最大负载大小为 2 MB。
|
||||
|
||||
## 认证
|
||||
|
||||
使用 Gateway网关认证配置。发送 Bearer 令牌:
|
||||
使用 Gateway 网关认证配置。发送 bearer 令牌:
|
||||
|
||||
- `Authorization: Bearer <token>`
|
||||
|
||||
@@ -47,15 +47,15 @@ OpenClaw 的 Gateway网关暴露了一个简单的 HTTP 端点,用于直接调
|
||||
|
||||
字段:
|
||||
|
||||
- `tool`(字符串,必填):要调用的工具名称。
|
||||
- `action`(字符串,可选):如果工具 schema 支持 `action` 且 args 中未包含该字段,则映射到 args 中。
|
||||
- `args`(对象,可选):工具特定的参数。
|
||||
- `sessionKey`(字符串,可选):目标会话键。如果省略或为 `"main"`,Gateway网关将使用配置的主会话键(遵循 `session.mainKey` 和默认智能体,或在全局作用域中使用 `global`)。
|
||||
- `dryRun`(布尔值,可选):保留供将来使用;当前会被忽略。
|
||||
- `tool`(string,必需):要调用的工具名称。
|
||||
- `action`(string,可选):如果工具 schema 支持 `action` 且 args 负载省略了它,则映射到 args。
|
||||
- `args`(object,可选):工具特定的参数。
|
||||
- `sessionKey`(string,可选):目标会话键。如果省略或为 `"main"`,Gateway 网关使用配置的主会话键(遵循 `session.mainKey` 和默认智能体,或在全局范围中使用 `global`)。
|
||||
- `dryRun`(boolean,可选):保留供将来使用;当前忽略。
|
||||
|
||||
## 策略 + 路由行为
|
||||
|
||||
工具可用性通过与 Gateway网关智能体相同的策略链进行过滤:
|
||||
工具可用性通过 Gateway 网关智能体使用的相同策略链过滤:
|
||||
|
||||
- `tools.profile` / `tools.byProvider.profile`
|
||||
- `tools.allow` / `tools.byProvider.allow`
|
||||
@@ -63,9 +63,9 @@ OpenClaw 的 Gateway网关暴露了一个简单的 HTTP 端点,用于直接调
|
||||
- 群组策略(如果会话键映射到群组或渠道)
|
||||
- 子智能体策略(使用子智能体会话键调用时)
|
||||
|
||||
如果工具未被策略允许,端点将返回 **404**。
|
||||
如果工具不被策略允许,端点返回 **404**。
|
||||
|
||||
为帮助群组策略解析上下文,你可以选择性地设置:
|
||||
为帮助群组策略解析上下文,你可以选择设置:
|
||||
|
||||
- `x-openclaw-message-channel: <channel>`(示例:`slack`、`telegram`)
|
||||
- `x-openclaw-account-id: <accountId>`(当存在多个账户时)
|
||||
|
||||
Reference in New Issue
Block a user