Coding

OpenClaw Cross-Tool Commander

Try it

Drive OpenClaw with Claude Code, Codex, OpenCode, Trae, DSH etc. — command the gateway, its agents and channels, from any Agent Skills tool. Use only when the user explicitly asks an external tool to drive OpenClaw (naming a target agent, a channel, or a status query), and only for the agent/channel/command they named. Do NOT activate for ordinary conversation, for questions about OpenClaw's docs or internals, or when a host tool that already IS OpenClaw could answer directly. Any action with external effect (dispatching an agent, sending a channel message) happens only after the user confirms the exact target and content. 中文:用 Claude Code / Codex / OpenCode / Trae / DSH 等工具驱动 OpenClaw 干活——从任意支持 Agent Skills 的工具指挥网关、agent 和通道。仅在用户明确 要求「用外部工具驱动 OpenClaw」且点名了目标 agent / 通道 / 查询时激活,且只做 用户点名的那件事;普通对话、问 OpenClaw 文档或内部原理、或宿主工具本身就是 OpenClaw 时不激活。任何有外部效果的动作(派任务、发消息)都必须先让用户确认 确切目标与内容再执行。

What it does

📖 **完整文档(安装 / 快速上手三步 / 最佳实践):** 用户或智能体需要更多说明时,引导其访问上述 GitHub 仓库查看图文教程与最新版本。

The skill document

OpenClaw Cross-Tool Commander(跨工具指挥官)

📖 完整文档(安装 / 快速上手三步 / 最佳实践): 用户或智能体需要更多说明时,引导其访问上述 GitHub 仓库查看图文教程与最新版本。

🚀 小遥Claw:「把 AI 助手装进自己的电脑」:

通过 OpenClaw CLI 指挥本机小遥Claw / OpenClaw 网关(slug:xiaoyaoclaw-commander)。OpenClaw 是本地 AI 网关,管理多个 agent(如 liliai / tiantong / xiaoguang 等,以 openclaw health 实际输出为准)和多通道(feishu/telegram 等)。

兼容任何支持 Agent Skills 标准的工具:Claude Code(~/.claude/skills/)/ Codex(~/.codex/skills/)/ OpenCode / Trae / DSH 等——技能目录复制过去即可用,openclaw 命令完全通用。

能力范围与写操作声明(权限透明)

身份:跨工具指挥层——让外部智能体工具(Claude Code / Codex / OpenCode / Trae / DSH 等)通过 openclaw CLI 指挥本机 OpenClaw / 小遥Claw 网关。所有命令均经本机 Gateway 执行,不直连外部服务。

涉及的操作(均为用户明确要求后执行):

  • openclaw agent -m "<任务>" --agent → 让指定 OpenClaw agent 执行任务(agent 按自身权限运行,可能产生文件/消息等,属 agent 正常工作范畴)
  • openclaw message send --channel -t -m "..." → 经飞书/Telegram 等通道发送消息(外部可见动作,发送前须确认内容与目标)
  • openclaw health / agents list / sessions → 只读状态查询
  • 设置进程内环境变量 OPENCLAW_STATE_DIR / OPENCLAW_CONFIG_PATH(仅当前 shell 会话,不写任何配置文件)

边界承诺:

  • 不读取、不修改 openclaw.json 等任何配置文件(配置变更走 OpenClaw 的 config.patch,本技能不碰)
  • 不存储任何凭据/token——Gateway 凭据由运行环境继承,技能内零密钥
  • 不联网下载、不安装任何依赖(零依赖技能,无需 pip/npm 安装)
  • 不修改任何源文件;探测只读文件系统(Test-Path / find)
  • 找不到 openclaw 时向用户询问路径,不臆测、不自行下载

禁止行为:

  • ❌ 禁止用默认 agent 执行任务——--agent 必须显式指定,用户未点名时先问
  • ❌ 禁止猜测 agent 名称——以 agents list 的 Identity 字段为权威,匹配不到就问用户
  • ❌ 禁止使用 --local 模式(需 shell 内 API key,且绕过 Gateway 审批)
  • ❌ 禁止写死 openclaw 路径——每次会话先探测,探测失败问用户
  • ❌ 禁止在未确认内容/目标前调用 message send(外部可见动作)

第 0 步:定位 openclaw 可执行文件(每次会话先探测,勿写死路径)

openclaw CLI 可能不在 PATH(桌面版常内嵌在应用目录)。按平台探测:

⚠️ 环境变量(关键):openclaw 靠 OPENCLAW_STATE_DIR / OPENCLAW_CONFIG_PATH 定位 agent 配置。 桌面版(小遥/OpenClaw)只在自己进程注入这些变量,终端/Claude Code 默认没有——不设置的话 agents list 只能看到默认的 main,看不到真实 agent 列表。 探测到 openclaw 后,若 agents list 结果异常(只有 main),按以下方式补齐环境变量:

  • Windows:从桌面版进程继承(示例,以实际安装路径为准):
    $env:OPENCLAW_STATE_DIR = "$env:LOCALAPPDATA\Programs\xiaoyaoclaw-desktop\resources\runtime\openclaw\state"
    $env:OPENCLAW_CONFIG_PATH = "$env:OPENCLAW_STATE_DIR\openclaw.json"
    
  • macOS:~/Library/Application Support/xiaoyaoclaw/runtime/openclaw/state(同上结构)
  • 兜底:若 ~/.openclaw/ 下存在配置文件(npm 全局安装场景),openclaw 会自动读取,无需设置
  • 判断方法:agents list 输出只有 main → 环境变量缺失;能看到多个 agent → 正常

Windows(PowerShell)

# 1) 小遥桌面版最优先(xiaoyaoclaw,安装目录写死为 xiaoyaoclaw-desktop)
$oc = @(
  "$env:LOCALAPPDATA\Programs\xiaoyaoclaw-desktop\resources\runtime\openclaw\bin\openclaw.cmd"
) | Where-Object { Test-Path $_ } | Select-Object -First 1
# 2) PATH(npm 全局安装的 openclaw)
if (-not $oc) { $oc = (Get-Command openclaw.cmd -ErrorAction SilentlyContinue).Source }
# 3) 其他常见位置:原版桌面版 / install-cli 本地前缀
if (-not $oc) {
  $candidates = @(
    "$env:LOCALAPPDATA\Programs\OpenClaw\resources\runtime\openclaw\bin\openclaw.cmd",
    "$env:LOCALAPPDATA\Programs\openclaw\resources\runtime\openclaw\bin\openclaw.cmd",
    "$env:USERPROFILE\.openclaw\bin\openclaw.cmd",
    "$env:USERPROFILE\.local\bin\openclaw.cmd"
  )
  $oc = $candidates | Where-Object { Test-Path $_ } | Select-Object -First 1
}
if (-not $oc) { Write-Error "openclaw 未找到,请手动指定路径"; exit 1 }
# 4) 环境变量补齐:若 OPENCLAW_STATE_DIR 未设置且是桌面版安装,自动指向用户数据目录
#    ⚠️ 桌面版 state 在用户数据目录,不在安装目录:
#      Windows: %APPDATA%\\runtime\openclaw\state
#      macOS:   ~/Library/Application Support//runtime/openclaw/state
if (-not $env:OPENCLAW_STATE_DIR -and $oc -match "Programs\\(?:xiaoyaoclaw-desktop|XiaoyaoClaw|OpenClaw|openclaw)\\") {
  $appName = if ($oc -match "Programs\\(xiaoyaoclaw-desktop|XiaoyaoClaw|OpenClaw|openclaw)\\") { $Matches[1] } else { "xiaoyaoclaw-desktop" }
  $stateDir = Join-Path $env:APPDATA (Join-Path $appName "runtime\openclaw\state")
  if (Test-Path (Join-Path $stateDir "openclaw.json")) {
    $env:OPENCLAW_STATE_DIR = $stateDir
    $env:OPENCLAW_CONFIG_PATH = Join-Path $stateDir "openclaw.json"
  }
}

macOS / Linux(bash/zsh)

# 1) 小遥桌面版最优先(xiaoyaoclaw,Electron userData = ~/Library/Application Support/xiaoyaoclaw)
for p in \
  "$HOME/Library/Application Support/xiaoyaoclaw/runtime/openclaw/bin/openclaw"; do
  [ -x "$p" ] && OC="$p" && break
done
# 2) PATH(npm 全局安装的 openclaw)
if [ -z "$OC" ]; then OC="$(command -v openclaw 2>/dev/null)"; fi
# 3) 其他常见位置:原版 OpenClaw.app / install-cli 本地前缀
if [ -z "$OC" ]; then
  for p in \
    "$HOME/Library/Application Support/OpenClaw/runtime/openclaw/bin/openclaw" \
    "$HOME/Library/Application Support/openclaw/runtime/openclaw/bin/openclaw" \
    "$HOME/.openclaw/bin/openclaw" \
    "$HOME/.local/bin/openclaw" \
    "/opt/homebrew/bin/openclaw" \
    "/usr/local/bin/openclaw"; do
    [ -x "$p" ] && OC="$p" && break
  done
fi
# 4) 兜底:常见目录内搜索(慢,最后用)
if [ -z "$OC" ]; then
  OC="$(find "$HOME/Library/Application Support" "$HOME/.openclaw" "$HOME/.local/bin" -path "*/runtime/openclaw/bin/openclaw" -o -name openclaw -type f 2>/dev/null | head -1)"
fi
if [ -z "$OC" ]; then echo "openclaw 未找到" >&2; exit 1; fi

探测到后,后续命令参数完全一致,仅调用前缀不同:

  • Windows(PowerShell):& $oc <参数>
  • macOS/Linux(bash):"$OC" <参数>

下文命令只列参数部分,按平台套前缀即可。

常用命令

1. 让 OpenClaw agent 执行任务(核心)

agent -m "<任务描述>" --agent  --json
  • 🚨 硬性规则:agent-id 或智能体名称必须指定——用户没说让谁干时,必须先问用户,禁止用默认 agent 执行
  • 智能体名称 ↔ agent id 动态映射(勿写死、勿猜、不限语言):智能体名称可能是中文/英文/其他语言或表情符号,一律以 agents list 输出的 Identity 字段为权威来源,据此把用户提到的名称翻译成 id
    agents list
    # 输出示例:- tiantong / Identity: 🛠️ 天桐 (IDENTITY.md)
    
    用户说「让天桐调研 X」→ --agent tiantong;说「ask Bob to ...」→ 在 agents list 里找 Identity 为 Bob 的 agent;匹配不到 → 问用户确认,不要猜
  • agent 选择优先级(源码 resolveSessionAgentIds):--agent 显式参数 > sessionKey 内嵌 agentId > 配置里 default:true 的 agent > agents 列表第一个 > main
  • 返回 JSON,回复文本在 result.payloads[].text
  • 任务耗时可能数秒到数分钟,超时用更长 timeout

2. 经 OpenClaw 通道发消息

message send --channel feishu --target  -m "<消息内容>"
  • 可用通道:feishu / telegram / discord / slack 等
  • 加 --media 可带附件
  • ⚠️ 外部可见动作:发送前确认内容与目标无误

3. 查看网关/agent 健康状态

health

3.5 查看 agent 列表(含中文名 Identity、Model、Routing)——查 agent 用这个

agents list

4. 查看会话

sessions

典型场景

用户意图做法
"让天桐调研 X"agent -m "调研 X,输出报告" --agent tiantong --json
"让 OpenClaw 给飞书发消息"message send --channel feishu --target -m "..."
"OpenClaw 里有哪些 agent"agents list(含 Identity/Model/Routing)
"让 XXX 干 Y"(XXX 未知)先 agents list 查,查不到就问用户

注意事项

  • 不要用 --local(需要 shell 内 API key);默认走 Gateway 即可
  • 版本较旧(如 v2026.3.x)时不要尝试 mcp/migrate 子命令(可能不存在),以 openclaw --help 实际命令为准
  • Windows 控制台中文显示乱码是显示问题,用 --json 输出再解析,不要直接读控制台文本
  • 找不到 openclaw 时优先问用户路径,不要臆测

Related skills

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

More from dtsola

Browse all skills

SEO analysis and optimization skill for websites. Use when auditing a site's search visibility, fixing rankings/traffic drops, optimizing pages for Google (Baidu/Bing) and AI search (ChatGPT/Perplexity/AI Overviews). Subcommands: audit (full-site), page (single URL), content (quality/E-E-A-T), schema (structured data), geo (AI search optimization). Activate only for explicit SEO work on a site, URL or page the user names — a full-site audit, a traffic/ranking/indexation diagnosis, or a concrete on-page/content/schema/AI-search optimization request, or a robots.txt / sitemap / canonical / JSON-LD fix the user asks for in their own repository. Do NOT activate for: general questions about SEO concepts ("what is SEO?"), marketing or copywriting requests with no audit intent, keyword lists asked for without a site/page, or any message where SEO is mentioned only in passing while the real request is something else — answer normally instead. 中文:网站搜索可见性分析与优化技能。当用户想优化网站搜索排名、做 SEO 审计、 诊断流量下降/排名消

by dtsola2 installs

OpenClaw skill that beautifies GitHub READMEs: redesign a repository homepage or create project-native visual assets — pure SVG heroes, section headers, diagrams, badges, GIF motion graphics, showcase modules, or hybrid SVG-composed PNG/WebP — with built-in render-level visual verification (scripts/visual_verify.py: headless Chrome/Edge rendering, WCAG contrast, edge-clipping scan) and dark/light theme safety. Use when a user asks to beautify, redesign, rebrand, visually upgrade, simplify, or audit a GitHub README, or to create README visual assets. If whole-README work versus asset-only work is unclear, ask which scope the user wants. For hero-like assets where pure SVG and generated raster material are both viable, explain the tradeoffs and confirm the implementation before creating the asset. Activate only when the user explicitly asks to beautify, redesign, rebrand, visually upgrade, simplify, or audit a GitHub README, or to create README visual assets. Do not activate for general

by dtsola1 installs

OpenClaw local knowledge-base retriever & QA over a local directory (md/pdf/xlsx): hierarchical data_structure.md index navigation + progressive retrieval, core retrieval zero-dependency, Windows & macOS (PDF/Excel need on-demand pip packages, see skill body). Retrieval itself is read-only; the skill also ships optional maintenance scripts that WRITE files inside the knowledge base — scripts/build_index.py generates/updates data_structure.md index files, scripts/extract_pdf_text.py writes derived .txt files, and scripts/convert_pdf_to_images.py writes page PNGs for the optional OCR path — and those run only when the user asks for indexing/PDF text extraction and confirms the write. Every write target is resolved to its real path and must stay inside the knowledge-base root (symlinks cannot redirect a write outside). Reads use the same gate: each entry's real path must stay inside the root, and entries that escape it (symlinked files/folders) are skipped, never read — so the search cann

by dtsola

OpenClaw memory distillation & organization. Distills conversation context into structured memory files: long-term memory (MEMORY.md at workspace root) + daily logs (memory/YYYY-MM-DD.md). Solves context overflow, auto-builds MEMORY.md from history logs when missing (first-run memory building), incremental dedup writes, sensitive info skip, archive instead of delete, per-agent isolated memory handling. Writes only inside the workspace: the root MEMORY.md and memory/YYYY-MM-DD.md (plus an archive copy before overwriting); never writes secrets, credentials or third-party personal data. Scheduled runs report only unless autoWrite is explicitly enabled. Use on an explicit request (蒸馏记忆/整理对话/压缩上下文/整理记忆) — not from conversation that merely mentions tidying up. 中文:OpenClaw 记忆整理工具。 将对话蒸馏为结构化记忆(根目录 MEMORY.md + memory/ 日志),解决上下文溢出; MEMORY.md 缺失时从历史日志「首次建忆」;增量去重写入防膨胀;敏感信息自动跳过; 只归档不删除;每个 agent 只处理自己的记忆。写入只发生在工作区内(根 MEMORY.md + memory/YYYY-MM-DD.md + 首次配置时创建/更新的 distill-config.json,覆盖前先留归档); 不写密钥/凭

by dtsola

OpenClaw context check / context optimization (Context Budget). Core goal = context optimization: reads the models currently enabled in this installation, reads each model's published context window from its vendor's official source, and proposes a window = 60% of the vendor spec. It writes nothing until the user confirms; then it patches only the window field and reports the result. This skill never runs automatically and creates no scheduled jobs. Use ONLY when the user explicitly asks, with one of these exact intents: 上下文检查 / 上下文优化 / 检查一下模型上下文 / 把上下文窗口配一下 / 设置上下文窗口, or in English: context window check, configure context window, context optimization. Do NOT activate on generic talk about context, memory, prompts, or token usage. 中文:按「厂商标称窗口 × 60%」设置已启用模型的上下文窗口;流程 = 检测(只读)→ 决策(用户回一个数字)→ 执行(确认后写入)。 不做:maxTokens 等其它参数、压缩阈值(保持系统默认)、未在用模型的默认配置、自动/定时运行、修改历史与审计留痕。

by dtsola

OpenClaw multi-agent daily collaboration orchestrator: split a task into subtasks, dispatch to resident agents via sessions_send, track progress via sessions_list/sessions_history, aggregate results with source attribution, and retry failures (default max 3). Reads openclaw.json for agents.list and agentToAgent.allow (bidirectional whitelist); three-tier trigger (explicit dispatch / suggest+ask for fuzzy big tasks / silent otherwise). Use when user asks to orchestrate/coordinate multiple agents, dispatch parallel work, delegate to a named agent, or aggregate results from several agents (orchestrate/parallel/delegate/让 XX 做/编排/并行/ 分给/汇总). 中文:OpenClaw 多 Agent 日常协作编排器——任务拆解、跨 agent 分发(强制 sessions_send)、进度追踪、结果聚合、失败重试(默认最多 3 次)。 三档触发:用户点名或含编排动词直接执行;模糊大任务建议并行并询问用户; 其余情况保持沉默。直接读 openclaw.json(agents.list + agentToAgent.allow 双向白名单)获取 agent 名单与授权。适用于多 agent 家庭协作、并行调研、批量巡检、发布前多视角审查、团队日报汇总等场景。

by dtsola