常见问题

OpenClaw 是一个自托管的多渠道 AI 网关。它运行一个 Gateway 进程，将 WhatsApp、Telegram、Discord、iMessage 等聊天应用连接到 AI 编程 Agent（Pi）。你可以从手机发条消息就获得 Agent 响应。MIT 开源协议。

内置支持 WhatsApp（Baileys）、Telegram（grammY）、Discord、Slack、Signal、iMessage。通过插件还可扩展 Mattermost、Feishu、Google Chat、MS Teams、Matrix 等。一个 Gateway 可同时服务所有渠道。

通过 Provider 抽象支持 Anthropic（Claude 系列）、OpenAI、Google（Gemini）、OpenRouter、Ollama 等。配置格式为 provider/model（如 anthropic/claude-sonnet-4-5）。支持主模型 + fallback 故障转移，以及 API Key 轮换。

Node.js 24（推荐）或 Node.js 22 LTS（22.16+），一个 LLM API Key。支持 macOS、Linux 和 Windows。安装和引导大约 5 分钟。

Skill 是遵循 AgentSkills 规范的目录，包含 SKILL.md 文件（YAML frontmatter + 说明正文）。从三个位置加载：bundled（随安装）、~/.openclaw/skills（本地共享）、workspace/skills（工作区，优先级最高）。可从 ClawHub（clawhub.com）安装社区 Skill。

Skill 教 Agent 如何使用工具来完成特定任务（包含说明、门控条件等），以 SKILL.md 声明。Tool 是 Agent 可调用的具体操作接口（如 read、write、exec、edit 等内置工具），受工具策略（allow/deny）控制。一个 Skill 通常组合多个 Tool。

可以。通过 agents.list 配置多个 Agent，每个有独立工作区、会话和认证。通过 bindings 规则按渠道、帐号、发送者等维度路由消息到对应 Agent。不同人可共享同一台 Gateway，数据完全隔离。

OpenClaw 完全自托管，所有数据存储在你的机器上。通过 allowFrom 白名单、pairing 配对、Gateway Token 控制访问。工具执行可放入 Docker 沙箱隔离。远程访问推荐 Tailscale 或 SSH 隧道，不要直接暴露端口。

配置位于 ~/.openclaw/openclaw.json（JSON5 格式）。不配置也可正常运行。可通过 openclaw config set、Control UI 的 Config 标签页、或直接编辑文件修改。Gateway 监听文件变化，大多数设置自动热加载。

运行 openclaw doctor 查看配置和运行状态诊断。openclaw doctor --fix 可自动修复部分问题。openclaw models status 检查模型认证状态。openclaw channels status --probe 检查渠道连接。