ouyang/clawdbot
1
0
Fork 0
mirror of https://github.com/clawdbot/clawdbot.git synced 2026-01-31 19:37:45 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: clarify plugin agent tool config

Browse Source
This commit is contained in:
Peter Steinberger
2026-01-18 04:27:50 +00:00
parent efdb33c975
commit 331b8157b0
2 changed files with 14 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
CHANGELOG.md
View File

@@ -21,6 +21,7 @@ Docs: https://docs.clawd.bot
- CLI: surface FTS + embedding cache state in `clawdbot memory status`. - CLI: surface FTS + embedding cache state in `clawdbot memory status`.
- Plugins: allow optional agent tools with explicit allowlists and add plugin tool authoring guide. https://docs.clawd.bot/plugins/agent-tools - Plugins: allow optional agent tools with explicit allowlists and add plugin tool authoring guide. https://docs.clawd.bot/plugins/agent-tools
- Tools: centralize plugin tool policy helpers. - Tools: centralize plugin tool policy helpers.
- Docs: clarify plugin agent tool configuration. https://docs.clawd.bot/plugins/agent-tools
### Fixes ### Fixes
- Voice call: include request query in Twilio webhook verification when publicUrl is set. (#864) - Voice call: include request query in Twilio webhook verification when publicUrl is set. (#864)

16
docs/plugins/agent-tools.md
View File

@@ -6,8 +6,13 @@ read_when:
--- ---
# Plugin agent tools # Plugin agent tools
Clawdbot plugins can register agent tools (JSON‑schema functions) that appear in the Clawdbot plugins can register **agent tools** (JSON‑schema functions) that are exposed
agent tool list. Tools can be **required** (always available) or **optional** (opt‑in). to the LLM during agent runs. Tools can be **required** (always available) or
**optional** (opt‑in).
Agent tools are configured under `tools` in the main config, or per‑agent under
`agents.list[].tools`. The allowlist/denylist policy controls which tools the agent
can call.
## Basic tool ## Basic tool
@@ -55,7 +60,7 @@ export default function (api) {
} }
``` ```
Enable optional tools in `agents.list[].tools.allow`: Enable optional tools in `agents.list[].tools.allow` (or global `tools.allow`):
```json5 ```json5
{ {
@@ -76,6 +81,11 @@ Enable optional tools in `agents.list[].tools.allow`:
} }
``` ```
Other config knobs that affect tool availability:
- `tools.profile` / `agents.list[].tools.profile` (base allowlist)
- `tools.byProvider` / `agents.list[].tools.byProvider` (provider‑specific allow/deny)
- `tools.sandbox.tools.*` (sandbox tool policy when sandboxed)
## Rules + tips ## Rules + tips
- Tool names must **not** clash with core tool names; conflicting tools are skipped. - Tool names must **not** clash with core tool names; conflicting tools are skipped.