​

OpenClaw 安装使用指南

​

一、OpenClaw 简介

​

核心特点

• 本地运行：数据完全在你自己的设备上，隐私安全
• 多平台支持：支持 Telegram、WhatsApp、Discord、Slack、iMessage 等
• 自主执行：不只是聊天，能真正帮你操作电脑、执行命令
• 开源免费：MIT 许可证，代码在 GitHub 上公开
• 可扩展：支持自定义技能和插件

​

官方资源

• 官网：https://openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• 文档：https://docs.openclaw.ai

​

二、Mac 安装步骤

​

1. 安装 Node.js（需要 22 或更高版本）

brew install node@22

​

2. 安装 OpenClaw

npm install -g openclaw

​

3. 配置文件

​

使用自定义 API 地址的配置示例：

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.2" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.2", "name": "GPT-5.2" }
        ]
      }
    }
  }
}

​

配置说明：

• agents.defaults.model.primary：默认使用的模型，格式为 provider名/模型名
• models.providers：自定义的模型提供商配置
• baseUrl：API 地址
• apiKey：API 密钥
• api：API 类型，OpenAI 兼容用 openai-completions，Anthropic 兼容用 anthropic-messages

​

4. 运行安装向导

openclaw onboard

• Gateway 配置
• 聊天渠道连接
• 技能配置

​

5. 启动服务

openclaw gateway start

​

三、常用命令

​

四、使用方式

​

方式一：Web UI（推荐国内用户）

openclaw dashboard

​

方式二：Telegram Bot

1. 在 Telegram 搜索 @BotFather
2. 发送 /newbot 创建机器人
3. 获取 Bot Token
4. 在 openclaw onboard 时输入 Token

export https_proxy=http://127.0.0.1:代理端口
export http_proxy=http://127.0.0.1:代理端口
openclaw gateway restart

​

方式三：其他平台

• WhatsApp（扫码连接）
• Discord（需要创建 Bot）
• Slack
• Signal
• iMessage
• 微软 Teams
• 等等…

​

五、核心技能列表

​

六、聊天命令

​

七、使用示例

​

文件操作

• “帮我在桌面创建一个 test.txt 文件，内容写 hello world”
• “读取 ~/Documents/notes.txt 的内容”
• “把桌面上所有 .png 文件移动到 Pictures 文件夹”

​

终端命令

• “列出我桌面上的所有文件”
• “查看当前系统内存使用情况”
• “帮我安装 python 的 requests 库”

​

浏览器控制

• “打开浏览器访问 baidu.com”
• “搜索一下最新的 MacBook Pro 价格”
• “截图当前网页”

​

定时任务

• “每天早上 9 点提醒我喝水”
• “每隔 1 小时提醒我休息一下”
• “明天下午 3 点提醒我开会”

​

网页搜索

• “搜索一下 Python 怎么读取 Excel 文件”
• “查一下今天的天气”

​

编程辅助

• “帮我写一个 Python 脚本，批量重命名文件”
• “这段代码有什么问题：[粘贴代码]”
• “帮我写一个简单的 HTML 页面”

​

八、常见问题

​

Q1: Telegram 连不上怎么办？

export https_proxy=http://127.0.0.1:代理端口
export http_proxy=http://127.0.0.1:代理端口
openclaw gateway restart

​

Q2: 配置文件格式错误怎么办？

openclaw doctor --fix

​

Q3: 如何查看运行日志？

openclaw logs --follow

​

Q4: 如何更新 OpenClaw？

openclaw update

​

Q5: 如何添加新的聊天渠道？

openclaw channels add --channel telegram

​

Q6: OpenClaw 支持中文吗？

​

九、配置文件完整示例

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.2" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-xxxxx你的密钥xxxxx",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.2", "name": "GPT-5.2" },
          { "id": "gpt-4", "name": "GPT-4" }
        ]
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "accounts": {
        "default": {
          "token": "你的Telegram Bot Token"
        }
      }
    }
  }
}

​

十、进阶功能

​

1. 多模型配置

​

2. 技能扩展

​

3. 记忆功能

​

4. 定时任务

​

5. 多设备同步

​

十一、安全提示

1. API 密钥安全：不要把配置文件分享给他人
2. 权限控制：OpenClaw 可以执行终端命令，注意不要让它执行危险操作
3. 网络安全：默认只监听本地地址，如需远程访问请配置好安全措施

​

十二、获取帮助

• 官方文档：https://docs.openclaw.ai
• GitHub Issues：https://github.com/openclaw/openclaw/issues
• Discord 社区：https://discord.gg/openclaw
• FAQ：https://docs.openclaw.ai/faq