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

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

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

OpenClaw 部署與使用指南

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

簡(jiǎn)單說(shuō)，它不是和你對(duì)話的工具，而是幫你干活的工具。

關(guān)于項(xiàng)目名稱

你可能看到過(guò)三個(gè)名字：Clawdbot、Moltbot、OpenClaw。這是一個(gè)項(xiàng)目：

最早叫 Clawdbot
1 月底因?yàn)樯虡?biāo)問(wèn)題改名為 Moltbot
最后定名為 OpenClaw

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

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

本地安裝

一鍵安裝

最簡(jiǎn)單的方式，直接運(yùn)行安裝腳本：

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

手動(dòng)安裝

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

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

然后運(yùn)行初始化：

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

初始化配置

安裝完成后會(huì)進(jìn)入配置向?qū)?，幾個(gè)關(guān)鍵選項(xiàng)說(shuō)明一下：

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

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

AI 模型：

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

聊天通道：

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

端口：默認(rèn) 18789，不用改。

配置完成后瀏覽器會(huì)自動(dòng)打開(kāi) 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ù)器終端，運(yùn)行 openclaw onboard

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

公網(wǎng)訪問(wèn)配置

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

WebSocket 配置

接入 Telegram/WhatsApp 等需要：

openclaw configure

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

認(rèn)證方式選 Token。

Web UI 遠(yuǎn)程訪問(wèn)

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

openclaw gateway stop
openclaw gateway start

查看 token：

cat ~/.openclaw/openclaw.json

訪問(wèn) URL 加上 &token=xxx

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

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

openclaw devices list

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

openclaw devices approve b8eb70dd...

國(guó)內(nèi)模型配置

Moonshot (Kimi)

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

Kimi Code

購(gòu)買(mǎi)編程模型：https://www.kimi.com/code

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

修改配置文件

編輯 ~/.openclaw/openclaw.json，把下面的內(nèi)容加進(jìn)去（替換 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

飛書(shū)集成

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

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

2. 配置權(quán)限

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

3. 配置事件

使用長(zhǎng)連接，添加消息接收事件。

4. 連接 OpenClaw

openclaw configure

選擇 Channels，填入飛書(shū)的 App ID 和 App Secret。

常用命令

基礎(chǔ)

openclaw status          # 運(yùn)行狀態(tài)
openclaw health          # 健康檢查
openclaw doctor          # 診斷問(wèn)題
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/`	長(zhǎng)期記憶存儲(chǔ)
`~/.openclaw/skills/`	技能目錄
`/tmp/openclaw/*.log`	日志文件

工作區(qū)文件：

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

聊天命令

在聊天界面可以用：

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

常見(jiàn)問(wèn)題

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