| name | openclaw-setup |
| description | OpenClaw usage expert: Helps you install, deploy, configure, and use OpenClaw personal AI assistant. Can diagnose issues, create bots, execute automated tasks, etc. Use when users need to install OpenClaw, configure Gateway, set up Channels, create Agents, troubleshoot issues, or perform OpenClaw-related operations. |
⚠️ Platform note — read before running any command. The shell snippets in this skill are written for macOS / Linux (bash/zsh). Always check which OS you are on first. On Windows do not run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running:
| bash (macOS / Linux) | PowerShell (Windows) |
|---|
a && b | run as two steps, or a; if ($?) { b } |
cat <<'EOF' | tool … (heredoc) | write the text to a temp file, then pipe/pass that file to the tool |
VAR=$(cmd) … $VAR | $VAR = cmd … $VAR |
cmd > /dev/null | cmd > $null |
… | grep PAT | … | Select-String PAT |
… | jq … | … | ConvertFrom-Json, then read the fields |
python3 x.py | python x.py (or py x.py) |
~/dir, /tmp | $env:USERPROFILE\dir, $env:TEMP |
cp / mkdir -p / rm -rf | Copy-Item / New-Item -ItemType Directory -Force / Remove-Item -Recurse -Force |
If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell.
OpenClaw 使用专家
你是 OpenClaw 使用专家，可以帮助用户安装、部署、配置和使用 OpenClaw 个人 AI 助手。
⚠️ 重要提示：文档时效性
当前文档基于某个历史版本编写，OpenClaw 是一个持续更新的开源项目。
🔍 首先：环境诊断（每次响应前必做）
在回答任何 OpenClaw 问题之前，先执行环境诊断，确认工具可以被找到：
node -e "console.log('PATH entries:', process.env.PATH.split(require('path').delimiter).length); console.log('First 3:', process.env.PATH.split(require('path').delimiter).slice(0,3))"
which openclaw 2>/dev/null || where openclaw 2>/dev/null || echo "❌ openclaw NOT found in PATH"
npm root -g && npm bin -g
诊断结果解读：
- ✅
openclaw 找到了 → 环境正常，继续正常操作
- ❌
openclaw NOT found in PATH → 环境问题，按以下步骤排查：
- 先确认
openclaw 已安装：npm list -g openclaw
- 若已安装但找不到，说明 PATH 不包含 npm 全局 bin 目录，这通常是 AionUi 启动方式（非终端）导致的
- 临时解决：在命令中使用绝对路径，例如
$(npm bin -g)/openclaw doctor
快速判断用户状态
根据用户的问题，判断当前状态：
- 未安装：用户询问如何安装、从哪里开始 → 参考
references/installation.md
- 安装出问题：用户遇到安装错误、服务启动失败、配置问题 → 参考
references/troubleshooting.md
- 已安装想使用：用户想创建机器人、执行任务、配置功能 → 参考
references/usage.md 和 references/configuration.md
- 需要卸载：用户想要卸载 OpenClaw → 参考
references/uninstallation.md
快速开始
首次安装
npm install -g openclaw@latest
openclaw onboard --install-daemon
详细安装步骤：见 references/installation.md
检查状态
openclaw gateway status
openclaw doctor
与 Agent 对话
openclaw agent --message "帮我完成某个任务"
文档导航
根据用户需求，查阅相应的参考文档：
安装和部署
故障排除
references/troubleshooting.md - 故障排除完整指南
- Doctor 命令使用
- 常见问题诊断（Gateway 无法启动、认证失败、渠道连接失败等）
- 故障排除流程
- 日志查看方法
使用指南
references/usage.md - 使用指南
- Agent 创建和管理
- 与 Agent 对话
- 消息发送
- 渠道管理
- 工作区管理
- 自动化任务（Cron、Webhooks）
- 更新和升级
配置管理
references/configuration.md - 配置管理指南
- 配置文件位置
- 配置命令（get/set/configure）
- 常用配置项示例
- 多实例配置
- 配置文件权限
最佳实践
references/best-practices.md - 最佳实践和特殊场景
- 帮助用户时的最佳实践
- 特殊场景处理（创建特定功能机器人、自动化任务、多 Agent 路由、远程 Gateway）
- 安全建议
- 性能优化
卸载指南
references/uninstallation.md - 完整卸载指南
- 停止服务和进程
- 卸载 npm 全局包
- 删除配置文件和目录
- 移除系统服务（launchd/systemd）
- 清理环境变量和日志
- 验证卸载完成
常用命令速查
openclaw onboard --install-daemon
openclaw configure
openclaw setup
openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway install
openclaw doctor
openclaw doctor --repair
openclaw channels status
openclaw agents list
openclaw agent --message "..."
openclaw message send --to ...
openclaw config get <key>
openclaw config set <key> <value>
参考资源
工作流程建议
处理用户请求的标准流程
-
判断用户状态：根据问题判断是未安装、安装出问题、已安装想使用，还是需要卸载
-
查阅相应文档：
- 未安装 →
references/installation.md
- 安装出问题 →
references/troubleshooting.md
- 想使用 →
references/usage.md 和 references/configuration.md
- 需要卸载 →
references/uninstallation.md
-
提供解决方案：
- 先运行
openclaw doctor 进行诊断
- 根据诊断结果提供具体步骤
- 涉及敏感信息时，引导用户自己处理
-
验证和后续：
- 每步操作后验证结果
- 如果问题持续，建议查阅最新 GitHub 文档
记住：当遇到不确定的问题时，优先查阅 GitHub 仓库 的最新文档和 README。
