# OpenClaw Deploy On Debian Linux
## 始める
\
最近的`OpenClaw`可谓是沸沸扬扬, 本质上这只是一个工具,却被各种商业/媒体非理性炒作,
## 試験環境:
[Lightsail ](https://lightsail.aws.amazon.com/ls/webapp/home)+[Amazon Bedrock](https://ap-northeast-1.console.aws.amazon.com/bedrock/home?region=ap-northeast-1)+Litellm+OpenClaw+Telegram\_Bot
在这里我用`Amazon`的[Lightsail ](https://lightsail.aws.amazon.com/ls/webapp/home)配合litellm+awscliv2(通过[Amazon Bedrock](https://ap-northeast-1.console.aws.amazon.com/bedrock/home?region=ap-northeast-1))让所谓的这只蝦運作起來。
機器配置我採用 `Lighsail`最小配置,512M雙棧網路.原則上`Amazon`的光帆是不允許長時間過高負載的,這讓我回憶起如果你用Lighsail進行iper3測速你可能會面臨boom的停機斷開ssh的事故,而再次恢復可要去web的portal自行reboot了.
## 紹介: 必要な環境前に
\
言歸正傳,我是用的是向來順手的`Debian12 Linux`（ummm,lighsail沒提供Debian13,我也懶得upgrade了）主要是Debian13相比Debian12有部分軟件包不再可以尋找到,以及配置文件的路徑進行變更,
由於512M的內存在我們進行第一步,`npm build package`就給咱們內存不夠,安裝停止了
```
curl -fsSL https://openclaw.ai/install.sh | bash
```
所以我們先不要著急執行它的安裝腳本,我們先吧內存和API在本地跑起來
### Swap
先臨時給2G RAM
```
root@ip-172-26-9-118:~# fallocate -l 2G /swapfile
root@ip-172-26-9-118:~# chmod 600 /swapfile
root@ip-172-26-9-118:~# mkswap /swapfile
```
由於我們使用`Amazon Bedrock`.所以我們還要順手install下`pip`
```
apt install python3-pip -y
```
### Litellm
緊接著我們安裝`litellm`
```
pip install litellm --break-system-packages
```
我這種這種在root用戶下安裝包在下很不推薦,
### AWS IAM
由於我們使用`Amazon Bedrock`我們需要提前在我們的AWS控制台IAM-users-建立人員 隨便起個名字,密碼保存下 建議下載csv. 但是這裡的帳戶密碼並不是我們要用的，建立完成後， 讓我們 `新增許可`
```
AmazonBedrockLimitedAccess
AmazonBedrockMarketplaceAccess
```
點擊存取密鑰,創建存取密鑰，務必下載`csv文件`，這裡的ID\_Key和密鑰才是我們接下來配置存取`Amazon Bedrock`關鍵,順帶一提,令和7年註冊的AWS帳戶開通`Amazon Bedrock`需要手動填寫工單向客戶說明提高配額，否則極大概率無法使用AWS提供的`Amazon Bedrock`服務,更無法調取各種模型.
### Config awscli
讓我們繼續，由於Debian12這裡發行版的版本較長遠
```
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o awscliv2.zip
unzip awscliv2.zip
./aws/install
```
```
root@debian:~# aws --version
aws-cli/2.34.7 Python/3.13.11 Linux/6.1.0-43-cloud-amd64 exe/x86_64.debian.12
root@debian:~#
```
確保使用最新的版本 我們可以強制通過path來指定調用新的工具包
```
vim ~/.bashrc
export PATH="/usr/local/aws-cli/v2/current/bin:$PATH"
source ~/.bashrc
```
至此我們配置`aws configure`
```
aws configure
```
example:
```
aws_access_key_id = AKIXXXXXXXXXX
aws_secret_access_key = XXXXXXXXX
Default region name [None]: ap-northeast-1
Default output format [None]: json
```
如果這一步沒有問題,我們便可以通過
```
aws bedrock list-foundation-models --region ap-northeast-1
```
### litellm config
查看到aws的`bedrock models list`
我們在我們的root路徑下
```
vim config.yaml
```
我這裡使用的的是sonnet和haiku
```
root@Debian:~# cat config.yaml
model_list:
- model_name: sonnet
litellm_params:
model: bedrock/jp.anthropic.claude-sonnet-4-5-20250929-v1:0
- model_name: haiku
litellm_params:
model: bedrock/anthropic.claude-3-haiku-20240307-v1:0
router_settings:
routing_strategy: simple-shuffle
fallbacks:
- sonnet:
- haiku
root@Debian:~#
```
讓litellm通過配置在本地開啟一個API
```
litellm --config /root/config.yaml
```
順利的話你就可以看到
```
INFO: Application startup complete.
INFO: Uvicorn running on http://0.0.0.0:4000 (Press CTRL+C to quit)
```
順利的運作起來了.我們新開一個shell
```
curl http://127.0.0.1:4000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model":"sonnet",
"messages":[
{"role":"user","content":"hello"}
]
}'
```
鍵入如下便可以看到順利運作的API返回的信息
❕warning
我在對接telegram bot這一步遇到了nodejs的內存不夠報錯,所提起把環境變量調整一下
```
export NODE_OPTIONS="--max-old-space-size=1024"
```
### Openclaw install
至此我們進入配置Openclaw的第一步,
```
curl -fsSL https://openclaw.ai/install.sh | bash
```
當我們執行完這裡之後等待它啟動我們首先yes確認知曉這是一個實驗項目,
如您完成openclaw的安裝但是第一次的部署是失敗的不要擔心,您可以使用以下任意初始化命令從頭我們的配置
```
openclaw onboard
```
```
openclaw config set agents.defaults.model sonnet
```
```
◇ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│ Yes
│
◇ Onboarding mode
│ QuickStart
◇ Config handling
│ Reset
◇ Reset scope
│ Full reset (config + creds + sessions + workspace)
Failed to move to Trash (manual delete): ~/.openclaw/openclaw.json
Failed to move to Trash (manual delete): ~/.openclaw/agents/main/sessions
│
```
這裡對接我們自己的本地API以及調用模型名稱sonnet 順帶一提我們並未向litellm設定key因此如您遇到要求填寫key的情況下您可以任意填寫字符進行下一步
```
◇ Model/auth provider
│ LiteLLM
│
◇ Model configured ─────────────────────────────╮
│ │
│ Default model set to litellm/claude-opus-4-6 │
│ │
├────────────────────────────────────────────────╯
│
◇ Default model
│ Enter model manually
│
◇ Default model
│ sonnet
```
按照順序配置好必要的AI（如果在這裡失敗的話也不要著急） 以及channel 我選擇了telegrambot,如果不知道如何創建bot的話自行Google,
我這裡選擇的是pairing,這樣可以確保只需要邀請加入.
讓我頭大的還是
### gateway running
```
openclaw gateway run
```
啟動網關
頻繁報錯提示網關未安裝,其實網關是早就部署好了的,
我只能通過`bg`這樣的命令放入後台.
## 終
### Commands
```
openclaw config set model.baseURL http://127.0.0.1:4000/v1
#指向本地API端口
openclaw doctor --fix
#check openclaw debug
```
```
1. 检查端口是否被占用：lsof -i :18789
2. 查看错误日志：openclaw logs --follow
3. 运行诊断：openclaw doctor
```
### Document
關於更多還清查看官方文檔, 還清查看官方文檔, [openclaw.ai](https://docs.openclaw.ai/)
限制網路環境下參考部署[文檔](https://www.eet-china.com/mp/a479272.html)
[文檔](https://note.com/zephel01/n/n030ff0b67081)
最後的最後請務必為port `18789` 做好防火牆,或者轉移其他port
最後は、ここで読んだ人は、誠にありがとうございます。 以上です。
\
音楽:
---
{% embed url="" %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://blog.jsmsr.com/blog/openclaw-deploy-on-debian-linux.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.