# OpenClaw 文档 OpenClaw 是一个**自托管网关**，它将聊天应用程序（WhatsApp、Telegram、Discord、iMessage、Slack 等）连接到 AI 编码代理。单个网关进程在您的硬件上运行，并将消息传递应用程序桥接到始终可用的人工智能助手。 **要求：** Node 22+，API 密钥（推荐 Anthropic），5 分钟。 **配置：** `~/.openclaw/openclaw.json` **默认仪表板：** `http://127.0.0.1:18789/` ## 快速开始 npm install -g openclaw@latest openclaw 板载 --install-daemon openclaw 频道登录 openclaw网关--端口18789 ## 快速参考我想... |阅读 ---|--- 安装 OpenClaw | [references/installation.md]() 连接聊天平台 | [references/channels-overview.md]() 设置 WhatsApp、Signal、iMessage、LINE、Telegram、Nostr | [references/channels-messaging-apps.md]() 设置 Discord、Slack、Teams、Mattermost、Google Chat、IRC、Matrix、飞书 | [references/channels-team-platforms.md]() 了解核心架构（运行时、工作区、会话、压缩）| [references/core-concepts.md]() 使用 CLI | [references/cli-reference.md]() 设置 cron 作业、挂钩、网络挂钩、Gmail PubSub | [references/automation.md]() 配置代理工具和斜线命令 | [references/tools.md]() 运行多个代理| [references/multi-agent.md]() 部署到云（exe.dev、Northflank、Fly.io、GCP、DigitalOcean）| [references/deployment.md]() 管理机密和网关操作 | [references/gateway-operations.md]() 使用网络仪表板或 TUI | [references/web-ui.md]() 使用插件扩展或配置模型提供程序 | [references/plugins-providers.md]() 使用 macOS 应用程序、语音唤醒或 Android | [references/platforms.md]() 构建、测试或贡献 | [references/development-reference.md]() ## 参考文件 ### [references/overview.md]() 主页：OpenClaw 是什么、它如何工作（网关作为中心枢纽）、快速启动安装、仪表板访问、基本配置。 ### [references/core-concepts.md]() 代理运行时（pi-mono 嵌入式运行时、引导文件）、代理工作区（SOUL.md、USER.md、TOOLS.md、HEARTBEAT.md、内存/）、系统提示程序集、压缩（上下文窗口管理）、重试策略（指数退避）、内存 v2 研究（离线优先架构）。 ### [references/channels-overview.md]() 通道索引（20+ 平台）、通道路由（会话密钥格式、路由优先级）、组（组策略、提及门控）、组消息（WhatsApp 特定）、广播组（并行/顺序多代理）、通道位置解析、配对（DM/设备配对、8 字符代码）。 ### [references/channels-messaging-apps.md]() BlueBubbles/iMessage（回击、效果、语音备忘录）、Signal（signal-cli、QR 配对）、LINE（Flex 消息、快速回复）、grammY/Telegram（webhook + 长轮询）、Nostr（NIP-04 加密 DM）。 ### [references/channels-team-platforms.md]() Discord（公会、论坛、Components v2、语音、PluralKit）、Slack（套接字模式、事件 API、线程、流）、MS Teams（Azure Bot、自适应卡、SharePoint）、Mattermost（聊天模式、反应）、Google Chat（HTTP webhooks）、飞书/Lark（WebSocket）、Matrix（E2EE、Beeper）、IRC（NickServ、每通道工具）、Nextcloud Talk、Synology Chat。 ### [references/automation.md]() Cron 作业（一次性“at”、重复“cron”/“every”、独立会话）、Cron 与 Heartbeat 决策指南、Hooks（事件驱动的 TypeScript 处理程序、HOOK.md 元数据）、Webhooks（“/hooks/wake”和“/hooks/agent”）、Gmail PubSub、民意调查（跨渠道）、身份验证监控（OAuth 到期、ntfy 警报）、故障排除。 ### [references/cli-reference.md]() 所有 `openclaw ` 子命令：浏览器（选项卡/快照/屏幕截图管理）、完成（shell 完成）、仪表板（打开控制 UI）、日志（尾部网关日志）、内存（语义索引/搜索）、模型（发现、默认值、身份验证配置文件）、节点（配对设备）、状态（通道/会话诊断）、系统（排队事件、心跳控制、存在）。 ### [references/tools.md]() 工具索引（所有一流工具：apply_patch、exec、web_search、浏览器、canvas、节点、cron、网关等）、斜线命令（/help、/status、/model、/think、/exec、/tts、/config、/debug、/reset、/stop 等）、反应（跨渠道表情符号语义）、浏览器登录（Chrome 配置文件身份验证）、ClawHub（公共技能注册表）、LLM 任务（仅包含模式验证的 JSON 任务）。 ### [references/gateway-operations.md]() 心跳（定期代理轮流、间隔、HEARTBEAT_OK 合同、活动时间、可见性）、机密管理（env/file/exec 源、1Password/Vault/sops 集成）。 ### [references/multi-agent.md]() 多代理路由：在一个网关中运行多个独立的代理、路由规则（最具体的获胜绑定）、DM 拆分、每个代理帐户、每个代理沙箱/工具策略。 ### [references/installation.md]() 安装概述（Node 22+、npm、curl one-liner、Docker/Podman/Nix/Ansible）、Docker（Compose、ClawDock、持久卷、代理沙箱）、Node.js（nvm/fnm/mise、路径故障排除）。 ### [references/deployment.md]() exe.dev（VM部署、nginx代理、设备配对）、Northflank（一键模板、持久存储）。 ### [references/platforms.md]() macOS 应用程序（通过网关的技能、API 密钥管理、远程模式）、语音唤醒（唤醒词检测、一键通）。 ### [references/plugins-providers.md]() 插件代理工具（`registerTool` API、白名单/拒绝名单）、OpenAI 提供程序（API 密钥、Codex、WebSocket/SSE 传输）。 ### [references/web-ui.md]() 控制 UI（Vite + Lit SPA：聊天、通道状态、会话、cron、技能、节点、执行批准、配置编辑、日志、更新、用于远程访问的 Tailscale 服务）。 ### [references/development-reference.md]() CI 管道（推送 + PR 门、智能范围）、RPC 适配器（JSON-RPC 集成）、TOOLS.md 模板（环境说明）、测试（pnpm 测试、覆盖率、E2E、Docker 冒烟测试）、OpenClaw Lore（社区历史）、入门概述、脚本。 ## 关键配置文件和路径路径|目的 ---|--- `~/.openclaw/openclaw.json` |主网关配置 `~/.openclaw/credentials/` |存储的凭据和配对状态 `~/.openclaw/agents//` |每个代理的工作空间、会话、状态 `~/.openclaw/hooks/` |用户管理的钩子目录 `~/.openclaw/cron/` | Cron 作业存储 (`jobs.json`) 工作区：`SOUL.md` |代理人个性/身份工作区：`USER.md` |用户对代理的偏好工作区：`TOOLS.md` |本地环境注释（摄像头、SSH主机等）工作区：`HEARTBEAT.md` |定期心跳运行的检查表工作区：`BOOT.md`/`BOOTSTRAP.md` |启动时注入额外的上下文工作区：`AGENTS.md` |多代理配置工作空间：`内存/` |代理内存文件工作区：`技能/` |已装技能

开爪

包含技能