openclaw部署简明指南

你的 AI 助理终于可以帮你干活了

OpenClaw 上手指南

官方文档：docs.openclaw.ai 

GitHub：github.com/openclaw/openclaw

你有没有遇到过这种情况——

AI 聊天聊得很好，但一说"帮我发这封邮件"，它就说"我没有权限"；一说"帮我定个提醒"，它说"我做不到"；每次开新对话，还得重新介绍自己一遍。

OpenClaw 就是来解决这个问题的。它是一个开源的自托管 AI 助理框架，也是靠史山堆起来的。它能让 AI 真正接管你日常的操作任务——读写文件、执行命令、搜索网页、发飞书消息、管理 GitHub、定时给你推日报……而且记得住你是谁，不用每次重新介绍。，当然了，今天在这里有点炒冷饭了.......

一、先搞清楚：Tools 和 Skills 是什么

很多人装完 OpenClaw 就懵了——工具那么多，从哪下手？其实只需要记住两个概念：

Tools（工具）是器官。

它决定 AI 能不能做某件事。exec 让它能跑命令，write 让它能写文件，web_search 让它能搜索网页，browser 让它能控制 Chrome。没有对应的 Tool，AI 再聪明也没有手脚。

Skills（技能）是教材。

它告诉 AI 怎么组合工具完成特定任务。github 这个 Skill 教它怎么操作代码仓库，gog 教它怎么用 Google Workspace 收发邮件。但 Skill 本身不给权限——你还得有对应的 Tool 开着才行。

核心逻辑：Tools 决定能力边界，Skills 决定做事方式。

二、环境要求

开始之前，确认一下你的环境：

✅Node.js v24（推荐）或 v22.16+

✅操作系统：Linux、macOS，Windows 推荐用 WSL2（自己去买个服务器也可

✅模型 API Key：GLM5 / Deepseek / Qwen，至少一个

检查 Node 版本：

node --version

三、安装

方式一：一键脚本（最快）

Linux / macOS：

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

Windows（PowerShell）：

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

方式二：npm / pnpm

npm install -g openclaw@latest

# 或

pnpm add -g openclaw@latest

方式三：Docker

docker pull openclaw/openclaw:latest

docker run -d \

-v~/.openclaw:/root/.openclaw \

-p18789:18789 \

openclaw/openclaw:latest

四、初始化

装完别急着配置，先跑引导向导：

openclaw onboard --install-daemon

向导会带你完成：

①输入模型 API Key（推荐先配 deepseek，因为便宜）

②设置工作目录（你的项目文件夹）

③是否安装为系统守护进程（推荐，开机自启）

④可选接入第一个聊天频道（比如飞书）

完成后启动 Gateway：

openclaw gateway

# 打开控制台

openclaw dashboard

浏览器访问 http://localhost:18789，在 WebChat 发一条消息，收到回复就成功了。

五、配置文件（openclaw.json）

所有配置都在 ~/.openclaw/openclaw.json。下面是一份完整的参考示例配置：

{

"models":{

"default":"claude-opus-4",

"heartbeat":"claude-haiku-4",

"providers":{

"anthropic":{ "apiKey": "sk-ant-..." }

},

"fallback":["claude-sonnet-4", "gpt-4o"]

},

"tools":{

"profile":"default",

"allow":["web_search", "web_fetch", "memory_search"],

"deny":["browser", "nodes"],

"approvals":{

"exec":{ "enabled": true }

}

},

"skills":{

"allowBundled":["github", "tmux", "gog"]

},

"channels":{

"feishu":{

"enabled":true,

"appId":"cli_xxxxxxxxxxxxxx",

"appSecret":"你的AppSecret",

"connectionMode":"websocket"

}

},

"workspace":"~/Projects",

"gateway":{

"port":18789

}

}

几个关键点：

⚠️approvals.exec.enabled: true —— 这个必须开。每次 AI 要执行命令，都会先弹出来让你确认。

🎯skills.allowBundled —— 只写你真正要用的 Skills，防止内置 Skills 自动激活。

👤allowedUsers —— 只填你自己的用户名，防止陌生人控制你的 AI。

六、工具（Tools）配置

工具风险分级

核心工具（几乎人人都要开）

高级工具（按需开启）

Profile 快速设置

七、技能（Skills）配置

53 个内置 Skills 分类

重要：内置 Skills 默认全量加载

⚠️只要系统里装了对应的 CLI 工具，对应 Skill 就自动激活，你可能根本不知道它在工作。

推荐改成白名单模式：

{

"skills":{

"allowBundled":["github", "tmux", "session-logs"]

}

}

安装社区 Skills（ClawHub）

openclaw skills search obsidian# 搜索

openclaw skills install user/skill # 安装

openclaw skills list# 查看已安装

八、接入飞书（也可以接入微信）

飞书是 OpenClaw v2026.2 起首个官方支持的国内聊天平台，由飞书开放平台团队维护官方插件。接上飞书之后，你可以在手机上随时发指令给 AI：查 GitHub CI 报错、收日报推送、远程操控服务器，回复以流式卡片实时呈现。

① 创建飞书自建应用

登录 open.feishu.cn → 创建应用 → 选"自建应用"，记下 App ID 和 App Secret。

在应用后台：

•开启"机器人"能力

•添加权限：im:message、im:message:send_as_bot

•事件订阅页面选择"长连接模式（WebSocket）"——不需要公网 IP，内网也能跑

发布应用（企业内部应用一般自动审批）。

② 安装官方插件

openclaw plugins install @larksuiteoapi/feishu-openclaw-plugin

③ 写入配置

{

"channels":{

"feishu":{

"enabled":true,

"appId":"cli_xxxxxxxxxxxxxx",

"appSecret":"你的AppSecret",

"domain":"feishu",

"connectionMode":"websocket",

"streaming":true

}

},

"plugins":{

"allow":["feishu-openclaw-plugin"]

}

}

如果你用的是国际版 Lark，把 domain 改为 "lark" 即可。

④ 完成配对

重启 Gateway 后，在飞书里给 Bot 发一条任意消息，Bot 会回复一串配对码。在服务器上运行：

openclaw pairing approve feishu <配对码> --notify

配对成功后即可正常对话。配对码 5 分钟内有效，过期重发一条消息再来一次。

⑤ 常用内置命令

九、模型配置进阶

接入本地模型（Ollama，显卡性能可以的试试跑个小模型）

国内网络环境下，接本地 Ollama 是个好选择，对话走本地推理，隐私有保障：

{

"models":{

"providers":{

"ollama":{

"type":"openai-compatible",

"baseURL":"http://localhost:11434/v1",

"apiKey":"ollama",

"models":["qwen2.5:72b", "deepseek-r1:32b"]

}

},

"default":"qwen2.5:72b"

}

}

多 Key 轮换防限速

"authProfiles": [

{"apiKey": "sk-ant-key1" },

{"apiKey": "sk-ant-key2" }

]

主模型挂了自动降级

"fallback": ["claude-sonnet-4", "gpt-4o"],

"heartbeat": "claude-haiku-4"// 定时任务用轻量模型省钱

十、定时任务：每天早上收 AI 日报

需要开启 cron 和 message 两个工具。开启之后，直接在对话里说：

每天早上 7:00 给我发一份日报，包含今天的日历安排、待处理的 GitHub PR 和今天的天气

AI 会自动创建定时任务。手动管理：

openclaw cron list# 查看所有任务

openclaw cron delete# 删除任务

openclaw cron logs# 查看执行日志

十一、安全配置（这几条必须做）

① exec 必须开审批

{ "tools": { "approvals": { "exec": { "enabled": true } } } }

② 飞书频道设白名单

"feishu": {

"dmPolicy":"pairing"// 只接受已配对用户的私信

}

③ Skills 用白名单模式

{ "skills": { "allowBundled": ["github", "tmux"] } }

④ 高风险工具显式禁用

{ "tools": { "deny": ["nodes", "browser"] } }

⑤ 定期运行诊断

openclaw doctor

十二、常用命令速查

# 生命周期

openclaw gateway# 前台启动

openclaw gateway start# 后台启动

openclaw gateway stop# 停止

openclaw gateway status# 查看状态

openclaw dashboard# 打开控制台

# Skills

openclaw skills list

openclaw skills search <关键词>

openclaw skills install <名称>

# 记忆

openclaw memory list

openclaw memory search <关键词>

# Cron

openclaw cron list

openclaw cron logs

# 调试

openclaw doctor

openclaw logs --follow

十三、常见问题

小结

OpenClaw 的配置哲学可以用一句话概括：从最小权限开始，按需扩展。

建议的上手顺序：

1  先只开核心工具（read、write、exec + 审批、web_search）

2接一个飞书 Bot，验证基本功能可用

3根据实际需要，逐步加 Skills 和高级工具

4确认一切符合预期后，再考虑开 cron / memory / browser

⚠️不要一上来就 "profile": "full"，那等于把钥匙全给了 AI。

官方资源

• 文档：https://docs.openclaw.ai

• GitHub：https://github.com/openclaw/openclaw

• Skills 社区（ClawHub）：https://clawhub.ai

• Discord 社区：https://discord.gg/openclaw

本文基于 OpenClaw 2026.3.x 版本整理·2026-03-29