OpenClaw（龙虾）使用指南：配置、首聊、频道与排障
本文根据 OpenClaw 官方 Configuration、First Conversation、Channels、Commands 和 FAQ 文档整理，重点解决“装完之后怎么真正用起来”。
官方来源
OpenClaw 是什么
- 官方把 OpenClaw定义为开源、自托管、privacy-first 的 AI agent platform。
- 官方主页强调它支持 50+ communication channels。
- 官方主页和 What is OpenClaw 文档都提到 ClawHub 已有 5700+ 技能。
- 官方明确支持多模型提供商，包括 OpenAI、Anthropic、Google、Ollama 和 OpenAI-compatible endpoints。
配置文件与默认后台
- 核心配置文件是 `openclaw.yaml`。
- FAQ 还列出了 `~/.openclaw/openclaw.json`、`~/.clawdbot/moltbot.json`、`~/.config/openclaw/config.json` 等常见路径。
- 可以使用 `openclaw config path` 查看当前实例的配置文件位置。
- 官方示例里 dashboard 默认管理员是 `admin / changeme123`，正式使用前应立即修改密码。
模型与提供商配置
- OpenAI 示例常见模型为 `gpt-4o`。
- Anthropic 示例常见模型为 `claude-sonnet-4.6`。
- Google（Gemini）示例常见模型为 `gemini-2.0-flash`。
- 如果你走本地模型路线，官方也支持 Ollama。
首次启动与第一轮对话
openclaw start
# 后台运行
openclaw start --daemon- 官方 First Conversation 文档默认在浏览器打开 `http://localhost:3000`。
- 首次登录进入 dashboard 后，先确认模型可用、会话可创建、界面可正常响应。
- 官方建议先发送一条简单消息，例如 “Hello, OpenClaw! What can you do?”，确认文本响应和技能链路正常。
- 完成首聊后，可以继续在 dashboard 查看 conversation log 和 agent actions。
常用命令
openclaw onboard
openclaw onboard --install-daemon
openclaw configure
openclaw doctor
openclaw dashboard
openclaw tui- `openclaw onboard` 适合初始化或补做首次配置。
- `openclaw configure` 用于补充和修改模型、提供商等配置。
- `openclaw doctor` 用于排查环境问题。
- `openclaw dashboard` 用于打开 Web 控制台。
- `openclaw tui` 适合 SSH 或终端环境下使用。
频道接入怎么选
- 官方 Channels Overview 按难度列出了不同渠道。
- Telegram、Discord、WebChat 适合作为 easy 入口。
- Slack、Feishu、Google Chat 更接近 medium 难度。
- WeChat、Teams、iMessage 等通常更复杂，适合作为后续扩展。
- 如果你只是想先验证 channel 流程，优先从 Telegram 或 Discord 开始。
排障检查
openclaw config validate
openclaw doctor
openclaw dashboard
openclaw channels list- 配置改完后，先执行 `openclaw config validate` 检查 YAML 和逻辑问题。
- 如果遇到 401、404、429 或 Base URL 异常，优先回到官方 FAQ 对照提供商配置。
- 在 Docker 或容器环境里，FAQ 还特别提醒 `localhost` 可能需要换成 `host.docker.internal`。
- 官方 FAQ 也单独提到 macOS 场景下的权限问题，例如 Screen Recording、Accessibility 和 Full Disk Access。
使用建议
- 如果你要长期自托管，优先把管理员密码、端口和 provider key 管理好。
- 如果你要接多渠道，建议先把一个 channel 跑通，再复制配置到其他渠道。
- 如果你要做技能扩展或深度集成，建议直接对照官方 GitHub 仓库和文档继续推进。
备注
- 本文内容已于 2026-04-09 对照官方公开文档核对。
- 如官方配置字段、默认模型或频道支持列表更新，应以官方文档为准。