VRChat中文输入：剪贴板、SteamVR桌面与OSC Chatbox

在 VRChat 里打不出中文，是很多中文玩家进游戏后遇到的第一个问题：桌面模式下聊天框调不出输入法候选，VR 模式下虚拟键盘只有英文，想跟朋友说句话只能靠表情和肢体动作。这个问题不是 VRChat 不支持中文，而是它内置的输入框基于 Unity UI 实现，跟 Windows 输入法的候选窗口配合得并不好，不同版本、不同输入法、全屏还是窗口模式，表现都可能不一样。所以与其去赌输入法能不能弹出来，不如换一条更稳的路：把中文从外部送进去。

这篇文章给三个方案，按上手难度从低到高排：桌面端剪贴板粘贴、SteamVR 桌面视图配合系统输入法、以及用 OSC 协议把中文写进 VRChat 头顶 Chatbox。第三个方案会给出完整的 Python 脚本、HTTP 接口封装和批量发送思路，适合想长期用、想接到自己工具里的读者。所有代码都可以直接复制运行，端口和路径按自己的环境改。如果你只是偶尔说一句中文，看完第 4 节就够了；如果你想让中文输入变成日常工作流，直接从第 6 节开始看。

需要先说明一点：本文不涉及任何客户端修改、注入或绕过平台限制的做法。VRChat 的服务条款对修改客户端有明确限制，用 Mod 改输入相关逻辑存在账号风险，所以下面所有方案都走官方开放的能力，包括剪贴板、系统输入和官方 OSC 接口。

1. 核心能力速览

先把三个方案的边界摆清楚，方便你对号入座。下表中的参数来自 VRChat 官方对 OSC 的公开说明和通用桌面操作习惯，具体表现以你当前使用的 VRChat 版本为准。

方案三里最关键的几个事实需要提前讲清楚，避免后面踩坑：

• VRChat 的 OSC 服务默认使用 UDP，发送端口 9000，接收端口 9001，也可以在启动时用--osc=发送端口:接收端口自定义。
• 写入头顶气泡的地址是/chatbox/input，参数依次是文本字符串、是否立即显示、是否触发提示。
• 文本有字符上限，官方文档给出的数值是 144 个字符，超过部分不会显示，所以长句必须自己分段。
• 头顶气泡是给附近玩家看的，不是你私聊某个人，公共世界里高频刷屏会影响别人，也可能触发平台的风控。

把这几条记住，后面的代码和排查就都好理解了。

2. 适用场景与使用边界

先说适合谁。第一类是刚进 VRChat 的中文玩家，英语不熟，想在公共世界做个简单自我介绍，或者跟同胞打个招呼，用剪贴板方案三十秒就能解决。第二类是长期在固定社群、固定世界活动的玩家，每天都要说类似的话，比如“欢迎来到本世界”“请勿打扰”，这种就适合用脚本把常用话术做成快捷键。第三类是做直播或者做内容的人，需要把弹幕、提示、互动文案实时推到头顶气泡上，那就直接上 OSC 加 HTTP 接口。

再说清楚不适合什么。VRChat 的头顶气泡不是弹幕系统，它是展示在你自己角色头上的文本，附近玩家在近距离才能看到，你不能拿它当广播用。公共世界里有大量不特定的玩家，包括未成年人，所以内容必须干净，不能发广告、不能发引流信息、不能发任何违规内容。高频发送同样不可取，一方面是影响他人体验，另一方面平台对异常行为有监测，账号安全比什么都重要。

还有几个边界要说明白。第一，不要用修改客户端的方式去“修复”中文输入，包括各种注入式插件、替换 UI 的 Mod，这类做法违反服务条款，被封了没有申诉空间。第二，OSC 走的是本机 UDP，默认只监听 127.0.0.1 就够了，如果你把接口暴露到局域网甚至公网，一定要加鉴权，否则同一个网络里的人可以往你头顶推任意文本。第三，脚本里不要硬编码别人的昵称、聊天记录或者任何个人信息，日志文件也要定期清理。第四，如果你打算把语音、录音、虚拟形象相关的能力也串进来，务必确认素材授权，涉及他人肖像和声音的场景必须先拿到明确许可。

最后提醒一句：本文的所有操作都在你自己的账号和本机上完成，测试建议先在单人世界或者好友房间做，确认没问题再去公共世界。

3. 环境准备与前置检查

方案一和方案二几乎不需要额外环境，方案三需要一点准备。下面按通用流程列一遍，具体版本号以你本机的实际情况为准，不要照抄版本号去装。

操作系统方面，VRChat 的 PC 版跑在 Windows 上，OSC 方案在 Windows 10 和 Windows 11 上都可以，Linux 通过 Proton 运行的情况不在本文讨论范围。Python 建议用 3.9 以上的版本，装完确认python --version能正常输出。依赖只有一个，就是 python-osc，用来构造和发送 OSC 消息。

磁盘和内存方面，这个脚本本身占用极小，不用为它单独预留空间。真正吃资源的是 VRChat 本体，如果你还要同时开直播推流、开浏览器、开语音软件，就要给系统留出余量，避免因为内存紧张导致游戏卡顿。网络方面，OSC 走的是本机回环，不需要外网，也不需要任何额外的网络工具。

动手之前，先做四项检查：

1. 确认 VRChat 能在桌面模式下正常启动，并且你能打开聊天面板。
2. 确认 SteamVR 或者你的 VR 运行环境正常，头显能正常追踪。
3. 确认本机 9000 和 9001 端口没有被其他 OSC 工具占用。
4. 确认你用的是自己有权使用的账号，测试内容不涉及他人隐私。

端口检查可以用系统自带的命令完成，Windows 下打开 PowerShell：

# 查看 9000 和 9001 端口是否被占用 netstat -ano | Select-String ":9000|:9001"

如果输出里有其他进程占着这两个端口，要么关掉那个进程，要么在启动 VRChat 时换一组端口，具体在下一节讲。

4. 方案一：桌面端剪贴板粘贴

这是最快的一条路，适合桌面模式下的临时沟通。核心思路是绕开 VRChat 内置输入框对输入法的依赖：先在记事本、浏览器地址栏或者任何能正常输入中文的地方把话打完，复制，再切回 VRChat 粘贴。

操作步骤很直接：

1. 用Win + R打开运行框，输入notepad回车，开一个记事本当临时输入区。
2. 在记事本里用你习惯的输入法打中文，打完按Ctrl + A全选，再按Ctrl + C复制。
3. 切回 VRChat，按回车打开聊天输入框，按Ctrl + V粘贴。
4. 确认文本显示正常后按回车发送。

判断成功的标准很简单：聊天框里出现的是完整的中文，而不是问号、方块或者空白。如果粘贴进去是一串乱码，多半是输入框对非 ASCII 字符的处理有问题，换一段短文本再试一次；如果粘贴完全没反应，说明当前版本的输入框不接受剪贴板，直接跳到方案三。

这个方案有个明显短板：每次都要切窗口，VR 模式下更麻烦，因为你还得摘头显或者开桌面视图。所以它适合“偶尔说一句”，不适合连续对话。另外要注意，剪贴板里如果留着敏感内容，粘贴时容易误发，养成发完就清空剪贴板的习惯，用Win + V打开剪贴板历史也能快速清理。

5. 方案二：SteamVR 桌面视图配合系统输入法

VR 模式下没法直接敲键盘，但 SteamVR 提供了桌面视图，可以把 Windows 桌面投到头显里，配合系统自带的触摸键盘，就能在 VR 里输入中文。

操作流程如下：

1. 进入 VR 后，按手柄上的系统菜单键呼出 SteamVR 面板。
2. 在面板底部找到桌面按钮，把桌面视图调出来，固定在手腕或者场景里方便看的位置。
3. 在桌面视图里点开任务栏的触摸键盘图标，或者用Win + Ctrl + O打开屏幕键盘。
4. 用触摸键盘上的拼音输入法打字，把中文写进记事本。
5. 复制之后切回 VRChat 粘贴，或者直接用桌面视图操作 VRChat 的聊天框。

这套流程的关键在于触摸键盘是否支持中文。Windows 自带的触摸键盘在系统语言包含中文时是可以切到中文拼音的，但候选词条的点击在 VR 里比较费劲，手指追踪精度不够的话容易点错。一个折中的做法是把常用短语提前存在记事本里，用的时候直接复制，减少实时打字。

判断成功的标准是：桌面视图里能看到完整的中文候选，复制粘贴到 VRChat 后显示正常。如果桌面视图模糊到看不清字，检查 SteamVR 的桌面视图分辨率设置；如果触摸键盘打不出中文，检查系统里是否装了中文语言包和中文输入法。

这个方案比方案一稳，但依然属于手动操作，不适合高频使用。真正想把中文输入变成自动化流程，还是得看下一节的 OSC 方案。

6. 方案三：用 OSC 把中文写进头顶 Chatbox

这是本文的重点。VRChat 官方开放了 OSC 接口，允许外部程序通过 UDP 向游戏发送消息，其中/chatbox/input就是写头顶气泡的入口。我们只需要写一个小脚本，把中文文本按格式打包发过去，就能绕开输入框，直接把中文显示在自己头上。

6.1 打开 VRChat 的 OSC 服务

有两种方式，任选其一。

第一种是在游戏内开启：进入 VRChat 后打开 Action Menu，依次进入 Options，找到 OSC 相关开关并启用。不同版本的菜单层级可能略有差异，找不到就在 Options 里翻一遍。

第二种是通过启动参数指定端口。在 Steam 库中右键 VRChat，选择属性，在启动选项里填入：

--osc=9000:9001

这行的含义是：VRChat 在 9000 端口接收外部发来的消息，在 9001 端口向外发送消息。如果你本机 9000 被占用，可以改成别的组合，比如--osc=9100:9101，但脚本里的端口要同步改。

6.2 安装依赖并写第一个发送脚本

先装依赖，建议在虚拟环境里操作，避免污染全局环境：

# 创建并激活虚拟环境（Windows） python -m venv venv venv\Scripts\activate # 安装 OSC 依赖 python -m pip install python-osc

然后写发送脚本。这里用OscMessageBuilder显式指定参数类型，比让库自动推断更稳，因为/chatbox/input的参数是“字符串 + 布尔 + 布尔”，类型推断错了消息会被丢弃。

import argparse import time from pythonosc.osc_message_builder import OscMessageBuilder from pythonosc.udp_client import SimpleUDPClient # 官方文档给出的 Chatbox 字符上限，具体以当前版本为准 MAX_CHARS = 144 def split_text(text: str, limit: int = MAX_CHARS): """按字符上限切分长文本，避免超出部分被丢弃""" return [text[i:i + limit] for i in range(0, len(text), limit)] def build_chatbox_message(text: str, immediate: bool = True, notify: bool = True): """构造 /chatbox/input 消息，参数类型为 s b b""" builder = OscMessageBuilder(address="/chatbox/input") builder.add_arg(text, arg_type="s") builder.add_arg(1 if immediate else 0, arg_type="b") builder.add_arg(1 if notify else 0, arg_type="b") return builder.build() def send_text(client: SimpleUDPClient, text: str, interval: float = 1.2): for chunk in split_text(text): client.send(build_chatbox_message(chunk)) print(f"已发送：{chunk}（{len(chunk)} 字符）") time.sleep(interval) if __name__ == "__main__": parser = argparse.ArgumentParser(description="向 VRChat Chatbox 发送中文") parser.add_argument("text", help="要发送的文本") parser.add_argument("--host", default="127.0.0.1", help="OSC 目标地址") parser.add_argument("--port", type=int, default=9000, help="OSC 目标端口") parser.add_argument("--interval", type=float, default=1.2, help="分段发送间隔秒数") args = parser.parse_args() udp_client = SimpleUDPClient(args.host, args.port) send_text(udp_client, args.text, interval=args.interval)

运行方式：

python chatbox_send.py "大家好，我是刚进来的中文玩家，请多指教"

如果文本超过 144 个字符，脚本会自动切成多段，每段间隔 1.2 秒发送，避免被服务端当成高频请求丢掉。

6.3 验证是否发送成功

先确认 VRChat 已经在运行，并且 OSC 服务已开启。执行上面那条命令后，观察三个地方：

1. 脚本控制台是否打印出“已发送”，以及字符数是否正确。
2. VRChat 里自己角色头顶是否出现气泡文本。
3. 如果身边有好友，问一句能不能看到你头上的字。

成功的话，头顶会出现你发送的中文，几秒到几十秒后自动消失，具体停留时长以当前版本为准。如果脚本打印了但游戏没反应，先回到第 9 节排查端口和开关。

6.4 常用话术的快捷发送

固定话术可以做成命令行参数，或者干脆写一个交互式小工具，输入编号就发送对应句子。下面是一个最小实现，把话术存在字典里：

from pythonosc.osc_message_builder import OscMessageBuilder from pythonosc.udp_client import SimpleUDPClient PHRASES = { "1": "你好，我是中文玩家", "2": "抱歉，我的英文不太好", "3": "这个世界的模型做得真不错", "4": "我先挂机一会儿，稍后回来", } def send(client, text): builder = OscMessageBuilder(address="/chatbox/input") builder.add_arg(text, arg_type="s") builder.add_arg(1, arg_type="b") builder.add_arg(1, arg_type="b") client.send(builder.build()) if __name__ == "__main__": client = SimpleUDPClient("127.0.0.1", 9000) for key, value in PHRASES.items(): print(f"{key}. {value}") choice = input("输入编号发送，q 退出：").strip() while choice != "q": if choice in PHRASES: send(client, PHRASES[choice]) print("已发送") else: print("编号不存在") choice = input("输入编号发送，q 退出：").strip()

这种方式适合放在副屏或者第二台设备上，边玩边点，比切窗口复制粘贴顺手。

7. 接口 API 与批量任务

如果你想让手机、平板或者别的程序也能往头顶推消息，可以把这个脚本包一层 HTTP 接口。用 Flask 起一个本地服务，接收 POST 请求，转发成 OSC 消息。注意这属于自己搭的本地服务，没有任何官方背书，一定要限制监听地址和访问来源。

先装 Flask：

python -m pip install flask

服务端代码：

from flask import Flask, jsonify, request from pythonosc.osc_message_builder import OscMessageBuilder from pythonosc.udp_client import SimpleUDPClient app = Flask(__name__) OSC_HOST = "127.0.0.1" OSC_PORT = 9000 MAX_CHARS = 144 client = SimpleUDPClient(OSC_HOST, OSC_PORT) def push_chatbox(text: str, immediate: bool = True, notify: bool = True): builder = OscMessageBuilder(address="/chatbox/input") builder.add_arg(text[:MAX_CHARS], arg_type="s") builder.add_arg(1 if immediate else 0, arg_type="b") builder.add_arg(1 if notify else 0, arg_type="b") client.send(builder.build()) @app.route("/chatbox", methods=["POST"]) def chatbox(): data = request.get_json(silent=True) or {} text = (data.get("text") or "").strip() if not text: return jsonify({"ok": False, "error": "text 不能为空"}), 400 push_chatbox(text, data.get("immediate", True), data.get("notify", True)) return jsonify({"ok": True, "length": len(text)}) if __name__ == "__main__": # 只监听本机，需要局域网访问时再改成 0.0.0.0，并自行加鉴权 app.run(host="127.0.0.1", port=5000)

调用示例：

curl -X POST http://127.0.0.1:5000/chatbox \ -H "Content-Type: application/json" \ -d "{\"text\":\"大家好，我是中文玩家\",\"notify\":true}"

Python 调用：

import requests resp = requests.post( "http://127.0.0.1:5000/chatbox", json={"text": "这条是从脚本推过来的中文", "notify": True}, timeout=5, ) print(resp.status_code, resp.json())

批量任务就基于这个接口做。准备一个 UTF-8 编码的文本文件，一行一条话术，写一个循环脚本按间隔逐条推送：

import time import requests with open("phrases.txt", encoding="utf-8") as f: lines = [line.strip() for line in f if line.strip()] for line in lines: try: resp = requests.post( "http://127.0.0.1:5000/chatbox", json={"text": line}, timeout=5, ) print(resp.status_code, line) except requests.RequestException as exc: # 单条失败不影响后续，记录后继续 print("发送失败：", line, exc) time.sleep(2)

批量任务有三条经验值得记：第一，间隔不要低于 1 秒，太快容易丢消息；第二，单条失败要捕获异常并继续，不要让整个队列卡死；第三，把发送记录写进日志文件，出了问题能回溯是哪一条、什么时间发的。

8. 资源占用与性能观察

这个方案对系统资源的消耗几乎可以忽略。Python 脚本本身只占几十 MB 内存，CPU 在发送间隙基本是空闲的，真正占资源的是 VRChat 本体。所以不需要为脚本单独做性能优化，重点观察的是游戏侧的表现。

观察显存和内存，用任务管理器就够了。切到“性能”页看 GPU 的专用显存占用，切到“详细信息”页看 VRChat.exe 的内存和 GPU 占用。如果你同时开了录制软件或者浏览器，把这些进程的占用一起看，避免误判成 VRChat 的问题。

如果发现发送后掉帧，优先怀疑两件事：一是发送频率太高，UDP 包短时间堆积；二是脚本里写了同步网络请求，阻塞了主循环。前者把间隔调大，后者改成异步或者放到独立线程。

降低资源占用的几个做法：脚本跑完就关掉，不要长期挂在后台；批量发送时把间隔设成 2 秒以上；日志写入用追加模式，不要每次重写整个文件；如果不需要 HTTP 接口，直接用命令行脚本，少一层 Flask 的开销。

端口和进程残留也要留意。调试过程中如果反复启停服务，可能出现端口还没释放的情况，表现为下一次启动报“地址已被占用”。这时候用前面的netstat命令确认是哪个进程占着，结束掉再启动。养成习惯：每次改端口，VRChat 的启动参数和脚本里的端口要同步改，只改一边等于没改。

9. 常见问题与排查方法

下面这张表覆盖了实际使用中最容易遇到的几类问题，排查顺序建议从下往上：先看现象，再看原因，最后执行解决方案。

除了表里的问题，还有两个容易被忽略的点。第一，VRChat 更新后 OSC 的行为可能有细微变化，如果之前能用突然不能用了，先去看官方文档有没有调整参数格式。第二，某些世界对头顶气泡的显示做了限制，你在 A 世界能看到，在 B 世界看不到，这属于世界本身的设置，不是你脚本的问题，换世界验证一下就能判断。

10. 最佳实践与使用建议

第一条建议是先把最小可运行路径跑通，再谈扩展。最小路径就是：VRChat 开着、OSC 开着、脚本发一条短中文、头顶能看到。这四步通了，后面加接口、加批量、加话术库都是在这个基础上叠加。很多人一上来就写复杂工具，结果卡在端口没对上，浪费大量时间。

第二条是配置和内容分目录管理。脚本放一个目录，话术文本放data/，日志放logs/，配置文件单独一个 JSON，改参数不用动代码：

{ "osc_host": "127.0.0.1", "osc_port": 9000, "max_chars": 144, "interval_seconds": 1.2, "notify": true }

第三条是接口服务一定要限制访问范围。默认只监听127.0.0.1，需要手机访问再考虑局域网，并且加上简单的 token 校验。不要直接把端口映射到公网，也不要把服务放在没有密码保护的机器上。

第四条是公共场合克制使用。头顶气泡是给附近玩家看的，不是公告板。测试去单人世界或者好友房间，公共世界里控制频率，内容保持干净，不发广告、不发引流、不发任何可能引起争议的内容。

第五条是涉及他人素材时先确认授权。如果你打算把录音、语音、形象相关的内容也接进这套流程，必须先拿到当事人许可，并且明确使用范围。本地调试用的素材自己录、自己用，不要随手抓网上的资源。

第六条是版本变化要有心理准备。OSC 是官方能力，相对稳定，但参数细节和字符上限这类东西，官方随时可能调整。写脚本时把上限、端口、间隔都做成配置项，出问题改配置而不是改代码。

最后说下一步可以做什么。如果你已经把中文打通，可以继续往下走：把常用话术做成图形界面，用 Tkinter 或者 Web 页面都行；把发送记录做成日志面板，方便回看；把 HTTP 接口接到直播工具上，让弹幕触发特定文本；或者把脚本打包成 exe，双击就能用，不用每次开命令行。

回到最初的问题：VRChat 里能不能顺畅输入中文？答案是能，但要选对路径。临时沟通用剪贴板，VR 里用桌面视图加系统输入法，想长期用、想自动化，就用 OSC 把中文直接写进 Chatbox。三条路都不需要改客户端，都在官方允许的范围内，风险可控。最容易踩的坑不是代码写错，而是端口没对上、字符超限、发送太急这三件事，把这三条守住，剩下的就是调参数。建议把第 6 节的脚本存一份，后面遇到版本更新或者换机器，直接拿出来改端口就能用。