OpenClaw 本地安裝與配置十分鐘完成(附常用命令速查)

發(fā)布時間：2026-03-06 09:24:50 作者：gdutxiaoxu

OpenClaw 是一個開源的個人 AI 助手,支持系統(tǒng)操作、文件讀寫、代碼執(zhí)行等,它可以通過配置文件進行各種設(shè)置,這篇文章給大家介紹OpenClaw 快速入門：10 分鐘完成本地安裝與配置（附常用命令速查），感興趣的朋友一起看看吧

OpenClaw 部署與使用指南

OpenClaw 是一個開源的個人 AI 助手項目，2026 年 1 月在 GitHub 上火了起來。和其他只能聊天的 AI 不同，OpenClaw 可以直接操作你的系統(tǒng)——讀寫文件、執(zhí)行命令、跑代碼、操作瀏覽器、處理郵件等等。

簡單說，它不是和你對話的工具，而是幫你干活的工具。

關(guān)于項目名稱

你可能看到過三個名字：Clawdbot、Moltbot、OpenClaw。這是一個項目：

最早叫 Clawdbot
1 月底因為商標問題改名為 Moltbot
最后定名為 OpenClaw

功能完全一樣，命令也兼容。

官網(wǎng)：https://openclaw.ai/
GitHub：https://github.com/openclaw/openclaw

本地安裝

一鍵安裝

最簡單的方式，直接運行安裝腳本：

macOS/Linux:

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

Windows PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

手動安裝

如果已經(jīng)裝了 Node.js ≥22：

npm i -g openclaw
# 或
pnpm add -g openclaw

然后運行初始化：

openclaw onboard

從源碼安裝

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon
pnpm gateway:watch

初始化配置

安裝完成后會進入配置向?qū)В瑤讉€關(guān)鍵選項說明一下：

風險確認：OpenClaw 需要系統(tǒng)權(quán)限來完成任務(wù)，選 Yes 繼續(xù)。

安裝模式：新手選 QuickStart 即可。

AI 模型：

國內(nèi)用戶可以用 Qwen、MiniMax、智譜。有海外賬號的推薦 Claude 或 GPT-4。暫時不確定可以先跳過，后面通過配置文件改。

聊天通道：

海外用戶選 WhatsApp/Telegram/Discord，國內(nèi)用戶可以跳過，后面配置飛書。

端口：默認 18789，不用改。

配置完成后瀏覽器會自動打開 http://127.0.0.1:18789/chat

云服務(wù)器部署

阿里云和騰訊云都有現(xiàn)成的鏡像，可以直接用。

阿里云

https://www.aliyun.com/activity/ecs/clawdbot

騰訊云

https://cloud.tencent.com/developer/article/2624973

步驟：

用 OpenClaw 鏡像重裝系統(tǒng)（注意不是 Moltbot）

登錄服務(wù)器終端，運行 openclaw onboard

后續(xù)配置和本地安裝一樣。如果要用國內(nèi)模型，建議先跳過模型配置，后面手動改配置文件。

公網(wǎng)訪問配置

云服務(wù)器部署后如果需要從外網(wǎng)訪問，需要額外配置。

WebSocket 配置

接入 Telegram/WhatsApp 等需要：

openclaw configure

把 Gateway 地址改成公網(wǎng) IP：

認證方式選 Token。

Web UI 遠程訪問

編輯 ~/.openclaw/openclaw.json，把 mode 改成 remote，bind 改成 lan，然后重啟服務(wù)。

openclaw gateway stop
openclaw gateway start

查看 token：

cat ~/.openclaw/openclaw.json

訪問 URL 加上 &token=xxx

設(shè)備授權(quán)

如果出現(xiàn) pairing required 錯誤：

openclaw devices list

復(fù)制 Pending 里的 Request ID 授權(quán)：

openclaw devices approve b8eb70dd...

國內(nèi)模型配置

Moonshot (Kimi)

創(chuàng)建 API Key：https://platform.moonshot.cn/console/api-keys
查看可用模型：https://platform.moonshot.cn/playground

Kimi Code

購買編程模型：https://www.kimi.com/code

創(chuàng)建 API Key：https://www.kimi.com/code/console?from=kfc_overview_topbar

修改配置文件

編輯 ~/.openclaw/openclaw.json，把下面的內(nèi)容加進去（替換 API Key）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "workspace": "/root/.openclaw/workspace"
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5"
          }
        ]
      },
      "kimi-code": {
        "baseUrl": "https://api.kimi.com/coding/v1",
        "apiKey": "${KIMICODE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-for-coding",
            "name": "Kimi For Coding"
          }
        ]
      }
    }
  }
}

重啟服務(wù)生效：

openclaw gateway restart

飛書集成

1. 創(chuàng)建飛書應(yīng)用

打開 https://open.feishu.cn/app，創(chuàng)建應(yīng)用，添加機器人能力。

2. 配置權(quán)限

開通消息和群組相關(guān)權(quán)限。

3. 配置事件

使用長連接，添加消息接收事件。

4. 連接 OpenClaw

openclaw configure

選擇 Channels，填入飛書的 App ID 和 App Secret。

常用命令

基礎(chǔ)

openclaw status          # 運行狀態(tài)
openclaw health          # 健康檢查
openclaw doctor          # 診斷問題
openclaw doctor --deep   # 深度檢查
openclaw configure       # 修改配置

Gateway

openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status

通道

openclaw channels list
openclaw channels login           # WhatsApp 掃碼
openclaw channels add             # 添加 Telegram/Discord
openclaw channels status --probe

模型

openclaw models list
openclaw models status
openclaw models auth setup-token

配置

openclaw config get <path>
openclaw config set <path> <value>
openclaw config unset <path>

日志

openclaw logs
openclaw logs --follow

記憶和技能

openclaw memory search "關(guān)鍵詞"
openclaw memory index
openclaw skills list
clawhub install <skill>

文件路徑

路徑	用途
`~/.openclaw/openclaw.json`	主配置文件
`~/.openclaw/workspace/`	工作區(qū)
`~/.openclaw/credentials/`	API 密鑰
`~/.openclaw/memory/`	長期記憶存儲
`~/.openclaw/skills/`	技能目錄
`/tmp/openclaw/*.log`	日志文件

工作區(qū)文件：

AGENTS.md - 給 AI 的指令
USER.md - 用戶偏好
MEMORY.md - 長期記憶
HEARTBEAT.md - 定期檢查清單
SOUL.md - 人格設(shè)定
BOOT.md - 啟動配置

聊天命令

在聊天界面可以用：

/status              查看狀態(tài)
/context list        查看上下文
/model <模型>        切換模型
/compact             精簡窗口
/new                 新對話
/stop                停止任務(wù)
/tts on/off          語音開關(guān)
/think               切換推理模式

常見問題

問題	解決
不回消息	`openclaw status`
私信沒反應(yīng)	`openclaw devices list` 批準設(shè)備
群里不響應(yīng)	檢查提及模式
認證過期	`openclaw models auth setup-token`
服務(wù)異常	`openclaw doctor --deep`
記憶問題	`openclaw memory index`