#13584: tools: add description to message tool channel parameter
agents
stale
Cluster:
Message Tool Enhancements
## Summary
Resubmitting [#10364](https://github.com/openclaw/openclaw/pull/10364) — previous PR was auto-closed when the fork was deleted and recreated.
The `channel` parameter in `buildRoutingSchema()` is defined as a bare `Type.Optional(Type.String())` with no description. This causes AI agents to pass channel/conversation IDs instead of provider names, resulting in "Unknown channel" errors.
Adds a description: `"Messaging provider name (e.g. 'slack', 'discord'). Not the channel/conversation ID."`
One-line change. Closes #10354
✍️ Author: Claude Code with @carrotRakko (AI-written, human-approved)
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
Adds documentation to the `channel` parameter in the message tool schema to clarify it expects a provider name (like `slack`, `discord`) rather than a channel/conversation ID. This prevents AI agents from passing incorrect values that result in "Unknown channel" errors.
- Improves the `buildRoutingSchema()` function by adding an explicit description
- The description clearly differentiates between `channel` (provider name) and `target` (channel/conversation ID)
- Documentation-only change with no logic modifications
<h3>Confidence Score: 5/5</h3>
- This PR is safe to merge with no risk
- This is a documentation-only change that adds a clarifying description to a parameter. No logic is modified, no new code paths are introduced, and the change addresses a real usability issue where AI agents were confused about what value to pass. The examples provided ('slack', 'discord') are valid provider names from the codebase.
- No files require special attention
<!-- greptile_other_comments_section -->
<!-- /greptile_comment -->
Most Similar PRs
#18847: docs(#18153): document suppressToolErrors configuration option
by cedillarack · 2026-02-17
76.1%
#15864: feat: add deliverOnlyToolMessages config for clean messaging channe...
by gandalf-the-engineer · 2026-02-14
75.9%
#5036: docs: improve Slack setup and troubleshooting guide
by DanBatten · 2026-01-31
74.9%
#15626: Slack: add channel create for message tool
by imWildCat · 2026-02-13
74.5%
#7145: chore: update package description to reflect multi-channel capabili...
by Protocol-zero-0 · 2026-02-02
74.3%
#12818: docs(messages): clarify message tool ordering vs inline replies
by JBrady · 2026-02-09
74.3%
#18940: Agents: expose message tool buttons schema in scoped contexts
by saurabhchopade · 2026-02-17
73.4%
#19241: docs(telegram): fix 5 discrepancies between docs and config schema
by Artzainnn · 2026-02-17
73.3%
#19102: Fix Telegram per-message link preview override
by Clawborn · 2026-02-17
72.8%
#4878: fix: string/type handling and API fixes (#4537, #4380, #4373, #4547...
by lailoo · 2026-01-30
72.7%