OpenClaw Install

Ubuntu/MacOS install Claude Code

OpenClaw install model
Abstract
本文主要介绍一下在Ubuntu/MacOS上成功安装OpenClaw 并且使用国产大模型运行的过程

1. 背景

1.1 名字变迁历史

openclaw

openclaw

Clawd诞生于2025年11月——这是“Claude”加上“爪子”的巧妙双关。一切都完美无缺，直到Anthropic的法务团队礼貌地要求我们重新考虑。好吧，这很合理。

Moltbot这个名字是接下来诞生的，它是在凌晨5点与社区成员在Discord上进行一场混乱的头脑风暴后选定的。蜕皮象征着成长——龙虾脱壳蜕皮，最终长成更大的生物。这个名字寓意深刻，但念起来却不太顺口。

OpenClaw 就是我们的最终归宿。这一次，我们做了充分的准备：商标检索结果清晰无误，域名已购买，迁移代码也已编写完成。这个名字恰如其分地概括了这个项目如今的面貌：

  • 开放：开源，对所有人开放，社区驱动
  • 龙虾爪：我们的龙虾传承，致敬我们的起源地

1.2 OpenClaw

OpenClaw 是一个开源的智能助手平台，它运行在您的计算机上，并可与您常用的聊天应用配合使用。无论您身在何处，WhatsApp、Telegram、Discord、Slack 还是 Teams，您的 AI 助手都会伴您左右。

与数据存储在他人服务器上的 SaaS 助手不同，OpenClaw 可以运行在您选择的任何地方——笔记本电脑、家庭实验室或 VPS。您的基础设施。您的密钥。您的数据。

2. 安装

运行引导式开箱向导（openclaw onboard）。它会引导您完成网关、工作区、频道和技能的设置。命令行向导是推荐的设置方式，可在 macOS、Linux 和 Windows 系统上运行（通过 WSL2；强烈推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

npm i -g openclaw openclaw onboard

curl -fsSL https://openclaw.ai/install.sh | bash -s – –install-method git

2.1 启动设置

  1. 阅读安全协议
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞                    
 
┌  OpenClaw onboarding
│
◇  Security ──────────────────────────────────────────────────────────────────────────────╮
│                                                                                         │
│  Security warning — please read.                                                        │
│                                                                                         │
│  OpenClaw is a hobby project and still in beta. Expect sharp edges.                     │
│  This bot can read files and run actions if tools are enabled.                          │
│  A bad prompt can trick it into doing unsafe things.                                    │
│                                                                                         │
│  If you’re not comfortable with basic security and access control, don’t run OpenClaw.  │
│  Ask someone experienced to help before enabling tools or exposing it to the internet.  │
│                                                                                         │
│  Recommended baseline:                                                                  │
│  - Pairing/allowlists + mention gating.                                                 │
│  - Sandbox + least-privilege tools.                                                     │
│  - Keep secrets out of the agent’s reachable filesystem.                                │
│  - Use the strongest available model for any bot with tools or untrusted inboxes.       │
│                                                                                         │
│  Run regularly:                                                                         │
│  openclaw security audit --deep                                                         │
│  openclaw security audit --fix                                                          │
│                                                                                         │
│  Must read: https://docs.openclaw.ai/gateway/security                                   │
│                                                                                         │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◆  I understand this is powerful and inherently risky. Continue?
│  ○ Yes / ● No
└
  1. Onboarding Mode 新手引导模式
◆  Onboarding mode
│  ● QuickStart (Configure details later via openclaw configure.)
│  ○ Manual
└
  1. 模式选择

自行选择合适的模式，上下键选择，Enter确定，需要自己确定模型

│
◆  Model/auth provider
│  ● OpenAI (Codex OAuth + API key)
│  ○ Anthropic
│  ○ MiniMax
│  ○ Moonshot AI
│  ○ Google
│  ○ OpenRouter
│  ○ Qwen
│  ○ Z.AI (GLM 4.7)
│  ○ Copilot
│  ○ Vercel AI Gateway
│  ○ OpenCode Zen
│  ○ Xiaomi
│  ○ Synthetic
│  ○ Venice AI
│  ○ Skip for now
└

选择合适的Model之后，输入Key API，会自动识别模型，自己确认模型的亚型即可

  1. 选择channel OpenClaw提供了多种app方式机器人
◆  Select channel (QuickStart)
│  ● Telegram (Bot API) (not configured)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ○ Skip for now
└

选择Telgram作为主要app，按照提示操作即可

│
◇  Select channel (QuickStart)
│  Telegram (Bot API)
│
◇  Telegram bot token ───────────────────────────────────────────────────────────────────╮
│                                                                                        │
│  1) Open Telegram and chat with @BotFather                                             │
│  2) Run /newbot (or /mybots)                                                           │
│  3) Copy the token (looks like 123456:ABC...)                                          │
│  Tip: you can also set TELEGRAM_BOT_TOKEN in your env.                                 │
│  Docs: https://docs.openclaw.ai/telegram  │
│  Website: https://openclaw.ai                                                          │
│
  • 在电报中搜索@BotFather
  • 输入/newbot命令
  • 给机器人起个名字
  • 得到API，复制输入行中即可
  1. 安装skills
◇  Preferred node manager for skill installs
│  npm
│
◆  Install missing skill dependencies
│  ◻ Skip for now (Continue without installing dependencies)
│  ◻ 🔐 1password
│  ◻ 📝 apple-notes
│  ◻ ⏰ apple-reminders
│  ◻ 🐻 bear-notes
│  ◻ 🐦 bird
│  ◻ 📰 blogwatcher
│  ◻ 🫐 blucli
│  ◻ 📸 camsnap
│  ◻ 🧩 clawhub
│  ◻ 🎛️ eightctl
│  ◻ ♊️ gemini
│  ◻ 🧲 gifgrep
│  ◻ 🐙 github
│  ◻ 🎮 gog
│  ◻ 📍 goplaces
│  ◻ 📧 himalaya
│  ◻ 📨 imsg
│  ◻ 📦 mcporter
│  ◻ 📊 model-usage
│  ◻ 🍌 nano-banana-pro
│  ◻ 📄 nano-pdf
│  ◻ 💎 obsidian
│  ◻ 🎙️ openai-whisper
│  ◻ 💡 openhue
│  ◻ 🧿 oracle
│  ◻ 🛵 ordercli
│  ◻ 👀 peekaboo
│  ◻ 🗣️ sag

自己选择合适的skills

3. 原理

WhatsApp / Telegram / Discord / iMessage (+ plugins)
        │
        ▼
  ┌───────────────────────────┐
  │          Gateway          │  ws://127.0.0.1:18789 (loopback-only)
  │     (single source)       │
  │                           │  http://<gateway-host>:18793
  │                           │    /__openclaw__/canvas/ (Canvas host)
  └───────────┬───────────────┘
              │
              ├─ Pi agent (RPC)
              ├─ CLI (openclaw …)
              ├─ Chat UI (SwiftUI)
              ├─ macOS app (OpenClaw.app)
              ├─ iOS node via Gateway WS + pairing
              └─ Android node via Gateway WS + pairing