OpenClaw 如何賦予龍蝦聲音學會說話 - 使用馬娘聲優範例

OpenClaw 其實內建就有 tts 工具，可以自動發氣泡語音到 discord 的聊天室中

音源選擇

選用的聲音是來自這個開源的庫，雖然已經封存但東西還能用
Plachtaa/VITS-fast-fine-tuning

作者有上傳一份在 huggingface 上，目前還能用只是免費版本速度慢
Multilingual Anime TTS - a Hugging Face Space by Plachta

能用就足夠了，算力太慢再自己部署到自己的機器上
可以上去挑自己喜歡的聲音，或是貼給龍蝦讓他自己選一個
唯一要注意的是免費算力有單次150字的限制，一次呼叫不能高於這個

安裝 VITS 到機器

首先需要你連到機器本身，遠端連入或是你本身就跑在自己的電腦上都可以，文中以 ubuntu 為範例，使用者名稱是 ubuntu。

選好聲音之後我們先裝一個 python 虛擬環境給當前使用者 ubuntu 使用

# 1. 建立 venv（用系統 python3，3.10 以上）
python3 -m venv ~/venv

# 2. 裝 gradio_client（用 venv 內的 pip，不需要 activate）
~/venv/bin/pip install --upgrade pip
~/venv/bin/pip install gradio_client

# 驗證
~/venv/bin/python3 -c "import gradio_client; print(gradio_client.__version__)"

然後需要安裝 ffmpeg 用來產生氣泡用的

sudo apt install -y ffmpeg

然後下載 claw-voice/cli.py 放到以下位置

mkdir -p ~/.openclaw/workspace/scripts/claw-voice
wget -O ~/.openclaw/workspace/scripts/claw-voice/cli.py bit.ly/claw-voice-tool

Script 中最上方人物的設定與語言設定記得改成自己要的

載好可以先測試一下有沒有語音產生

~/venv/bin/python3 ~/.openclaw/workspace/scripts/claw-voice/cli.py "こんにちは" /tmp/claw-voice-test.wav

就可以聽到 ai 產出來的語音了
再來要把他安裝到龍蝦上，繼續下一步吧

安裝到龍蝦

接著繼續，腳本身自帶產生設定檔的功能我們先產一下設定檔

~/venv/bin/python3 ~/.openclaw/workspace/scripts/claw-voice/cli.py install

會在腳本旁邊產出一個 tts-config.json5 的設定檔，然後接著安裝到龍裝

openclaw config patch --file ~/.openclaw/workspace/scripts/claw-voice/tts-config.json5

失敗時自動中止、不會修改 openclaw 主 config

改好設定檔之後重啟一下龍蝦

openclaw gateway restart

在 DC 中使用 tts 產生聲音

在 discord 中可以使用斜線召喚命令，不過由於 tts 是 dc 內建的保留字，所以打斜線不會出現這個命令，但是送出還是可以用的。

/tts audio ご主人様、まだ眠いでござる……朝……？

他就會回覆一個氣泡語音回來了

在 dc 中其實龍蝦把 voice 這個關鍵字讓位給 tts 了
也就是在 dc 中輸入 /voice 或 /tts 等於在 telegram 輸入 /tts 的意思
而 voice 原本是語音通話的意思，在 dc 中輸入 /talk-voice 等於在 tg 輸入 /voice
但是有 bug 在 dc 使用 voice 會跑去呼叫 talk-voice 所以用不了就乖乖用 tts 吧

自動語音回覆

cli.py 產生的 tts-config.json5 內含兩個影響「AI 何時自動以語音回覆」的設定

設定	值	說明
messages.tts.auto	tagged	觸發時機。off：永不自動 / always：每個回覆都 TTS / inbound：使用者用語音傳訊時才 TTS / tagged：模型在回覆中明確標註要 TTS 時才合成
messages.tts.modelOverrides.enabled	true	是否允許模型 per-response 控制 TTS。關閉後模型無法主動觸發語音

兩者合起來 = AI 有權限使用氣泡語音發送給你

這是為了以下兩個功能

1. 聊天時讓龍蝦回覆氣泡語音
2. 在 corn 中使用提示詞發氣泡語音

但是缺點就是佔用了關鍵字 [[tts:text]]這裡會自動轉成語音[[/tts:text]] 導致龍蝦如果發送給你的聊天中包含這個規則會自動轉換。(被 code block 包覆則例外)

但是這出現概率應該不高自己記得有這回事就好，可以放心打開。

在 Linux/Win 上用 Shell/powershell 函式自動更新 DuckDNS

在主機上自動更新 DuckDNS

前言

DuckDNS 是免費的 DDNS 服務，適合家用伺服器或 Raspberry Pi 等動態 IP 環境。本文介紹如何在 ~/.profile 中建立一個 Shell 函式，隨時手動執行更新，也可搭配 cron 排程自動執行。

前置作業

1. 前往 duckdns.org 註冊並登入
2. 建立一個子網域（例如 my-host）
3. 在頁面上方複製你的 token

Linux設定函式

編輯 ~/.profile，加入以下函式：

duckdns() {
    local result
    local domain="my-host"
    local token="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    result=$(echo url="https://www.duckdns.org/update?domains=${domain}&token=${token}&ip=&verbose=true" | curl -s -k -K -)
    local status=$(echo "$result" | head -1)
    local ip=$(echo "$result" | sed -n '2p')
    if [ "$status" = "OK" ]; then
        echo -e "\033[1;32m[OK] ${domain}.duckdns.org → ${ip}\033[0m"
    else
        echo -e "\033[1;31m[FAILED] ${domain}.duckdns.org update failed\033[0m"
        return 1
    fi
}

將 domain 和 token 替換成你自己的值。

使用方式

# 載入設定（僅首次需要，新開終端機會自動載入）
source ~/.profile

# 執行更新
duckdns

成功會顯示：

[OK] my-host.duckdns.org → 123.45.67.89

搭配 cron 自動排程

如果希望每 5 分鐘自動更新，執行 crontab -e 加入：

*/5 * * * * . $HOME/.profile; duckdns > /dev/null 2>&1

運作原理

• 使用 DuckDNS API 的 verbose=true 參數，回傳更新狀態與實際註冊的 IP
• 不帶 ip= 參數時，DuckDNS 會自動偵測請求來源 IP
• 函式會驗證 API 回傳狀態，成功顯示綠色，失敗顯示紅色

Windows開機自動更新DDNS

在PowerShell中執行以下的函式註冊工作排程

先載入函式

function Register-DuckDNS {
    param(
        [Parameter(Mandatory)][string]$Domain,
        [Parameter(Mandatory)][string]$Token,
        [int]$Interval
    )
    Get-ScheduledTask -TaskName "DuckDNS_9615e983" -ErrorAction SilentlyContinue |
        Unregister-ScheduledTask -Confirm:$false
    $url      = "https://www.duckdns.org/update?domains=$Domain&token=$Token"
    $action   = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "-NoProfile -Command `"Invoke-RestMethod '$url'`""
    $triggers = @(New-ScheduledTaskTrigger -AtStartup)
    if ($Interval) {
        $triggers += New-ScheduledTaskTrigger -Once -At (Get-Date) -RepetitionInterval (New-TimeSpan -Minutes $Interval) -RepetitionDuration (New-TimeSpan -Days 9999)
    }
    $settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
    Register-ScheduledTask -TaskName "DuckDNS_9615e983" -Action $action -Trigger $triggers -Settings $settings -User "SYSTEM" -RunLevel Highest
}

或是從gist上抓取

irm https://gist.githubusercontent.com/hunandy14/c7fa21d0e2ad88a7443e9aef3010f89c/raw/Register-DuckDNS.ps1 | iex

然後註冊工作排程

Register-DuckDNS -Domain "duck-dns-domain" -Token "duck-dns-token"

重開機就會自動更新IP了

如果需要每5分鐘同步一次就添加 -Interval 5 進去
執行後會追加一個名稱固定不變的 DuckDNS_9615e983 排程
重複執行 Register-DuckDNS 會覆蓋同一個排程

(如果要多個排程自己從函式改名稱吧，刻意寫死是怕重複執行跑出一堆幽靈排程)

刪除排程

Unregister-ScheduledTask -TaskName "DuckDNS_9615e983" -Confirm:$false

Pnp.PowerShell 如何從IDCRL改用OAuth 2.0憑證登入

記得先更新pnp到最新版本: CHG: Pnp.PowerShell 如何安裝 與 基本用法
以及參考上一篇文章創建應用程式: CHG: 2024-09-09 SharePoint 禁用帳密登入改動 如何使用Application應用程式登入

2026-05-01 即將停用委託登入了，再來強迫必須用證書登入了，在舊文章裡有說如何直接註冊應用程式+創建證書，這邊單獨講在現有的應用程式裡添加證書

生成證書

這是生成證書的指令 (再次提醒 pnp 要更新到最新版本)

$params = @{
    CommonName          = "PnP_Rocks"
    ValidYears          = 10
    OutPfx              = "./secrets/PnP_Rocks.pfx"
    OutCert             = "./secrets/PnP_Rocks.cer"
    CertificatePassword = "<YourPassword>" | ConvertTo-SecureString -AsPlainText -Force
}; New-PnPAzureCertificate @params

CertificatePassword 是可選項可以不設就空白密碼，要設記得改成自己的密碼

生成之後把 PnP_Rocks.cer 上傳到應用程式上就可以用了

連接測試

連接方式有幾種這個是從檔案直接連(以檔案方式儲存比較不安全)

$params = @{
    Url                 = "https://<tenant>.sharepoint.com/sites/<SiteName>"
    ClientId            = "<YourClientId>"
    Tenant              = "<tenant>.onmicrosoft.com"
    CertificatePath     = "./secrets/PnP_Rocks.pfx"
    CertificatePassword = ConvertTo-SecureString "<YourCertPassword>" -AsPlainText -Force
}; Connect-PnPOnline @params 

這個是加到信任區之後用指紋連接 (這才是真正安全的方式)

$params = @{
    Url        = "https://<tenant>.sharepoint.com/sites/<SiteName>"
    ClientId   = "<YourClientId>"
    Tenant     = "<tenant>.onmicrosoft.com"
    Thumbprint = "<YourCertThumbprint>"
}; Connect-PnPOnline @params 

目前還沒設權限登入啥都不能做只是先測試能登再說，下一步設完權限就可以動了

權限設置

關於權限限縮的問題用 Sites.Selected 可以限制僅能單一網站，下面是範例。

先到應用程式中新增該權限，讓 pnp.powershell 可以指定權限
(目前只能用 pnp.powershell 設置，網頁上無法設置)

用管理員帳號 DeviceLogin 登入

$param = @{
    Url      = "https://<tenant>.sharepoint.com/sites/<SiteName>"
    ClientId = "<YourClientId>"
}; Connect-PnPOnline @param -Interactive

授權 App 存取指定網站 (這跟上面是一組的要設別的網站得在登一次)

$param = @{
    AppId       = "<YourClientId>"
    DisplayName = "<AppName>"
    Site        = "https://<tenant>.sharepoint.com/sites/<SiteName>"
    Permissions = "FullControl" # Read | Write | Manage | FullControl
}; Grant-PnPAzureADAppSitePermission @paramg

設好之後就可以開始操作了，這樣就可以應付 5/1 的改版了

[番外] 將憑證加入Windows憑證商店

加入當前使用者的"個人"中

$params = @{
    FilePath          = "./secrets/PnP_Rocks.pfx"
    CertStoreLocation = "Cert:\CurrentUser\My"
    Password = ConvertTo-SecureString "<YourCertPassword>" -AsPlainText -Force
}; Import-PfxCertificate @params

加入本機的"個人"中

$param = @{
    FilePath          = "./secrets/PnP_Rocks.pfx"
    CertStoreLocation = "Cert:\LocalMachine\My"
    Password = ConvertTo-SecureString "<YourCertPassword>" -AsPlainText -Force
}; Import-PfxCertificate @param

匯入後會自動顯示指紋，要直接看指紋的話是這個指令

$param = @{
    TypeName = "Security.Cryptography.X509Certificates.X509Certificate2"
    ArgumentList = @(
        "./secrets/PnP_Rocks.pfx",
        (ConvertTo-SecureString "<YourCertPassword>" -AsPlainText -Force)
    )
}; (New-Object @param)

WinSCP 如何以 sudo 權限登入複製 root 權限的檔案

首先要先確保可以無密碼使用 sudo 由於無法保存密碼，這個沒有任何替代方案是最後的妥協了，然後再到 WinSCP 中設置 SFTP 伺服器用 sudo su -c 執行 sftp-server 即可。

Step1: 設置免密碼 sudo 指令

輸入以下命令打開編輯器

sudo visudo

在檔案最後加入一行

<你的使用者4名稱> ALL=(ALL) NOPASSWD: ALL

然後存檔即可。重新登入後 sudo 就不需要密碼了

Step2: 設置 WinSCP 用 sudo 登入

搜尋 sftp-server 位置

find /usr -name "sftp-server" -type f

在 wsl 中位置是 /usr/lib/openssh/sftp-server 。

在 WinSCP 站臺進階設定 > SFTP 的頁面中，找到 SFTP 伺服器這一欄

貼上以下命令 (後方路徑自行修改成剛剛查到的位置)

sudo su -c /usr/lib/openssh/sftp-server

然後確定後登入就是有 root 權限的 WinSCP 了

SSH 連線時自訂 PS1 提示符 (Ubuntu為例)

SSH 連線時自訂 PS1 提示符 (Ubuntu為例)

以 Ubuntu 預設彩色提示符為例

方式一：臨時一次性使用（連線後手動執行）

連線進去後，直接在終端機貼上執行：

export PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '

說明：

• 只對當前 session 有效，登出後就消失
• 不需要任何設定檔修改
• 適合臨時想換個提示符樣式試試看

方式二：修改遠端伺服器設定

在遠端伺服器的 ~/.bashrc 加入：

PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '

優點：

• 不影響 scp/rsync 等檔案傳輸功能
• 所有連線方式都自動套用
• 不用記複雜的命令
• 最簡單、最推薦的做法

方式三：連線時指定命令（命令列參數）

每次連線時加上參數：

Window PowerShell

ssh myserver -t "export PS1='`${debian_chroot:+(`$debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\`$ '; exec bash"

Cmd / Window Terminal 設定檔命令

ssh myserver -t "bash --rcfile <(printf 'PS1=\"\\[\\e[32m\\]\\u@\\h\\[\\e[0m\\]:\\[\\e[34m\\]\\w\\[\\e[0m\\]\\$ \"')"

說明：

• -t — 等同於 RequestTTY yes，強制分配 TTY
• 單引號包住整個命令，避免本地 shell 先展開變數
• 適合偶爾需要或寫成別名使用

方式四：寫在 SSH Config 中（本地端設定）

在本地的 ~/.ssh/config 中設定：

Host myserver
    HostName example.com
    User ubuntu
    RequestTTY yes
    RemoteCommand bash -c 'export PS1="${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ "; exec bash'

說明：

• RequestTTY yes — 強制分配終端，否則 RemoteCommand 無法正常互動
• RemoteCommand — 連線後自動執行的命令，用 exec bash 確保留在互動式 shell
• 連線方式：直接 ssh myserver

注意事項：

• 使用 RemoteCommand 後，scp、rsync 等檔案傳輸會失效（因為它會執行指定命令而非預設 shell）
• 如果需要傳檔案，要另外建一個不帶 RemoteCommand 的 Host 設定

補充：PS1 提示符格式說明

對照格式

\[\033[01;32m\]  → 亮綠色開始
\u              → 使用者名稱
@               → @ 符號
\h              → 主機名稱
\[\033[00m\]    → 重設顏色
:               → : 符號
\[\033[01;34m\] → 亮藍色開始
\w              → 當前完整路徑
\[\033[00m\]    → 重設顏色
\$              → 一般用戶顯示 $，root 顯示 #

自動初始化 Git 倉庫一個空 README.md 當作起點的腳本

這不是必要的，只是我通常習慣第一點用空 README.md 來當作起始，寫個腳本之後要複製比較容易

# 自動初始化Git倉庫腳本
function Initialize-GitRepository {
    [CmdletBinding()]
    [Alias("igr")]
    param(
        [Parameter(Position = 0)]
        [string]$Path = ".",

        [Parameter()]
        [string]$ReadmeFileName = "README.md",

        [Parameter()]
        [string]$CommitMessage = "Init"
    )

    # 啟用嚴格模式
    Set-StrictMode -Version Latest
    $ErrorActionPreference = 'Stop'

    # 切換到指定目錄
    $originalLocation = Get-Location
    Set-Location $Path

    # Git 包裝函式 - 自動檢查錯誤並拋出例外
    function git {
        & (Get-Command git.exe -CommandType Application) @args
        if ($LASTEXITCODE -ne 0) {
            Write-Error "Git command failed: git $($args -join ' ') (exit code: $LASTEXITCODE)"
        }
    }

    try {
        # ==================== 預檢查階段 ====================
        # 檢查 README 檔案是否已存在
        if (Test-Path $ReadmeFileName) {
            Write-Error "Error: $ReadmeFileName file already exists!"
        }
        # 檢查 Git 倉庫是否已存在
        if (Test-Path ".git") {
            Write-Error "Error: Git repository already exists!"
        }
        # 檢查 Git 命令是否可用
        try {
            git --version | Out-Null
        } catch {
            Write-Error "Error: Git is not installed or not in PATH!"
        }

        # ==================== 執行階段 ====================
        # 創建 README 檔案
        New-Item -Name $ReadmeFileName -ItemType File | Out-Null
        # 初始化Git倉庫
        git init
        # 添加檔案並提交
        git add $ReadmeFileName
        # 提交
        git commit -m $CommitMessage

    } catch {
        throw
    } finally {
        Set-Location $originalLocation
    }
}

PowerShell 產生隨機密碼

經常用到每次都要查有點煩了，乾脆弄個函式寫到系統中，呼叫的時候比較方便

在 PowerShell 中輸入 $PROFILE 會顯示出每次 PowerShell 載入時讀取的腳本，可以把以下函式寫到裡面去，這樣打開 PowerShell 只要輸入 nrp 就可以產出密碼了

(第一次創建的時候需要設定權限不然會錯，那個複製錯誤信息Google或問AI就可以解了)

以下是產密碼的函式

# Generate a random password
function New-RandomPassword {
    [Alias('nrp')]
    param (
        [Parameter(Position = 0)]
        [ValidateRange(1, 512)]
        [int]$Length = 15,
        [switch]$Symbols,
        [switch]$Ambiguous,
        [string]$IncludeCharacters,
        [string]$ExcludeCharacters
    ) $chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
    if (-not $Ambiguous) { $chars = $chars -replace '[lIO01]', '' }
    if ($Symbols) { $chars += '!@#$%^&*()-_=+' }
    if ($IncludeCharacters) { $chars += $IncludeCharacters }
    if ($ExcludeCharacters) { $chars = -join $chars.ToCharArray().Where{ $ExcludeCharacters.IndexOf($_) -lt 0 } }
    if ($chars.Length -eq 0) { Write-Error "Character set is empty after exclusions"; return }
    $rng = [Security.Cryptography.RandomNumberGenerator]::Create()
    try {
        $rng.GetBytes(($bytes = [byte[]]::new($Length * 8)))
        -join (0..($Length - 1)).ForEach({ $chars[[BitConverter]::ToUInt64($bytes, $_ * 8) % $chars.Length] })
    } finally { $rng.Dispose() }
} # New-RandomPassword

預設使用 New-RandomPassword 或是 ‘nrp’ 會產出 15 碼的隨機密碼 (預設不包含易造成混亂的 lIO01 字元)

如果需要複雜包含符號，可以使用 -Symbols 與 -Ambiguous 參數
要定義字元可以使用 -IncludeCharacters -ExcludeCharacters 參數
顯式指定與 Symbols / Ambiguous 有衝突時顯式優先級更高