Openclaw 使用文档

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 
  
    
     
      
      Openclaw提供一键安装脚本，自动安装所有依赖： 
       
        
        # 一键安装脚本（自动安装Node.js和所有依赖）  
        curl -fsSL https://molt.bot/install.sh | bash

 
  
    
     
     # PowerShell 一键安装  
     iwr -useb https://molt.bot/install.ps1 | iex

 如果您已经安装了Node.js 22+，可以直接使用npm安装：
 # 使用 npm 全局安装 
 npm install -g openclaw@latest
 或使用 pnpm
 pnpm add -g openclaw@latest
 或使用 bun
 bun add -g openclaw@latest

 开发者可以从GitHub克隆源码进行安装：
 # 克隆仓库 
 git clone https://github.com/openclaw/openclaw.git cd openclaw
 安装依赖
 pnpm install
 构建UI
 pnpm ui:build
 构建项目
 pnpm build
 运行安装向导
 pnpm openclaw onboard –install-daemon

 安装完成后，运行以下命令验证：
 # 检查版本 
 openclaw –version
 运行诊断
 openclaw doctor

 
  
    
     
     按照以下步骤，5分钟内让Openclaw运行起来： 
      
       
       运行安装向导 
       安装向导会引导您完成所有必要的配置： 
       openclaw onboard --install-daemon 
       向导会帮您配置：Gateway网关、工作空间、聊天平台、AI模型和技能。 
       
       
       连接聊天平台 
       选择一个或多个聊天平台进行连接： 
       # 登录聊天平台（如WhatsApp）  
       openclaw channels login

 扫描二维码或输入Token完成连接。 
  
    
     
     启动Gateway 
     启动Openclaw网关服务： 
     openclaw gateway --port 18789 --verbose 
     网关是Openclaw的控制中心，管理所有会话、工具和事件。 
     
  
    
     
     开始对话 
     在已连接的聊天平台上发送消息，开始与您的AI助手对话！ 
     # 或者通过CLI发送消息  
     openclaw agent –message “你好，Openclaw！”

 
  
    
     
     Openclaw的配置文件位于 ~/.openclaw/openclaw.json。以下是基础配置示例： 
     {  
     “agent”: { 
     "model": "anthropic/claude-opus-4-5", "thinkingLevel": "medium"  
     }, “gateway”: { 
     "port": 18789, "bind": "loopback"  
     }, “agents”: { 
     "defaults": { "workspace": "~/openclaw" }  
     } }

 
  
    
    
      配置项 说明 
     agent.model 默认使用的AI模型 
     agent.thinkingLevel 思考深度：off/minimal/low/medium/high/xhigh 
     gateway.port Gateway服务端口 
     gateway.bind 绑定地址：loopback/all 
     agents.defaults.workspace 工作空间目录 
    
 Openclaw的工作空间默认位于 ~/openclaw，包含以下重要文件： 
  
    
     
     AGENTS.md - 代理配置和行为定义 
     SOUL.md - AI助手的个性和身份设定 
     TOOLS.md - 可用工具的配置 
     skills/ - 技能扩展目录 
     
  
    
     
     Openclaw支持多种AI模型提供商： 
     
       提供商 模型 认证方式 Anthropic Claude Opus 4.5, Claude Sonnet 4.5 OAuth / API Key OpenAI GPT-5.2, GPT-4o, Codex API Key Google Gemini Ultra, Gemini Pro API Key Ollama Llama, Mistral, 等本地模型 本地运行 
      
     {  
     “agent”: { 
     "model": "anthropic/claude-opus-4-5"  
     }, “auth”: { 
     "anthropic": { "type": "oauth" // 或 "apiKey" }  
     } }

 { 
 “agent”: {
 "model": "openai/gpt-5.2" 
 }, “auth”: {
 "openai": { "apiKey": "sk-..." } 
 } }

 Openclaw支持配置多个模型，当主模型不可用时自动切换：
 { 
 “agent”: {
 "model": "anthropic/claude-opus-4-5", "fallbackModels": [ "anthropic/claude-sonnet-4-5", "openai/gpt-5.2" ] 
 } }

 
  
    
     
     通过扫描二维码连接WhatsApp： 
     # 登录WhatsApp  
     openclaw channels login whatsapp

 配置文件设置：
 { 
 “channels”: {
 "whatsapp": { "allowFrom": ["+86138"], // 允许的手机号 "groups": ["*"] // 允许的群组，"*"表示全部 } 
 } }

 创建Telegram Bot并获取Token： 
  
    
     
     在Telegram中找到 @BotFather 
     发送 /newbot 创建新机器人 
     复制获得的Bot Token 
    
 { 
 “channels”: {
 "telegram": { "botToken": ":ABCDEF..." } 
 } }

 创建Discord Bot应用： 
  
    
     
     访问 Discord Developer Portal 
     创建新应用并添加Bot 
     复制Bot Token 
     邀请Bot到您的服务器 
    
 { 
 “channels”: {
 "discord": { "token": "your-bot-token" } 
 } }

 { 
 “channels”: {
 "slack": { "botToken": "xoxb-...", "appToken": "xapp-..." } 
 } }

 iMessage集成需要在macOS上运行，并且Messages应用已登录：
 { 
 “channels”: {
 "imessage": { "enabled": true, "groups": ["*"] } 
 } }

 
  
    
     
     配置聊天平台时，请务必设置 allowFrom 白名单，限制可以与Openclaw交互的用户，防止未授权访问。 
     
  
    
     
     Gateway是Openclaw的控制中心，管理所有会话、工具和事件。 
     {  
     “gateway”: { 
     "port": 18789, "bind": "loopback", "verbose": true  
     } }

 
  
    
    
      参数 说明 
     --port 服务端口号（默认18789） 
     --bind 绑定地址：loopback（本地）/ all（所有接口） 
     --verbose 详细日志输出 
     --daemon 以守护进程模式运行 
    
 # 安装为系统服务 
 openclaw onboard –install-daemon
 手动启动/停止服务
 openclaw gateway start openclaw gateway stop openclaw gateway restart

 Gateway运行后，可以通过Web浏览器访问控制台：
 http://localhost:18789
 控制台提供会话管理、配置编辑、日志查看等功能。 
  
    
     
     Openclaw为每个对话创建独立的会话，支持： 
      
      主会话 - 您的私人对话，拥有完整权限 
      群组会话 - 群聊中的对话，可配置触发方式 
      会话隔离 - 不同会话之间的上下文完全隔离 
      
     在聊天中可以使用以下命令控制Openclaw： 
     
       命令 说明 
      /status 查看会话状态（模型、Token使用量） 
      /new 或 
      /reset 重置当前会话 
      /compact 压缩会话上下文 
      /think 
        设置思考深度 
      /verbose on|off 开关详细模式 
      /usage 显示Token使用统计 
      
     Openclaw具备强大的记忆能力： 
      
      对话记忆 - 记住您的所有对话内容 
      偏好学习 - 学习您的习惯和偏好 
      跨会话同步 - 不同平台间的记忆同步 
      
     
  
    
     
     Openclaw可以控制专用的Chrome/Chromium浏览器，执行各种网页操作。 
     {  
     “browser”: { 
     "enabled": true, "color": "#FF4500", "headless": false  
     } }

 
  
    
     
     网页浏览 - 访问任意网站，提取内容 
     表单填写 - 自动填写和提交表单 
     截图 - 对网页进行截图 
     文件上传 - 上传文件到网站 
     多配置文件 - 支持多个浏览器配置文件 
     
  
    
     
     技能是Openclaw的扩展能力，可以添加新的功能和行为。 
      
      内置技能 - Openclaw自带的核心技能 
      托管技能 - 从ClawdHub安装的社区技能 
      工作空间技能 - 本地自定义的技能 
      
     # 从ClawdHub搜索技能  
     openclaw skills search calendar 
     安装技能 
     openclaw skills install calendar-sync 
     列出已安装技能 
     openclaw skills list

 技能是一个包含 SKILL.md 文件的目录：
 # ~/openclaw/skills/my-skill/SKILL.md 
 My Custom Skill
 Description
 这是我的自定义技能，用于…
 Tools 
  
    
     
     tool_name: 工具描述 
    
 Examples
 用户: 执行某个任务 助手: 好的，我来帮您…

 访问 ClawdHub 浏览和发布技能。热门技能包括： 
  
    
     
     日历同步 - 与Google Calendar、Outlook同步 
     邮件管理 - Gmail、Outlook邮件处理 
     任务管理 - Todoist、Notion集成 
     代码助手 - GitHub、GitLab操作 
     智能家居 - HomeKit、Google Home控制 
     
  
    
     
     设置定时任务让Openclaw主动工作： 
     {  
     “cron”: { 
     "jobs": [ { "name": "daily-briefing", "schedule": "0 8 * * *", "message": "给我生成今天的日程摘要" }, { "name": "weekly-report", "schedule": "0 18 * * 5", "message": "总结本周的工作进展" } ]  
     } }

 通过Webhook接收外部事件触发：
 # Webhook端点 
 POST http://localhost:18789/webhook
 请求体
 { “event”: “github_pr”, “data”: {…} }

 实时接收Gmail通知：
 { 
 “automation”: {
 "gmail": { "enabled": true, "watchLabels": ["INBOX"], "actions": { "newEmail": "处理新邮件并通知我重要的内容" } } 
 } }

 
  
    
     
     在macOS、iOS和Android上支持语音唤醒： 
     {  
     “voice”: { 
     "wakeWord": "Hey Clawd", "enabled": true  
     } }

 持续的语音对话体验，无需每次唤醒： 
  
    
     
     macOS菜单栏应用中启用 
     iOS/Android节点应用中使用 
     配合ElevenLabs获得自然语音合成 
    
 配置ElevenLabs语音合成：
 { 
 “voice”: {
 "tts": { "provider": "elevenlabs", "voiceId": "your-voice-id" } 
 } }

 
  
    
     
     在Windows上，强烈建议使用WSL2运行Openclaw： 
     # 安装WSL2  
     wsl –install 
     在WSL2中安装Openclaw 
     curl -fsSL https://molt.bot/install.sh | bash

 也可以在原生Windows PowerShell中运行：
 iwr -useb https://molt.bot/install.ps1 | iex 
  
    
     
      
      Ubuntu 20.04+ 
      Debian 11+ 
      Fedora 35+ 
      Arch Linux 
      
     # 一键安装  
     curl -fsSL https://molt.bot/install.sh | bash 
     或使用Nix 
     nix-shell -p openclaw

 # 安装服务 
 openclaw onboard –install-daemon
 管理服务
 systemctl –user start openclaw systemctl –user enable openclaw

 
  
    
     
     iOS应用作为节点连接到Gateway： 
      
      Canvas可视化工作空间 
      语音唤醒和对话模式 
      相机和屏幕录制 
      Bonjour自动配对 
      
     Android应用功能类似： 
      
      Canvas和对话模式 
      相机和屏幕捕获 
      可选SMS集成 
      
     # 列出可用节点  
     openclaw nodes list 
     配对新节点 
     openclaw nodes pair

 
  
    
     
     配置白名单限制访问： 
     {  
     “channels”: { 
     "whatsapp": { "allowFrom": ["+86138"], "dmPolicy": "pairing" }  
     } }

 未知发送者需要配对码才能使用：
 # 审批配对请求 
 openclaw pairing approve telegram abc123

 为群聊启用Docker沙盒：
 { 
 “agents”: {
 "defaults": { "sandbox": { "mode": "non-main" } } 
 } }

 配置允许和禁止的工具：
 { 
 “tools”: {
 "allow": ["bash", "read", "write"], "deny": ["browser", "nodes"] 
 } }

 
  
    
     
     在将Gateway暴露到公网之前，务必配置密码认证和白名单。运行 openclaw doctor 检查安全配置。 
     
  
    
     
     使用Tailscale安全地远程访问Gateway： 
     {  
     “gateway”: { 
     "tailscale": { "mode": "serve" // 或 "funnel" }  
     } }

 # 创建SSH隧道 
 ssh -L 18789:localhost:18789 user@remote-host

 在Linux服务器上运行Gateway，从其他设备连接： 
  
    
     
     Gateway运行在服务器上，执行工具调用 
     macOS/iOS/Android作为节点连接 
     设备特定操作通过节点执行 
     
  
    
     
      
       
       运行安装向导，配置Gateway、工作空间、聊天平台和技能。 
       选项： 
        
        --install-daemon - 安装为系统服务 
        
       
      
      
       
       启动Gateway服务。 
       选项： 
        
        --port 
           - 服务端口 
        --verbose - 详细日志 
        start|stop|restart - 服务控制 
        
       
      
      
       
       与AI代理交互。 
       选项： 
        
        --message 
           - 发送消息 
        --thinking 
           - 思考深度 
        
       
      
      
       
       管理聊天平台连接。 
       子命令： 
        
        login [channel] - 登录聊天平台 
        list - 列出已连接平台 
        logout [channel] - 登出平台 
        
       
      
      
       
       管理技能扩展。 
       子命令： 
        
        search 
           - 搜索技能 
        install 
           - 安装技能 
        list - 列出已安装技能 
        remove 
           - 移除技能 
        
       
      
      
       
       更新Openclaw到最新版本。 
       选项： 
        
        --channel stable|beta|dev - 更新通道 
        
       
      
     
  
    
     
     Q: 安装时提示Node.js版本过低？ 
     Openclaw需要Node.js 22或更高版本。使用nvm或直接从nodejs.org下载最新版本： 
     # 使用nvm安装Node.js 22  
     nvm install 22 nvm use 22

 Q: Windows上安装失败？
 建议使用WSL2环境运行Openclaw：
 wsl --install 
 然后在WSL2中运行安装脚本

 Q: WhatsApp扫码后无法连接？
 确保您的手机和电脑在同一网络，并且手机上的WhatsApp是最新版本。尝试重新运行 openclaw channels login whatsapp。
 Q: Telegram Bot无响应？
 检查Bot Token是否正确，并确保已向Bot发送过 /start 命令。查看Gateway日志获取详细错误信息。
 Q: 如何重置会话？
 在聊天中发送 /reset 或 /new 命令即可重置当前会话。
 Q: 如何查看Token使用量？
 发送 /status 命令查看当前会话的Token使用情况和成本估算。
 Q: Openclaw可以访问我的文件吗？
 默认情况下，主会话的Openclaw有完整的文件系统访问权限。您可以在配置中限制访问范围或启用沙盒模式。
 如果您遇到其他问题： 
  
    
     
     运行 openclaw doctor 进行自动诊断 
     查看 官方文档 
     加入 Discord社区 获取帮助 
     在 GitHub 提交Issue

或使用 pnpm

或使用 bun

安装依赖

构建UI

构建项目

运行安装向导

运行诊断

运行安装向导

连接聊天平台

启动Gateway

开始对话

手动启动/停止服务

安装技能

列出已安装技能

My Custom Skill

Description

Tools

Examples

请求体

在WSL2中安装Openclaw

或使用Nix

管理服务

配对新节点

Q: 安装时提示Node.js版本过低？

Q: Windows上安装失败？

然后在WSL2中运行安装脚本

Q: WhatsApp扫码后无法连接？

Q: Telegram Bot无响应？

Q: 如何重置会话？

Q: 如何查看Token使用量？

Q: Openclaw可以访问我的文件吗？

相关推荐