部署方案 - ubuntu
自部署方案
安装npm等前置组件
sudo apt upgrade
sudo apt install npm
sudo apt install -y curl添加node.js 22版本仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash装node.js
sudo apt install -y nodejs安装中文版openclaw
npm install -g openclaw-cn@latest引导启动openclaw守护进程
openclaw onboard-cn --install-daemon安装中文版clawbot
sudo npm install -g openclaw-cn@latest --registry https://registry.npmmirror.com启动openclaw守护线程
openclaw-cn onboard --install-daemon一键部署方案
curl -fsSL https://openclaw.ai/install.sh | bash这个方案部署完后，可能无法执行openclaw命令，只需要关掉terminal重启一次即可
openclaw.json的最小配置模板如下：
{
"gateway": {
"port": 18789,
"host": "127.0.0.1"
},
"models": {
"default": "openrouter/anthropic/claude-3-opus"
},
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-XXXXXXXXXXXXXXXX"
}
},
"channels": {
"whatsapp": { "dmPolicy": "pairing" },
"telegram": { "dmPolicy": "pairing" }
},
"session": {
"prune": { "enabled": true }
}
}连接openclaw dashboard
在机器上执行：
openclaw dashboard可以连接到控制面板，但是如果部署环境是linux，没有UI控件，则必须要找一个带有UI控件的机器远程一下
以云服务器为例，先在自己的电脑上执行
ssh -N -L 18789:127.0.0.1:18789 serverUserName@serverIp将自己的电脑18789端口转发到远程服务器的18789端口
这里如果报错如下：
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the ED25519 key sent by the remote host is
SHA256:06KD/V6tqGFJu6FaB+qh64/fPMeX6AD++iMoHtZO0QE.
Please contact your system administrator.则进入C:\Users\<用户名>\.ssh\known_hosts 把对应远程ip的密钥记录删掉即可
连接成功后就可以在自己的电脑上执行：
localhost:18789或localhost:18789#token=xxxxx登录dashboard了
如果不带token登录则必须要把token粘下来，贴到下面
接入大模型
{
meta: {
lastTouchedVersion: '2026.3.8',
lastTouchedAt: '2026-03-10T08:12:45.328Z',
},
wizard: {
lastRunAt: '2026-03-10T08:12:45.322Z',
lastRunVersion: '2026.3.8',
lastRunCommand: 'configure',
lastRunMode: 'local',
},
models: {
mode: 'merge',
providers: {
bailian: {
baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
apiKey: '__OPENCLAW_REDACTED__',
api: 'openai-completions',
models: [
{
id: 'qwen-plus',
name: 'qwen-plus',
api: 'openai-completions',
reasoning: false,
input: [
'text',
'image',
],
cost: {
input: 0,
output: 0,
cacheRead: 0,
cacheWrite: 0,
},
contextWindow: 1000000,
maxTokens: 65536,
},
],
},
},
},
agents: {
defaults: {
model: {
primary: 'bailian/qwen-plus',
},
models: {
'bailian/qwen3.5-plus': {},
'bailian/qwen3-max-2026-01-23': {},
'bailian/qwen3-coder-next': {},
'bailian/qwen3-coder-plus': {},
'bailian/MiniMax-M2.5': {},
'bailian/glm-5': {},
'bailian/glm-4.7': {},
'bailian/kimi-k2.5': {},
},
compaction: {
mode: 'safeguard',
},
maxConcurrent: 4,
subagents: {
maxConcurrent: 8,
},
},
},
commands: {
native: 'auto',
nativeSkills: 'auto',
restart: true,
ownerDisplay: 'raw',
},
gateway: {
mode: 'local',
auth: {
mode: 'token',
token: '__OPENCLAW_REDACTED__',
},
},
}将该模板复制到openclaw dashboard的模型配置页面，替换其中的gateway token、模型的baseUrl、apiKey
接入飞书机器人
安装skills
先安装clawhub
npm i -g clawhub然后安装对应skills
clawhub install find-skills另一种方案是去skills.sh官方安装
npx skills add xxxnpx是直接执行，而npm是安装包管理。具体有哪些skills可用，可去下面网址找
让龙虾变得更好
自动回复配置
在workspace目录下面有很多核心身份文件：当 Agent 启动时，OpenClaw 会扫描工作空间，读取 AGENTS.md 文件。如果文件大小超过 bootstrapMaxChars（默认 20000 字符），会被截断并添加截断标记。然后，文件内容被注入到 System Prompt 的 "Workspace Files" 部分。这种注入式配置的优势在于，Agent 可以在运行时通过 read 工具随时读取和引用这些配置。
AGENTS.md - 代理行为规范
身份定义：明确 Agent 的角色定位，如“你是一个专业的软件工程师助手”。
行为准则：定义 Agent 应该如何与用户交互、如何处理任务。
编码规范：包括代码风格、注释要求、测试规范等技术细节。
安全边界：明确禁止的行为，如不得执行危险命令。
SOUL.md - 价值观与个性
核心价值观：定义 Agent 应该具备的品质，如诚实、友善、专业。
沟通风格：决定了 Agent 是正式还是随意、简洁还是详细、幽默或严肃。
决策原则：指导 Agent 面对模糊需求时的处理策略。
边界意识：明确了什么该做、什么不该做的人格化表达。
IDENTITY.md - 身份档案，与SOUL.md相比，更侧重身份信息，例如你的身份证，而SOUL.md则更像你的性格测试报告
基本信息：Agent 的名称、版本、创建时间等元数据。
形象描述：视觉形象的文字描述，用于多模态交互场景。
声音特征：定义语音交互时的音色、语速等参数。
签名语：Agent 的标志性问候语或结束语，增加了品牌识别度。
USER.md - 用户画像
基本信息：用户名称、联系方式、时区等。
技术背景：记录了用户的编程语言偏好、技术栈熟悉度。
交互偏好：定义了用户喜欢的沟通方式、回复详细程度。
隐私设置：包括数据存储偏好、敏感信息处理规则。
例如希望大模型能够对每个工作实时、流式反馈，而不是说一句回一句，则在SOUL.md中增加沟通风格，做对应设定
浏览器配置
下载goole-chorme
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb安装chrome
sudo apt install ./google-chrome-stable_current_amd64.deb执行openclaw命令：
openclaw config set browser.defaultProfile "openclaw"
openclaw config set browser.headless true # 无ui启动
openclaw config set browser.noSandbox true # 不使用沙箱启动，防止root
openclaw config set browser.executablePath "/usr/bin/google-chrome" # 设置浏览器命令的路径
评论区